Geocoding API の概要

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

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

Geocoding API を使用する理由

Google Maps Platform API のいずれかによって提供される地図内でジオコーディング データを使用する場合は、ウェブサイトまたはモバイル アプリケーションで Geocoding API を使用します。Geocoding API を使用すると、住所を使用して地図上にマーカーを配置したり、地図上のマーカーを住所に変換したりできます。このサービスは、地図上にアプリケーション コンテンツを配置するために、事前定義された静的住所をジオコーディングするように設計されています。

Geocoding API でできること

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

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

検索結果の表示場所を制御し、特定の地域、都道府県、郵便番号に結果を制限できます。

Geocoding API の仕組み

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

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

次のデモでは、Maps JavaScript API を介してジオコーディング サービスを使用して、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 には、インストール手順とサンプルコードも用意されています。

次のステップ