スタートガイド

Elevation API は、地表のすべての地点の高度データを提供します。海底の深度も含みます(負の値を返します)。

このサービスは、クライアントサイドの Maps JavaScript API の一部として、または Google マップ サービス用の Java クライアント、Python クライアント、Go クライアント、Node.js クライアントとともにサーバーサイドで利用することもできます。

リクエストとレスポンスの例

Elevation API には、HTTP インターフェースを介してアクセスします。リクエストは URL 文字列として構成され、緯度/経度の座標を使用して場所またはパスの頂点を識別します。API キーを含める必要があります。

次の例では、「Mile High City」であるコロラド州デンバーの高度を JSON 形式でリクエストしています。

URL

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'

これをテストするには、この URL をウェブブラウザに入力します(YOUR_API_KEY実際の API キーに置き換えてください)。レスポンスには、その地点の高度(メートル単位)と解像度値(高度が補間されたデータポイント間の最大距離(メートル単位))が含まれます。

リクエスト URL と使用可能なパラメータの作成 レスポンスの理解について詳しくは、デベロッパー ガイドをご覧ください。

レスポンスの例を次に示します。

JSON

{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
    ],
  "status": "OK",
}

XML

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
</ElevationResponse>

クライアント ライブラリを使用してコーディングを開始する

クライアント ライブラリを使用すると、認証、リクエスト スロットリング、自動再試行などの一般的なタスクのシンプルなネイティブな実装が可能になるため、Google Maps ウェブサービス API を使った開発が簡単になります。Elevation API は、Google マップ サービス用の Java クライアント、Python クライアント、Go クライアント、Node.js クライアントで利用できます。

認証、割り当て、料金、ポリシー

認証

Elevation API を使用するには、まず API を有効にして、適切な認証情報を取得する必要があります。詳しくは、Google Maps Platform を使ってみるをご覧ください。

割り当てと料金

Elevation API に設定された割り当てと料金の詳細については、使用量と課金のページをご覧ください。

ポリシー

Elevation API は API に関するポリシーに従って使用する必要があります。

詳細

Elevation API では、複数の場所の高度データをリクエストするなど、さらに多くのことができます。その他の例と詳細については、 Elevation API デベロッパー ガイドをご覧ください。

Elevation API デベロッパー ガイドは、Google Maps Platform API によって提供される地図の高度データを利用するウェブサイトおよびモバイルのデベロッパーを対象としています。ここでは、API の使用方法の概要と、使用可能なパラメータに関する参考資料について説明します。