標高検索API
陸地と海底をカバーする全球15秒角のグリッド(約460m)から、陸上の任意の地点の平均海面からの高さをメートル単位で返します。1地点を送ることも、断面図やルート用に1回の呼び出しで最大100地点を送ることもできます。
GEThttps://api.mygeocode.com/v1/elevation?lat=...&lon=...
例
リクエスト
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/elevation?lat=27.9881&lon=86.9250"
# Several points, separated by |
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/elevation?locations=46.5763,7.6613|46.5484,7.9819|46.5588,8.0056"値は全球15秒角グリッドの最寄りのセルから取得されるため、特定地点の標高ではなく周囲の地形の高さが得られます。ルートの断面図、集水域の分析、電波の経路、妥当性チェックには適していますが、1つの建物や細い尾根には粗すぎます。なだらかな地形では数メートル、険しい山岳地帯ではそれ以上の誤差を想定してください。海上では、値は海底の深さを負の数で表します。
レスポンス
{
"status": "ok",
"results": [
{
"lat": 27.9881,
"lon": 86.925,
"elevation_m": 8627.0,
"resolution_m": 463.8
}
]
}返される内容
| フィールド | 意味 |
|---|---|
results | 地点ごとに1エントリー、送信した順に返されます。 |
elevation_m | 平均海面からの高さ(メートル、小数点以下1桁)。海面より低い場所(デスバレー、死海の湖岸)では負の値。外洋ではnull。 |
resolution_m | データセットのグリッド間隔(メートル): 463.8(15秒角)。 |
利用シーン
ルートの断面図
ハイキングやサイクリングのルートの地点を100件ずつまとめて送り、標高の断面図、累積標高、最大勾配を描画できます。
用地の評価
洪水リスクの調査、太陽光パネルの計画、電波の見通し。ジオコーディングと組み合わせれば、2回の呼び出しで住所から高さを求められます。
GPS高度の補正
一般向けGPSの高度は、数十メートルずれていることがよくあります。地上にあるものについては、地形の検索結果に置き換えてください。
料金と制限
各地点が1リクエストとして数えられるため、100地点を含む呼び出しは100件として数えられます。すべてのキーに1日あたり2,500件の無料リクエストがあり、それを超えるとプリペイドクレジットから1件あたり€0.0001、Unlimitedキー(月額€50)なら無料です。料金。Google Elevation API、Bing Elevations、Open-Elevationの形式は互換ホストとして利用できます。