Geocoding API v4 の概要

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

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

Geocoding API でできること

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

Geocoding API v4 のこのリリースには、次のエンドポイントのリリースが含まれています。

結果の表示場所を制御し、結果を特定の地域、郡、郵便番号に限定できます。

デモを試す

Geocoding API の仕組み

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

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

次の表に、Geocoding API で使用できるリソースと、各メソッドが返すデータをまとめます。

データリソース 返されるデータ 戻り値の形式
ジオコーディング 住所、住所コンポーネント、住所タイプを返します。ジオコード レスポンスのドキュメントをご覧ください。
  • JSON
リバース ジオコーディング 住所、住所コンポーネント、住所タイプを返します。リバース ジオコーディング レスポンスの ドキュメントをご覧ください。
プレイス ジオコーディング 住所、住所コンポーネント、住所タイプを返します。プレイス ジオコーディング レスポンスのドキュメントをご覧ください。
目的地検索 住所、プレイス ID、緯度と経度の座標など、さまざまな入力条件に基づいて、さまざまな目的地に関する詳細情報を返します。 目的地検索のドキュメントをご覧ください。

Geocoding API v4 の機能

Geocoding API のバージョン 4 では、次の新機能が提供されています。

目的地検索メソッド

v4 では、目的地検索 メソッドが導入されており、住所、プレイス ID、緯度と経度の座標など、さまざまな 入力条件に基づいて、さまざまな目的地に関する詳細情報を 取得できます。レスポンスには、AI を活用した 要約とナビゲーション ポイント トークンが含まれます。このトークンには、正確なルート案内を行うためにNavigation SDKに渡すことができるコンテキスト情報が含まれています。

SearchDestinations

Google 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 を呼び出すことを強くおすすめします。安全な実装パターンとクライアントサイドのニーズに対応する代替方法の詳細については、セキュリティに関する考慮事項をご覧ください。