AI 赋能的区域摘要

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

例如，当您前往新城市时，可以查看系统为酒店生成的社区摘要，详细了解周边地区：

  • “这个充满活力的旧金山地区融合了北滩和唐人街，位于金融区的西北部，拥有文学地标、独特的文化景点和多元化的餐饮场所。著名景点包括标志性的 City Lights 书店、迷人的缆车博物馆和熙熙攘攘的唐人街。

    该地区融合了独特的历史和文化，虽然有部分山丘和人群，但步道环境宜人，非常适合探索。在 City Lights 书店沉浸在文学历史中，体验唐人街充满活力的文化，参观寺庙和幸运饼厂，或在缆车博物馆穿越时空。您可以选择各种餐饮，从正宗中餐到美味披萨，应有尽有。”

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

  • “步行 9 分钟即可抵达该区域内的多家餐厅，包括星巴克、Sushi Jin 和 Safeway。”

除了对相应区域的描述之外，响应还包含描述中提及的地点的地点 ID 列表。

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

  • 社区摘要：为类型为 premise、street_address 以及住宅和住宿类别中的所有类型的地点提供附近景点的概览。
  • 电动车辆充电站 (EVCS) 设施摘要，可为类型为 electric_vehicle_charging_station 的地点提供附近景点的大致概览。

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

请求获取邻里摘要

系统可以为住宅和住宿类别的地点生成邻里摘要。如需在响应中返回邻里摘要，请在请求的字段掩码中添加以下内容：

  • 地点详情（新）：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 的政策和标准。如需了解详情，请参阅 适用于地点 API 的政策。