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 链接，用户可以通过该链接标记生成的摘要存在问题。
  • 一个本地化文本字符串，其中包含披露文本“Summarized with 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 链接，用户可以通过该链接标记生成的摘要存在问题。
  • 一个已本地化文本字符串，其中包含披露文本“Summarized with 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"
    }
  }
}

归因

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