Geocoding API は、場所を住所、緯度と経度の座標、またはプレイス ID として受け入れるサービスです。住所を緯度と経度の座標やプレイス ID に変換したり、緯度と経度の座標やプレイス ID を住所に変換したりできます。
Geocoding API でできること
Geocoding API を使用すると、1 つ以上の住所または場所のジオコーディング データを取得できます。たとえば、次のようなデータを取得できます。
Geocoding API v4 の今回のリリースには、次のエンドポイントのリリースが含まれています。
- 住所のジオコーディング - 住所の地理座標。順方向ジオコーディングとも呼ばれます。
- 場所のジオコーディング - 緯度と経度の座標のセットの住所。リバース ジオコーディングとも呼ばれます。
- プレイス ジオコーディング - プレイス ID から住所を取得します。
- 目的地の検索 - 住所、プレイス ID、または場所から目的地を検索します。
結果の表示場所を制御し、結果を特定の地域、郡、郵便番号に絞り込むことができます。
デモを試す
Geocoding API の仕組み
Geocoding API は、ジオコーディングとリバース ジオコーディングの両方を行います。
- ジオコーディング: 住所（例: 「1600 Amphitheatre Parkway, Mountain View, CA」）を緯度と 経度の座標またはプレイス ID に変換します。これらの座標を使用して、地図上にマーカーを配置したり、ビューフレーム内で地図を中央に配置したり、位置を変更したりできます。
- リバース ジオコーディング: 緯度と経度の座標またはプレイス ID を 人間が読める住所に変換します。住所は、配達や集荷など、さまざまなシナリオで使用できます。
次の表に、Geocoding API で使用できるリソースと、各メソッドが返すデータをまとめます。
| データリソース | 返されるデータ | 戻り値の形式 |
|---|---|---|
| ジオコーディング | 住所、住所コンポーネント、住所タイプを返します。ジオコード レスポンスのドキュメントをご覧ください。 |
|
| リバース ジオコーディング | 住所、住所コンポーネント、住所タイプを返します。リバース ジオコーディング レスポンスの ドキュメントをご覧ください。 | |
| プレイス ジオコーディング | 住所、住所コンポーネント、住所タイプを返します。プレイス ジオコーディング レスポンスのドキュメントをご覧ください。 | |
| 目的地の検索 | 住所、プレイス ID、緯度と経度の座標など、さまざまな入力条件に基づいて、さまざまな目的地に関する詳細情報を返します。目的地の検索のドキュメントをご覧ください。 |
リリース ステージのチャンネル
Geocoding API バージョン 4 には、GA、プレビュー、試験運用版の機能ごとに個別のチャンネルがあります。プレビュー版または試験運用版の機能を使用する場合は、リクエストで正しいチャンネルを指定してください。たとえば、試験運用版の Destinations エンドポイントの機能にアクセスするには、https://geocode.googleapis.com/v4alpha/geocode/destinations という HTTP リクエストを使用します。
| リリース ステージ | チャンネル名 |
|---|---|
| GA | /v4/ |
| プレビュー | /v4beta/ |
| 試験運用版 | /v4alpha/ |
- 利用可能なすべての REST リソースの一覧と説明については、REST リファレンスをご覧ください。
- 各 ステージの詳細については、リリース ステージをご覧ください。
Geocoding API v4 の機能
Geocoding API バージョン 4 には、次の新機能が用意されています。
目的地の検索方法
v4 では、目的地の検索 方法が導入されました。この方法を使用すると、住所、プレイス ID、緯度と経度の座標など、さまざまな 入力条件に基づいて、さまざまな目的地に関する詳細情報を 取得できます。レスポンスには、AI を活用した 要約とナビゲーション ポイント トークンが含まれます。このトークンには、 Navigation SDKに渡して正確なルート設定を行うことができるコンテキスト情報が含まれています。
SearchDestinationsGoogle Cloud 標準プラットフォームに実装
Geocoding API v4 は、サービス インフラストラクチャ Google Cloud に実装されています。この実装により、OAuth などの強化されたセキュリティ オプションを備えた、安全で信頼性の高い プラットフォームが実現します。この標準 API 設計は、API 全体にある程度の一貫性をもたらし、Geocoding API v4 での開発効率を向上させます。
OAuth のサポートを追加
Geocoding API v4 では、認証に OAuth 2.0 を使用できます。Google は、ウェブサーバーなど、OAuth 2.0 の一般的なシナリオに対応しています。
フィールド マスクのサポートを追加
フィールド マスクを使用して、レスポンスで返す 情報を指定します。住所のジオコーディング、場所のジオコーディング、プレイス ジオコーディングの各メソッドでは、レスポンス オブジェクトのすべてのフィールドがデフォルトで返されます。目的地の 検索メソッドでは、 API リクエストでフィールド マスクを指定する必要があります。
API セキュリティ
Geocoding API v4 は、サーバー間 API として設計されています。ブラウザからクライアントサイドで直接呼び出すと、HTTP リファラー制限ではウェブサービス エンドポイントを十分に保護できないため、API キーが盗難や不正使用のリスクにさらされます。
独自のバックエンド サーバーから Geocoding API v4 を呼び出すことを強くおすすめします。安全な実装パターンとクライアントサイドのニーズに対応する代替方法の詳細については、セキュリティに関する考慮事項をご覧ください。