Geocoding API は、ユーザーが目的地を理解するのに役立つ AI 生成の概要を提供します。これらの要約は、arrivalSummary フィールドの Destination オブジェクトで提供されます。
これらの概要は、目的地に関する特徴的な属性を要約した、約 120 文字または 24 語以下の短いテキスト スニペットで、ユーザーが旅行の計画や到着時に役立つように作られています。
次に例を示します。
- ドミノ・ピザの裏手 ⋅ 白とレンガ色のストライプの中層アパート ⋅ 入り口は黒い金属製の門の奥
- バルコニー付きのクリーム色の高層アパート・マンション ⋅ 玄関は車道にかかる大きなアーチ橋の下にあり、警備ブースがある
到着の概要は AI によって生成されます。ただし、これらの要約は試験運用中のため、不正確な情報が含まれることがあります。ユーザーは、AI を活用した要約を情報源として利用すべきではありません。
到着の概要をリクエストする
レスポンスで到着の概要を返すには、目的地を検索リクエストの X-Goog-FieldMask ヘッダーに destinations.arrivalSummary を含めます。
curl -X POST -d '{ "place": "places/ChIJAWLGeHRZwokRV4Dojw9TEHA" }' \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: destinations.arrivalSummary" \ https://geocode.googleapis.com/v4alpha/geocode/destinations
arrival_summary フィールドには、text、flag_content_url、disclosure_text の各フィールドを含む ArrivalSummary オブジェクトが含まれています。
レスポンスの形式は次のとおりです。
{ "destinations": [ { "arrivalSummary": { "text": { "text": "Tall red-brick apartment building ⋅ Entrance has a glass front and a grey metal overhang", "languageCode": "en" }, "flagContentUrl": "https://www.google.com/local/review/rap/report?postId=...", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } } ] }
AI による要約を表示する
アプリで AI による概要を表示する場合は、必要な開示テキストと、概要に関する問題を報告するためのリンクを含める必要があります。
開示テキスト
text フィールドの AI による要約を表示する場合は、レスポンスの ArrivalSummary オブジェクトの disclosure_text フィールドで提供されるローカライズされた開示テキストを、要約のすぐ下に含める必要があります。API から提供された開示テキストを変更または拡張しないでください。
問題を報告する
各概要には flag_content_url が含まれており、ユーザーが概要コンテンツに関する問題を報告するためのリンクが提供されます。AI による要約を表示する場合は、ユーザーが要約に関する問題を報告できるように、このリンクを利用可能にする必要があります。
詳細については、Geocoding API のポリシーをご覧ください。
リンク先のカバレッジ
AI を活用した概要は、次の大都市圏の住宅地でのみ利用できます。
米国
- アトランタ
- ボストン
- シカゴ
- ダラス フォートワース
- ヒューストン
- ラスベガス
- ロサンゼルス
- マイアミ
- ニューヨーク
- Philadelphia
- San Diego
- サンフランシスコ
- シアトル
- ワシントン D.C.
インド
- バンガロール（ベンガルール）
- チェンナイ
- デリー（ニューデリー）
- ハイデラーバード
- コルカタ
- ムンバイ
フィードバック
これは Geocoding API の試験運用版の機能です。フィードバックは geocoding-feedback-channel@google.com までお寄せください。