標高・水深情報検索

API名: 
elevation
概要: 

リクエストパラメータで指定される緯度経度で指定した地点の標高, 水深情報を取得します。
標高データは 国土地理院提供 基盤情報地図、
水深データは日本海洋データセンター(海上保安庁)提供 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		 メッシュタイプの指定
検索するメッシュタイプを指定します。
N05m 5mメッシュの標高データ
N10m 10mメッシュの標高データ
D50m 500mメッシュの水深 データ

メッシュタイプは複数指定することができます。
複数指定した場合は、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]