Geocoding API 提供 AI 生成的摘要,帮助用户了解目的地。这些摘要在
Destination
对象中提供,位于arrivalSummary字段。
这些摘要是简短、易于浏览的文本片段,大约 120 个字符或 24 个字或更少,概括了目的地的独特属性,可在用户规划行程和到达目的地时提供帮助。
例如:
- Domino's Pizza 后方 ⋅ 中层公寓楼,有白色和砖红色条纹 ⋅ 入口位于黑色金属门后方
- “高高的奶油色公寓楼,带阳台 ⋅ 入口位于车道上方的大型拱形桥下,设有保安亭”
抵达摘要由 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 字段包含一个 ArrivalSummary 对象,其中包含以下字段:text、flag_content_url 和 disclosure_text。
响应采用以下形式:
{ "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 赋能的摘要时,您必须向用户提供此链接,以便用户报告摘要方面的问题。
如需了解详情,请参阅地理编码 API政策。
目的地覆盖范围
AI 赋能的摘要仅适用于以下大都市区的住宅目的地:
美国
- 亚特兰大
- 波士顿
- 芝加哥
- 达拉斯-沃思堡
- 休斯敦
- 拉斯维加斯
- 洛杉矶
- 迈阿密
- 纽约
- 费城
- 圣迭戈
- 旧金山
- 西雅图
- 华盛顿特区
印度
- 班加罗尔
- 钦奈
- 德里(新德里)
- 海德拉巴
- 加尔各答
- 孟买
反馈
这是 Geocoding API 的一项实验性功能。欢迎通过 geocoding-feedback-channel@google.com提供反馈。