使ってみる

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 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 の使用方法と、使用可能なパラメータに関するリファレンス資料を紹介します。