此页面由 Cloud Translation API 翻译。

AI 赋能的评价摘要

AI 赋能的评价摘要是 AI 仅根据用户评价生成的地点摘要。通过综合用户评价的关键元素（例如地点属性和评价者情感），评价摘要可提供概要数据分析，帮助用户做出明智的决定。

例如，旧金山渡轮大厦的评价摘要包含从美食和购物到景色和氛围等各方面的信息：

“游客表示，这个历史地标拥有丰富多样的商店、餐厅和农民市场，许多人赞叹这里的海湾和城市景观。他们还强调了该岛屿充满活力的氛围、便捷的渡轮交通，以及享受当地商家带来的乐趣。”

地点详情（新）、文本搜索（新）和附近搜索（新）支持评价摘要。

试用 AI 赋能的摘要演示版

申请审核摘要

如需请求审核摘要，请在请求的字段掩码中添加 reviewSummary：

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

评价摘要的提供方注明必须包含指向 Google 地图上相应地点评价的链接。如需检索该关联，请在请求的字段掩码中添加 googleMapsLinks.reviewsUri。

响应正文包含三个字段：

text：AI 生成的评价摘要。
flagContentUri：用于举报不当内容，以便 Google 将其移除。
disclosureText：包含“使用 Gemini 总结”披露文本的本地化文本字符串，必须纳入提供方说明中。

“地点详情（新）”请求

以下示例请求获取纽约一家饺子餐厅的评价摘要：

curl -X GET https://places.googleapis.com/v1/places/ChIJD2l2k7ZL0YkRC80d-3MV1lM \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,reviewSummary,googleMapsLinks.reviewsUri"

响应格式如下：

{
  "displayName": {
    "text": "Dumpling House",
    "languageCode": "en"
  },
  "googleMapsLinks": {
    "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89d14bb69376690f:0x53d61573fb1dcd0b!9m1!1b1",
  },
  "reviewSummary": {
    "text": {
      "text": "Diners say this lunch restaurant serves up delicious dumplings, including pork and chive, soup dumplings, and fried dumplings, alongside other Chinese dishes like fried rice, pork belly buns, and general tso's chicken. They also highlight the generous portions, reasonable prices, and efficient service.",
      "languageCode": "en-US"
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkE4blltMzB1eXpWblVKUjFBQXFGbWc%7CCAIQACorChtyc19oOkE4blltMzB1eXpWblVKUjFBQXFGbWcSDAis0fW-BhCIp7blAg&d=17924085&t=8",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

文本搜索（新）请求

以下示例请求获取纽约市某家咖啡店的评价摘要：

curl -X POST -d '{
  "textQuery": "coffee shop",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 40.722630,
        "longitude": -74.001397
      }
    }
  },
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary,places.googleMapsLinks.reviewsUri" \
'https://places.googleapis.com/v1/places:searchText'

响应正文的格式如下：

{
  "places": [
    {
      "id": "ChIJyfJXNphZwokRbo-oe0DjVT4",
      "googleMapsLinks": {
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259983657f2c9:0x3e55e3407ba88f6e!9m1!1b1",
      },
      "reviewSummary": {
        "text": {
          "text": "People say this coffee shop serves delicious oat milk lattes, iced lattes, and cappuccinos, and they praise the friendly staff and cozy atmosphere. They also highlight the great outdoor seating area and the unique latte flavors.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkFONEpuYU1UMzZWbTduX1lBQVRBRkE%7CCAIQACorChtyc19oOkFONEpuYU1UMzZWbTduX1lBQVRBRkESDAj9iuK_BhD4ouCwAw&d=17924085&t=8",
        "disclaimerText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJl5qG27RZwokRzoy63vyI4Gk",
      "googleMapsLinks": {
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259b4db869a97:0x69e088fcdeba8cce!9m1!1b1",
      },
      "reviewSummary": {
        "text": {
          "text": "People say this coffee shop serves delicious matcha, including the Blueberry Matcha Latte and Cherry Cold Brew Latte, and offers a variety of pastries. They also highlight the friendly and efficient staff, and the cute and aesthetic space.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkE4bmRodTgya2MxbkJNMXhBQU1MNXc%7CCAIQACorChtyc19oOkE4bmRodTgya2MxbkJNMXhBQU1MNXcSDAj9iuK_BhD4ouCwAw&d=17924085&t=8",
        "disclaimerText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

“附近搜索（新）”请求

以下示例请求西雅图市中心附近的酒店：

curl -X POST -d '{
  "maxResultCount": 5,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 47.609937,
        "longitude": -122.340714
      },
      "radius": 1000
    }
  },
  "includedTypes": ["hotel"],
  "excludedTypes": [],
  "rankPreference":"POPULARITY"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary,places.googleMapsLinks.reviewsUri" \
'https://places.googleapis.com/v1/places:searchNearby'