スタートガイド

Elevation API は、地表のさまざまな地点の高度データを提供します（海底のような深い場所にも対応しており、その場合は高度が負の値になります）。

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

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

次の例では、「コロラド州デンバー」の「マイルハイハイ」の JSON 形式の高度をリクエストしています。

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

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 と使用可能なパラメータおよび レスポンスの理解について詳しくは、デベロッパー ガイドをご覧ください。

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

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

<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 Client、Python Client、Go Client、Node.js Client で使用できます。

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

認証

Elevation API を使用するには、まず API を有効にして適切な認証情報を取得する必要があります。詳しくは、Google Maps Platform スタートガイドをご確認ください。

割り当てと料金

Elevation API の割り当てと料金の詳細については、使用量と請求額のページをご覧ください。

ポリシー

Elevation API を使用する場合は、API ポリシーに従う必要があります。

詳細

Elevation API には、複数の地点から高度データをリクエストする機能など、さまざまな機能があります。その他の例と詳細については、 Elevation API デベロッパー ガイドをご覧ください。

Elevation API デベロッパー ガイドは、Google Maps Platform API で提供される地図内で高度データを使用するウェブサイトやモバイル デベロッパーを対象としています。このドキュメントは、API の使用に関する概要と、使用できるパラメータに関する参考資料を提供します。