標高・水深情報検索
API名:
概要:
リクエストパラメータで指定される緯度経度で指定した地点の標高, 水深情報を取得します。
標高データは 国土地理院提供 基盤情報地図、
水深データは日本海洋データセンター(海上保安庁)提供 500mメッシュ水深データ(https://www.jodc.go.jp/jodcweb/JDOSS/index_j.html)
を加工して作成しています。
URI:
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/elevation
<API使用例>
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/elevation?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&meshtype=N05m&latlon=35.2414902,139.1315686
リクエストパラメータ
パラメータ | 必須 | デフォルト値 | 説明 | ||||||
---|---|---|---|---|---|---|---|---|---|
latlon | ○ | - |
緯度経度の指定 複数点指定することができます。上限は300点です。 本項目は必須項目であるため、未指定の場合はエラーとなります。 |
||||||
meshtype |
N05m, N10m, D50m |
メッシュタイプの指定 検索するメッシュタイプを指定します。
メッシュタイプは複数指定することができます。 |
|||||||
datum | TOKYO |
測地系 入出力緯度経度の測地系を指定します。 |
|||||||
llunit | dec |
緯度経度形式 緯度経度形式を指定します。 |
出力データ
出力フォーマット
[{"elevation":38.5,
"meshType":"N05m"}]
キー名 | データ型 | 説明 |
---|---|---|
elevation | number |
標高値(単位:m)が入ります。 水深部はマイナスの値が返却されます。 |
meshType | string |
検索に該当したメッシュタイプが返却されます。 返却値は入力パラメータ meshtype を参照ください。 |
出力例
[5mメッシュの標高データがあり、10mメッシュの標高データ、500mメッシュの水深データがない場合の例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/elevation?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
meshtype=N05m&latlon=35.2414902,139.1315686,35.3908997,138.7350769,35.604803056,142.546354444
[{"elevation":38.5,
"meshType":"N05m"},
null,
null]
[5mメッシュ、10mメッシュの標高データがあり、500mメッシュの水深データがない場合の例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/elevation?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
meshtype=N10m&latlon=35.2414902,139.1315686,35.3908997,138.7350769,35.604803056,142.546354444
[{"elevation":38.8,
"meshType":"N10m"},
{"elevation":2301,
"meshType":"N10m"},
null]
[500mメッシュの水深データがあり、5mメッシュ、10mメッシュの標高データがない場合の例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/elevation?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
meshtype=D50m&latlon=35.2414902,139.1315686,35.3908997,138.7350769,35.604803056,142.546354444
[null,
null,
{"elevation":-6915.9,
"meshType":"D50m"}]
[通常出力例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/elevation?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
meshtype=N05m,N10m,D50m&latlon=35.2414902,139.1315686,35.3908997,138.7350769,35.604803056,142.546354444
[{"elevation":38.5,
"meshType":"N05m"},
{"elevation":2301,
"meshType":"N10m"},
{"elevation":-6915.9,
"meshType":"D50m"}]
[標高データがない場合の例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/elevation?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=0,0
[null]