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、緯度と経度の座標などのさまざまな入力条件に基づいて、さまざまな目的地に関する詳細情報を取得できる目的地検索エンドポイントが導入されています。レスポンスには、正確なルート設定のために Navigation SDK に渡すことができるコンテキスト情報を含む AI を活用した要約とナビゲーション ポイント トークンが含まれます。

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 リクエストでフィールド マスクを指定する必要があります。

プレビュー期間中の使用は無料

Geocoding API v4 は一般提供前のプレビュー段階であり、プレビュー期間中の API 使用料は無料です。API 呼び出しは Cloud Console の [お支払い] ページに表示されますが、料金は $0 になります。

フィードバック

これはプレビュー機能です。フィードバックは geocoding-feedback-channel@google.com までお寄せください。