AI 赋能的区域摘要

AI 赋能的区域摘要是针对地点周围的区域生成的。区域摘要可提供有关某个地点的更多背景信息，包括附近的地图注点，以便用户更明智地决定去哪里以及到达后做什么。

例如，在造访新城市时，您可以查看为酒店生成的街区摘要，详细了解周边区域：

  • “这个充满活力的区域位于旧金山，融合了北滩和唐人街，坐落在金融区西北部，拥有文学地标、独特的文化景点和各式餐厅。著名景点包括标志性的城市之光书店、引人入胜的缆车博物馆和热闹非凡的唐人街。

    该地区将历史与文化完美融合，虽然有一些山丘和拥挤的人群，但步行友好的环境非常适合探索。您可以沉浸在城市之光书店的文学历史中，体验唐人街充满活力的文化，那里有寺庙和幸运饼干工厂，或者在缆车博物馆中穿越时空。从地道的中餐到美味的披萨，各种美食应有尽有。”

如果您考虑为电动汽车充电，可以查看为电动车辆充电站生成的摘要，以便在等待期间找到附近的咖啡馆或餐厅：

  • “该区域步行 9 分钟内即可到达各种餐饮场所，包括星巴克、Sushi Jin 和 Safeway。”

除了对该区域的描述之外，回答还包含描述中提及的地点的地点 ID 列表。

Places API（新版）提供两种类型的 AI 赋能区域摘要：

  • 周边摘要：提供附近景点的简要概览，适用于类型为 premise、street_address 以及住房和住宿类别中所有类型的地点。
  • 电动车辆充电站 (EVCS) 设施摘要，可简要概述类型为 electric_vehicle_charging_station 的地点附近的景点。

地点详情（新版）、文本搜索（新版）和附近搜索（新版）支持 AI 赋能的区域摘要。

区域摘要功能支持以下语言和地区的地图注点：

语言 区域
英语 美国

请求社区摘要

可以为类型为 premise、street_address 以及住房和住宿类别中所有类型的地点生成周边区域摘要。如需在响应中返回周边区域摘要，请在请求的字段掩码中添加以下内容：

  • 地点详情（新版）： neighborhoodSummary
  • 文本搜索（新版）和附近搜索（新版）： places.neighborhoodSummary

响应中地点的 neighborhoodSummary 字段包含以下内容：

  • 两个子字段：overview 和 description。overview 子字段包含特定于该地点的附近地图注点，而 description 子字段则提供有关周边区域的更一般信息。每个子字段都包含一个采用 place/PLACE_ID 格式的被引用地点资源名称列表。
  • flagContentUri 链接，用户可以通过该链接举报生成的摘要存在的问题。
  • 本地化文本字符串，其中包含必须纳入到提供方说明中的披露文本“使用 Gemini 总结”。

以下示例请求获取纽约市某家酒店的周边环境摘要：

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,neighborhoodSummary" \
'https://places.googleapis.com/v1/places/ChIJT0DdRo1ZwokRkufwSD-TdGM'

响应采用以下形式：

{
  "id": "ChIJT0DdRo1ZwokRkufwSD-TdGM",
  "displayName": {
    "text": "Courtyard New York Manhattan/SoHo",
    "languageCode": "en"
  }
  "neighborhoodSummary": {
    "overview": {
      "content": {
        "text": "This area resides within SoHo, a trendy Lower Manhattan neighborhood celebrated for its upscale boutiques, designer shops, and thriving art scene. The area is home to the Color Factory and Dominique Ansel Bakery, known for its popular Cronuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "description": {
      "content": {
        "text": "SoHo's walkability and convenient public transportation options make exploration easy. A diverse array of restaurants and cafes cater to varied tastes. SoHo's central location, surrounded by vibrant neighborhoods, contributes to its fast-paced and energetic atmosphere, with a focus on fashion and design.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=&d=17924085&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

请求 EVCS 设施摘要

可以为类型为 electric_vehicle_charging_station 的地点生成电动车辆充电站 (EVCS) 设施摘要。如需在响应中包含 EVCS 设施摘要，请在请求的字段掩码中添加以下内容：

  • 地点详情（新版）： evChargeAmenitySummary
  • 文本搜索（新版）和附近搜索（新版）： places.evChargeAmenitySummary

响应中地点的 evChargeAmenitySummary 字段包含以下内容：

  • 四个子字段：overview、coffee、restaurant 和 store。每个子字段都包含对附近地图注点的简要说明，以及格式为 place/PLACE_ID 的引用地点资源名称列表。
  • 一个 flagContentUri 链接，用户可以通过该链接标记生成的摘要存在的问题。
  • 本地化文本字符串，其中包含必须纳入到提供方说明中的披露文本“由 Gemini 总结”。

以下示例请求获取山景城某充电站的电动车辆充电站设施摘要：

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,evChargeAmenitySummary" \
'https://places.googleapis.com/v1/places/ChIJtwHgNNa2j4ARlC8vbI9lLZA'

响应采用以下形式：

{
  "id": "ChIJf8j-4z23j4AR_MQ2-bgMmrY",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "evChargeAmenitySummary": {
    "overview": {
      "content": {
        "text": "Within a short walk, there are several coffee and restaurant options, including Clocktower Coffee Roasting Company, Khao Kang Thai Kitchen, and Roger's Deli & Donuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q",
        /.../
      ]
    },
    "coffee": {
      "content": {
        "text": "Clocktower Coffee Roasting Company has Wi-Fi and a variety of coffee and pastries in a laid-back atmosphere.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q"
      ]
    },
    "restaurant": {
      "content": {
        "text": "Roger's Deli & Donuts is a bustling deli with sandwiches and breakfast items.\nJoy Sushi serves classic Japanese dishes, including vegetarian and healthy options.\nSubway is a chain sandwich shop offering its usual subs, wraps, and salads.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJQ4F3PBa3j4ARf7_QjN1Cklo",
        /.../
      ]
    },
    "store": {
      "content": {
        "text": "Rotten Robbie is a chain gas station with a convenience store and a restroom.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJA6deFBa3j4AREY0EyTEGhN8",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ABCDEFG=1234567&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

归因

应用中显示的所有 AI 赋能的摘要都必须根据 Google 的政策和标准附带适当的署名。如需了解详情，请参阅 Places API 政策。