Geocoding API は、住所、緯度と経度の座標、またはプレイス ID で場所を受け付けるサービスです。住所を緯度と経度の座標とプレイス ID に変換したり、緯度と経度の座標やプレイス ID を住所に変換したりします。
Geocoding API を使用する理由
ウェブサイトまたはモバイルアプリ用の Geocoding API は、いずれかの Google Maps Platform API で提供される地図内でジオコーディング データを使用する場合に使用します。Geocoding API では、住所を使用して地図上のマーカーを配置するか、地図上のマーカーを住所に変換します。このサービスは、事前定義された静的な住所をジオコーディングして、アプリケーション コンテンツを地図上に配置するために設計されています。
Geocoding API でできること
Geocoding API を使って、次のような住所や場所のジオコーディング データを取得できます。
- 住所の地理座標。
- 緯度と経度の座標のセットに対する住所。
- 場所 ID の住所。
結果を表示する場所を制御し、特定の地域、郡、郵便番号に制限できます。
Geocoding API の仕組み
Geocoding API は、ジオコーディングとリバース ジオコーディングの両方を行います。
- ジオコーディング: 「1600 Amphitheatre Parkway, Mountain View, CA」などの住所を、緯度と経度の座標やプレイス ID に変換します。これらの座標を使用すると、地図にマーカーを配置したり、ビューフレーム内で地図を中央に配置または再配置したりできます。
- リバース ジオコーディング: 緯度と経度の座標、またはプレイス ID を人が読める住所に変換します。住所は、配達や集荷など、さまざまなシナリオに使用できます。
次のデモでは、Geocoding API の仕組みを、Maps JavaScript 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 プロジェクトの設定をご覧ください。
- リクエストとレスポンスの例: ジオコーディングのリクエストとレスポンスをご覧ください。
- おすすめの方法に従う: 住所のジオコーディングに関するベスト プラクティスをご覧ください。