Geocoding API は、住所、緯度と経度の座標、またはプレイス ID として場所を受け入れるサービスです。住所を緯度と経度の座標とプレイス ID に変換したり、緯度と経度の座標またはプレイス ID を住所に変換したりします。
Geocoding API を使用する理由
Google Maps Platform API の 1 つによって提供される地図内でジオコーディング データを使用する場合は、ウェブサイトまたはモバイルアプリ用の Geocoding API を使用します。Geocoding API では、住所を使用して地図上にマーカーを配置したり、地図上のマーカーを住所に変換したりできます。このサービスは、事前定義された静的住所をジオコーディングしてアプリケーション コンテンツを地図上に配置するように設計されています。
Geocoding API でできること
Geocoding API を使用すると、以下のような 1 つ以上の住所や場所のジオコーディング データを取得できます。
- 住所の地理座標。
- 緯度と経度の座標のセットのアドレス。
- プレイス ID の住所。
検索結果を表示する場所を制御し、結果を特定の地域、郡、郵便番号に限定できます。
Geocoding API の仕組み
Geocoding API は、ジオコーディングとリバース ジオコーディングの両方を行います。
- Geocoding: 「1600 Amphitheatre Parkway, Mountain View, CA」のような住所を緯度と経度の座標、またはプレイス ID に変換します。この座標を使用して、地図上にマーカーを配置したり、ビューフレーム内で地図を中央に配置したり、地図の位置を変更したりできます。
- リバース ジオコーディング: 緯度と経度の座標またはプレイス ID を人が読める住所に変換します。配送や集荷など、さまざまなシナリオで住所を使用できます。
以下のデモでは、Maps JavaScript API を通じてジオコーディング サービスを使用し、Geocoding API の仕組みを具体的に示します。別のタブで地図を開いて、その他のオプションや詳細を表示します。
関連情報
次の表は、Geocoding API を通じて利用できるリソースと、各エンドポイントが返すデータをまとめたものです。
データリソース | 返されたデータ | 戻り値の形式 |
---|---|---|
ジオコーディング | 住所、住所コンポーネント、住所タイプを返します。ジオコーディングのリクエストとレスポンスのガイドの結果をご覧ください。 |
|
リバース ジオコーディング | 住所、住所コンポーネント、住所タイプを返します。リバース ジオコーディングのリクエストとレスポンスのガイドのリバース ジオコーディングのレスポンスをご覧ください。 | |
場所のジオコーディング | 住所、住所コンポーネント、住所タイプを返します。場所のジオコーディング リクエストとレスポンスのガイドのリバース ジオコーディングのレスポンスをご覧ください。 |
Geocoding API の使用方法
1 | セットアップする。 | まず Google Cloud プロジェクトをセットアップするに進み、以下の設定手順を完了します。 |
2 | ジオコーディング リクエストを試す | API キーを取得したら、cURL またはブラウザから直接 Geocoding API のテストを開始できます。住所またはコンポーネントのルックアップには、正しいルックアップ パラメータを指定する必要があります。詳しくは、ジオコーディング パラメータをご覧ください。 |
3 | リバース ジオコーディング リクエストを試す | 緯度と経度の座標を API キーとともに指定して、その場所について、人が読める形式の最も近い住所について住所コンポーネントを取得します。 詳しくは、リバース ジオコーディング リクエスト をご覧ください。 |
4 | レスポンスの基本を理解する | Geocoding API のすべてのエンドポイントは、同じデータを JSON または XML で返します。データ、ステータス コード、エラー メッセージの説明については、ジオコーディングのレスポンスをご覧ください。 |
5 | ジオコーディング データを独自のアプリに組み込むことができます。 | ジオコーディング データを使用すると、地図上のマーカーから住所を取得したり、既知の住所に基づいて地図上にマーカーを提供したりできます。 |
利用可能なクライアント ライブラリ
次のいずれかのクライアント ライブラリを使用して、任意の言語でこの API を呼び出します。
- Google マップサービス用の Java クライアント
- Google マップサービス用の Python クライアント
- Google マップ サービス向け Go クライアント
- Google マップサービス用の Node.js クライアント
Google マップ サービス用の Java クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリであり、Apache 2.0 ライセンスの下でオープンソース化されています。GitHub からダウンロードしてください。GitHub には、インストール手順とサンプルコードも掲載されています。
次のステップ
- Geocoding API の使用を開始する: Google Cloud プロジェクトを設定するをご覧ください。
- サンプルのリクエストとレスポンスを使ってみる: ジオコーディングのリクエストとレスポンスをご覧ください。
- ベスト プラクティスを実践する: 住所のジオコーディングに関するベスト プラクティスをご覧ください。