AI 赋能的区域摘要

系统会为某个地点周围的区域生成 AI 赋能的区域摘要。区域摘要可提供某个地点的更多背景信息，包括附近的兴趣点，以便用户在到达目的地后，能够更明智地决定去哪里以及做什么。

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

  • "旧金山的这个活力四射的街区融合了北滩和唐人街的特色，位于金融区的西北部，拥有文学地标、独特的文化景点和各式各样的餐饮场所。值得一去的地方包括标志性的城市之光书店、迷人的缆车博物馆和热闹的唐人街街道。

    该地区历史悠久，文化底蕴深厚，虽然有些山丘和人群，但步行环境良好，非常适合探索。在城市之光书店沉浸于文学历史中，在唐人街体验充满活力的文化（那里有寺庙和幸运饼干工厂），或在缆车博物馆中穿越回过去。从正宗中餐到美味披萨，各种餐饮选择应有尽有。"

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

  • “该区域提供多种餐饮选择，步行 9 分钟即可到达，包括 Starbucks、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 政策。