Elevation API の概要

Elevation API は、地球上の地点の高度データ、またはパスに沿ってサンプリングされた高度データを返すサービスです。

Elevation API を使用する理由

Elevation API を使用すると、高度の影響を受けやすいアクティビティ、位置測定アプリケーション、ルートに沿った高度と高度の変化を含む低測位アプリケーションなど、顧客をサポートするアプリを開発できます。たとえば、標高の増減に関するデータを提供して、ハイキング、サイクリング、スキューバ ダイビングなどのアクティビティのスポーツ アプリケーションを強化できます。

Elevation API でできること

Elevation API を使用すると、アプリケーションや地図に高度データを含めることができます。例:

  • 特定の場所の高度を取得します。
  • ルート上または 2 地点間の高度の差を計算します。

Elevation API の仕組み

Elevation API は、緯度と経度の座標が個別の位置またはパス上の一連の位置として指定される、エンコードされた URL としてリクエストを受け入れます。たとえば、このリクエストでは、コロラド州デンバーの中心の高度をクエリし、JSON 形式で戻り値を指定します。
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

サービスは指定された座標の高度を導出します。また、標高のない場所の高度も補間し、標高データを提供する 4 つの最も近い場所から返された平均値を提供します。最後に、ロケーションの全体的な解像度を決定します。

関連情報

次の表は、Elevation API を介して利用できるリソースと返されるデータをまとめたものです。

データリソース 返されたデータ 戻り値の形式
緯度と経度の座標

データは、1 つ以上の場所のセットとして、またはパスに沿ったシリーズとして指定できます。エンコードされた座標を指定することもできます。最大 512 個の座標を渡します。

Elevation API は、ローカル平均海面（LMSL）に対する相対的な高度（メートル単位）を提供します。高度は、次に示すように正または負の値として返すことができます。

  • 正の値は、地表や高地の湖の底など、LMSL より高い位置を示します。
  • 負の値は、地表や海底など、LMSL を下回る場所を示します。
  • [Resolution] は、データポイントから高度までの距離をメートル単位で示します。
  • JSON
  • XML

Elevation API の使用方法

1 セットアップする。 まず Google Cloud プロジェクトをセットアップするに進み、以下の設定手順を完了します。
2 高度リクエストを試す API キーを取得したら、ブラウザから直接 Elevation API のテストを開始できます。詳しくは、スタートガイドのサンプル リクエストをご覧ください。
3 より複雑なリクエストを作成する プロジェクトを設定したら、パスに沿って位置情報を指定するリクエストを試してください。詳しくは、パスの指定をご覧ください。
4 レスポンスの基本を理解する 高度データのレスポンスを調べて、アプリで高度データを使用するための準備をします。詳しくは、高度レスポンスをご覧ください。
5 標高データを独自のアプリに組み込む 高度データを使用すると、スポーツ アクティビティ用のアプリやアンケート データ用のアプリなど、位置情報ベースのアプリを強化できます。

利用可能なクライアント ライブラリ

次のいずれかのクライアント ライブラリを使用して、任意の言語でこの API を呼び出します。

Google マップ サービス用の Java クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリであり、Apache 2.0 ライセンスの下でオープンソース化されています。GitHub からダウンロードしてください。GitHub には、インストール手順とサンプルコードも掲載されています。

次のステップ