使ってみる

Elevation API を使用すると、地球表面上のすべての場所（海底を含む）の高度データを取得できます（海底のような深い場所では、高度が負の値になります）。

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

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

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

次の例では、コロラド州デンバー（「マイルハイシティ」）の高度を 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>
</pre>

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

クライアント ライブラリを使用すると、認証、リクエストのスロットリング、自動再試行などの一般的なタスクの組み込み実装が提供されるため、Google マップ ウェブサービス 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 の使用方法の概要と、使用可能なパラメータに関する参考資料を提供します。