地理編碼 API 提供 AI 生成的摘要,協助使用者瞭解目的地。這些摘要會顯示在 arrival_summary 欄位的 Destination 物件中。
這些摘要是簡短的文字片段,約 120 個字元或 24 個字以下,可讓使用者快速瀏覽,瞭解目的地的獨特屬性,有助於規劃行程和抵達目的地。
例如:
- 「Behind Domino's Pizza ⋅ Mid-rise apartment building with white and brick-red stripes ⋅ Entrance is behind a black metal gate」
- 「高聳的米色公寓大樓,設有陽台。入口位於車道上方的大型拱橋下方,並設有警衛室」
抵達摘要是由 AI 生成,不過,這些摘要仍在實驗階段,有時可能會包含不準確的資訊。使用者不應將 AI 生成的摘要做為資訊來源。
要求提供抵達摘要
如要在回應中傳回抵達摘要,請在「搜尋目的地」要求的 X-Goog-FieldMask 標頭中加入 destinations.arrival_summary。
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 輔助摘要時,您必須提供這個連結,供使用者回報摘要問題。
詳情請參閱「地理編碼 API 政策」。
目的地涵蓋範圍
AI 摘要功能僅適用於住宅目的地,且僅限下列都會區:
美國
- 亞特蘭大
- 波士頓
- 芝加哥
- 達拉斯-沃斯堡
- 休士頓
- 拉斯維加斯
- 洛杉磯
- 邁阿密
- 紐約
- 費城
- San Diego
- 舊金山
- 西雅圖
- 華盛頓哥倫比亞特區
印度
- 班加羅爾
- 清奈
- 德里 (新德里)
- 海得拉巴
- 加爾各答
- 孟買