提供 AI 赋能的摘要

欧洲经济区 (EEA) 开发者

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 对象,其中包含以下字段:textflag_content_urldisclosure_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提供反馈。