Geocoding API には、ユーザーが目的地を理解するのに役立つ AI 生成の要約が用意されています。これらの要約は、
Destination
オブジェクトの arrival_summary フィールドで提供されます。
これらの要約は、120 文字または 24 語以下の短いテキスト スニペットで、目的地に関する特徴的な属性を要約したものです。旅行の計画や到着時に役立ちます。
次に例を示します。
- 「ドミノ・ピザの裏手 ⋅ 白とレンガ色のストライプが入った中層マンション ⋅ 入り口は黒い金属製の門の奥」
- バルコニー付きのクリーム色のアパート・マンション ⋅ 入り口は車道にかかる大きなアーチ橋の下にあり、警備ブースがある
到着時の要約は AI によって生成されます。ただし、これらの要約は試験運用版であり、不正確な情報が含まれる場合があります。ユーザーは、AI による要約を情報源として使用しないでください。
到着時の要約をリクエストする
レスポンスで到着時の要約を返すには、
destinations.arrival_summaryをX-Goog-FieldMaskヘッダーの目的地の
検索
リクエストに含めます。
arrival_summary フィールドには、ArrivalSummary オブジェクトと次のフィールドが含まれます: text、flag_content_url、disclosure_text。
レスポンスの形式は次のとおりです。
{ "destinations": [ { "arrival_summary": { "text": { "text": "Behind Domino's Pizza ⋅ Mid-rise apartment building with white and brick-red stripes ⋅ Entrance is behind a black metal gate", "languageCode": "en-US" }, "flag_content_url": "https://www.google.com/local/review/rap/report?postId=...", "disclosure_text": { "text": "Summarized with Gemini", "languageCode": "en-US" } } } ] }
AI による要約を表示する
アプリで AI による要約を表示する場合は、必要な開示テキストと、要約に関する問題を報告するためのリンクを含める必要があります。
開示テキスト
text フィールドから AI による要約を表示する場合は、レスポンスの ArrivalSummary オブジェクトの disclosure_text フィールドに記載されているローカライズされた開示テキストを、要約のすぐ下に含める必要があります。API から提供された開示テキストを変更したり、追加したりしないでください。
問題を報告する
各要約には flag_content_url が含まれています。これは、ユーザーが要約の内容に関する問題を報告するためのリンクです。AI
による要約を表示する場合は、ユーザーが要約に関する問題を報告できるように、このリンクを提供する必要があります。
詳細については、Geocoding API のポリシーをご覧ください。
目的地の対象範囲
AI による要約は、次の都市圏の住宅地でのみご利用いただけます。
米国
- アトランタ
- ボストン
- シカゴ
- ダラス フォートワース
- ヒューストン
- ラスベガス
- ロサンゼルス
- マイアミ
- ニューヨーク
- フィラデルフィア
- サンディエゴ
- サンフランシスコ
- シアトル
- ワシントン D.C.
インド
- バンガロール(ベンガルール)
- チェンナイ
- デリー(ニューデリー)
- ハイデラーバード
- コルカタ
- ムンバイ
フィードバック
これは Geocoding API の試験運用版の機能です。フィードバックは geocoding-feedback-channel@google.comまで お寄せください。