その他
地すべり地形分布図タイル配信API
指定したタイル座標における地すべり地形分布図のタイル画像を提供します。本解説では、サービスの使い方について説明します。
バージョン
1.0.0
リクエストURL
https://www.j-shis.bosai.go.jp/map/xyz/landslide/z/x/y.png
目次
リクエスト
– URL
– パラメータ
レスポンス
– ステータスコード
– 正常ケース
– エラーケース
リクエスト
URL
URL中の太字はリクエストパラメータを示し、上付き番号はパラメータ一覧表のNoに対応します。
https://www.j-shis.bosai.go.jp/map/xyz/landslide/z1/x2/y3.png
パラメータ
APIのリクエストパラメータは以下の通りです。
| No | パラメータ | 省略可否 | 説明 |
|---|---|---|---|
| 1 | z | 必須 | タイルのズームレベル。4~18の整数値。 |
| 2 | x | 必須 | 指定したズームレベルにおける、タイルの経度方向の座標。0以上の整数値。 |
| 3 | y | 必須 | 指定したズームレベルにおける、タイルの緯度方向の座標。0以上の整数値。 |
レスポンス
ズームレベルに応じて以下の分布図が表示されます。
| 分布図種類 | 備考 |
|---|---|
| 輪郭構造（滑落崖と側方崖） | ズームレベルが12以上の場合に表示されます。 |
| 輪郭構造（移動体の輪郭・境界）（移動体アーク） | |
| 輪郭構造（移動体の輪郭・境界）（移動体ポリゴン） | |
| 内部構造 | |
| 移動方向等移動体の主移動方向 | |
| 移動体の重心 | ズームレベルが11以下の場合に表示されます。 |
ステータスコード
データを正常に取得した場合は、HTTPステータスコードに200を設定し、正常ケースのレスポンスを返します。エラーが発生した場合は、以下のHTTPステータスコードを設定し、エラーケースのレスポンスを返します。
| HTTPステータスコード | 説明 | |
|---|---|---|
| 400 | Bad Request | リクエストURLに間違いがあることを示します。
例：サポートされていない値を設定した。 |
| 403 | Forbidden | リクエストが拒否されたことを示します。
例：リクエストの上限を超えた。 |
| 500 | Internal Server Error | 内部エラーが発生したことを示します。 |
| 503 | Service Unavailable | サービスが一時的に利用不可であることを示します。 |
正常ケース
レスポンスサンプル
リクエストURL
ズームレベル14の経度方向の座標が3640、緯度方向の座標が1572の地すべり地形分布図タイルを取得する例です。
https://www.j-shis.bosai.go.jp/map/xyz/landslide/12/3640/1572.png
地すべり地形分布図タイルの例
エラーケース
レスポンスサンプル
リクエストURL
不正なタイルの座標を指定した例です。
https://www.j-shis.bosai.go.jp/map/xyz/landslide/12/3640/4096.png
text形式エラーレスポンス
tile y=-1 not in [0,4096[
