Geocoding API は、住所、緯度と経度の座標、またはプレイス ID として場所を受け取るサービスです。住所を緯度と経度の座標やプレイス ID に変換したり、緯度と経度の座標やプレイス ID を住所に変換したりできます。
Geocoding API v4 は、地域密着型の目的地と到着に関するインテリジェンスと、座標から住所へのコア解決の両方を提供します。ラストマイル配送、ライドシェア、ターンバイターン方式ナビのエクスペリエンスを構築する場合でも、番地を座標に正規化する場合でも、v4 にはユースケースに合わせた専用のエンドポイントが用意されています。
アプリケーションに適したエンドポイントがわからない場合は、ジオコーディング方法を選択するをご覧ください。
Geocoding API でできること
Geocoding API v4 には、次の機能とエンドポイントが含まれています。
- 目的地の検索: 住所、プレイス ID、座標から、目的地の局地的な到着の詳細情報を取得します。これには、建物の入口、ルート設定可能なナビゲーション ポイント トークン、建物と敷地の輪郭、サブ目的地、近くのランドマークが含まれます。
- 住所をジオコーディングする: 番地を地理座標とプレイス ID に変換します（フォワード ジオコーディング）。
- 場所をジオコーディングする: 緯度と経度の座標を、人が読める番地または行政区域に変換します（リバース ジオコーディング）。
- 場所をジオコーディングする: 既知の Google マップ プレイス ID のフォーマットされた住所の詳細と座標を取得します。
結果が表示される場所を制御し、結果を特定の地域、郡、郵便番号に制限できます。
デモを試す
Geocoding API の仕組み
Geocoding API v4 は、基本的なジオコーディングに加えて、目的地の検索もサポートしています。
- 目的地検索（
SearchDestinations）: 住所、プレイス ID、または座標ペアを、豊富な情報を含むDestinationオブジェクトに解決します。この方法は、物理的な到着が重要な場合に使用します。たとえば、優先される建物の入り口の特定、ナビゲーション ポイント トークンを使用した指定の乗車場所または降車場所へのドライバーの誘導、地図上での建物のフットプリントのレンダリング、複数の建物からなる複合施設のナビゲーションなどです。 - 基本的なジオコーディング: 住所、座標、プレイス ID を相互に変換します。
- ジオコーディング: 「1600 Amphitheatre Parkway, Mountain View, CA」などの番地を緯度経度座標またはプレイス ID に変換して、地図マーカーを配置したり、地図ビューフレームを中央に配置したりします。
- リバース ジオコーディング: 緯度と経度の座標またはプレイス ID を、ユーザーがドロップした地図ピン、位置情報選択ツール、UI 表示用の人が読める番地に変換します。
- プレイス ジオコーディング: 既知の Google マップ プレイス ID の住所の詳細と座標を取得します。
次の表は、Geocoding API v4 で利用可能なリソースと、各メソッドが返すデータをまとめたものです。
| データリソース | 返されたデータ | 返品形式 |
|---|---|---|
| 目的地を検索する （ POST /v4/geocode/destinations）
|
地域ごとの到着インテリジェンス（建物と敷地のポリゴン（displayPolygon）、物理的な entrances、ルート設定可能な navigationPoints（トークン付き）、階層的な containingPlaces と subDestinations、リレーショナルな landmarks、主要な Place Details）を返します。目的地を検索するをご覧ください。
|
|
| 住所をジオコーディングする （ GET /v4/geocode/address）
|
住所、住所コンポーネント、住所タイプを返します。ジオコーディング レスポンスをご覧ください。 | |
| 場所をジオコーディングする （ GET /v4/geocode/location）
|
住所、住所コンポーネント、住所タイプを返します。リバース ジオコーディングのレスポンスをご覧ください。 | |
| 場所をジオコーディングする （ GET /v4/geocode/places）
|
住所、住所コンポーネント、住所タイプを返します。プレイス ジオコーディング レスポンスをご覧ください。 |
リリース ステージ チャンネル
Geocoding API のバージョン 4 には、GA、プレビュー、試験運用版の機能用の個別のチャネルがあります。プレビュー機能または試験運用版機能を使用する場合は、リクエストで正しいチャネルを指定してください。たとえば、試験運用版の Destinations エンドポイントの機能にアクセスするには、HTTP リクエスト https://geocode.googleapis.com/v4alpha/geocode/destinations を使用します。
| リリース ステージ | チャンネル名 |
|---|---|
| GA | /v4/ |
| プレビュー | /v4beta/ |
| 試験運用版 | /v4alpha/ |
- 使用可能なすべての REST リソースの一覧と説明については、REST リファレンスをご覧ください。
- 各ステージの詳細については、リリース ステージをご覧ください。
Geocoding API v4 の機能
Geocoding API バージョン 4 には、以下の新機能が用意されています。
目的地検索メソッド
v4 では、住所、プレイス ID、緯度経度座標など、さまざまな入力条件に基づいて、さまざまな目的地に関する詳細情報を取得できる目的地検索メソッドが導入されています。レスポンスには、AI を活用した概要と、ナビゲーション ポイント トークンが含まれています。これらのトークンには、正確なルート設定のために Navigation SDK に渡すことができるコンテキスト情報が含まれています。
Google Cloud 標準プラットフォームに実装
Geocoding API v4 は、Google Cloud のサービス インフラストラクチャに実装されています。この実装により、OAuth などの強化されたセキュリティ オプションを備えた、安全で信頼性の高いプラットフォームが実現します。この標準 API 設計は、API 全体にある程度の一貫性をもたらし、Geocoding API v4 での開発効率を向上させます。
OAuth のサポートを追加
Geocoding API v4 は、認証に OAuth 2.0 の使用をサポートしています。Google は、ウェブサーバー上のアプリケーションなど、OAuth 2.0 の一般的なシナリオに対応しています。
フィールド マスクのサポートを追加
フィールド マスクを使用して、レスポンスで返す情報を指定します。住所をジオコーディングする、場所をジオコーディングする、プレイス ジオコーディングの各メソッドでは、レスポンス オブジェクトのすべてのフィールドがデフォルトで返されます。Search for destinations メソッドでは、API リクエストでフィールド マスクを指定する必要があります。
API セキュリティ
Geocoding API v4 は、サーバー間 API として設計されています。ブラウザから直接クライアントサイドの呼び出しを行うと、API キーが盗難や不正使用の重大なリスクにさらされます。HTTP リファラーの制限は、ウェブサービス エンドポイントを十分に保護できないためです。
Geocoding API v4 は、独自のバックエンド サーバーから呼び出すことを強くおすすめします。安全な実装パターンとクライアントサイドのニーズに対応する代替手段の詳細については、セキュリティに関する考慮事項をご覧ください。