Geocoding API の概要

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

Geocoding API を使用する理由

Geocoding API は、ウェブサイトまたはモバイルアプリで Google Maps Platform API の 1 つが提供する地図内でジオコーディング データを使用する場合に使用します。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 には、インストール手順やサンプルコードも用意されています。

次のステップ