Geocoding API の概要

欧州経済領域（EEA）のデベロッパー

Geocoding API は、住所、緯度と経度の座標、プレイス ID として場所を受け入れるサービスです。住所を緯度と経度の座標やプレイス ID に変換したり、緯度と経度の座標やプレイス ID を住所に変換したりします。

Geocoding API でできること

Geocoding API を使用すると、1 つ以上の住所や場所のジオコーディング データを取得できます。たとえば、次のようなデータです。

  • 住所の地理座標。
  • 緯度と経度の座標のセットに対応する住所。
  • プレイス ID の住所。

結果の表示場所を制御し、結果を特定の地域、郡、郵便番号に制限できます。

Geocoding API の仕組み

Geocoding API は、ジオコーディングとリバース ジオコーディングの両方を行います。

  • ジオコーディング: 「1600 Amphitheatre Parkway, Mountain View, CA」などの住所を緯度と経度の座標またはプレイス ID に変換します。これらの座標を使用して、地図上にマーカーを配置したり、ビューフレーム内で地図を中央に配置したり、位置を変更したりできます。
  • リバース ジオコーディング: 緯度と経度の座標またはプレイス ID を人が読める住所に変換します。住所は、配達や受け取りなど、さまざまなシナリオで使用できます。

次のデモでは、Maps JavaScript API を介して Geocoding Service を使用し、Geocoding API の仕組みを示します。地図を別のタブで開くと、その他のオプションと詳細が表示されます。

リソース

次の表に、Geocoding API で利用可能なリソースと、各エンドポイントが返すデータをまとめます。

データ リソース 返されたデータ 戻り値の形式
ジオコーディング 住所、住所コンポーネント、住所タイプを返します。ジオコーディング リクエストとレスポンス ガイドの結果をご覧ください。
  • JSON
  • XML
リバース ジオコーディング 住所、住所コンポーネント、住所タイプを返します。リバース ジオコーディング リクエストとレスポンスのガイドのリバース ジオコーディング レスポンスをご覧ください。
プレイスのジオコーディング 住所、住所コンポーネント、住所タイプを返します。プレイス ジオコーディング リクエストとレスポンスのガイドのリバース ジオコーディング レスポンスをご覧ください。

Geocoding API の使用方法

1 セットアップする。 Google Cloud プロジェクトを設定するから始め、その後の設定手順を完了します。
2 ジオコーディング リクエストを試す API キーを取得したら、curl またはブラウザから Geocoding API のテストを直接開始できます。住所またはコンポーネントのルックアップには、正しいルックアップ パラメータを指定する必要があります。詳しくは、ジオコーディング パラメータをご覧ください。
3 リバース ジオコーディング リクエストを試す 緯度と経度の座標を API キーとともに指定して、その場所の最も近い人が読める形式の住所の住所コンポーネントを取得します。詳しくは、リバース ジオコーディング リクエストをご覧ください。
4 レスポンスの基本を理解する Geocoding API のすべてのエンドポイントは、JSON または XML で同じデータを返します。データ、ステータス コード、エラー メッセージの説明については、ジオコーディング レスポンスをご覧ください。
5 ジオコーディング データを独自のアプリに組み込む ジオコーディング データを使用すると、地図上のマーカーから住所を取得したり、既知の住所に基づいて地図上にマーカーを表示したりできます。

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

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

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

次のステップ