Places API(新)会在响应中返回有关地点的信息。 除了地址和电话号码等事实内容外,回答还可以包含用户在 Google 地图上贡献的内容,例如评价和照片。此外,当您使用 Places API (New) 的 Gemini 模型功能时,响应可以包含从 LLM 汇总和总结的生成式数据。
虽然 Google 已实施一系列措施来识别 Places API (New) 返回的问题内容,但我们也为用户提供了一种标记不当内容的方式,以便 Google 移除这些内容。在此版本中,Places API(新)会在 Places API(新)响应中包含的所有评价、照片和生成式摘要中添加新的 flagContentUri 字段。此字段包含一个链接(包括唯一的内容标识符),用户可以通过该链接向 Google 举报不当内容。
例如,您发出一个请求,该请求会返回某个地点的五条单独评价。每条评价都包含新的 flagContentUri 字段,其中包含相应评价的唯一标识符,以便用户报告任何或所有评价存在的问题。
借助 API Explorer,您可以发出实时请求,以便熟悉这些新选项:
链接格式
flagContentUri 字段中包含的网址包括内容的唯一标识符。浏览此链接会打开一个 Google 托管的网页,其格式如下:
通过此对话框,用户可以针对相应的问题类型向 Google 提交举报。例如,他们可以举报内容中出现的脏话、欺凌行为或法律问题。
显示内容举报链接
flagContentUri 字段可在以下对象中使用,这些对象已包含在 Places API(新)响应中:
ReviewPhotoGenerativeSummaryNeighborhoodSummaryEvChargeAmenitySummaryReviewSummaryContextualContent
您必须在显示这些对象时显示内容举报链接,以便客户举报任何内容问题。
访问回答中的内容举报链接
以下“地点详情(新)”请求会在响应中包含地点评价:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,reviews" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
响应的格式如下:
{
"id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
"displayName": {
"text": "Googleplex",
"languageCode": "en"
},
"reviews": [
{
"name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/ChdDjNnRRAB",
"relativePublishTimeDescription": "7 months ago",
"rating": 3,
"text": {
"text": "Came here for a tour and honestly,...",
"languageCode": "en"
},
"originalText": {
"text": "Came here for a tour and honestly,...",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "John Smith",
"uri": "https://www.google.com/maps/contrib/10198693/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/A-c00-cc-rp-mo-ba6"
},
"publishTime": "2024-02-24T19:26:18.091264Z",
"flagContentUri": "https://www.google.com/local/review/rap/report?postId=CJ2&t=1",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5"
},
…
]
}reviews 数组中的每个条目都包含 flagContentUri 字段,其中包括相应特定评价的唯一标识符。通过浏览该链接,您的客户可以举报相应评价中的不当内容。
如果您在字段掩码中添加了 photos,则:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,reviews,photos" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
响应还包含 photos 数组,其中每个元素都包含 flagContentUri 字段:
...
"photos": [
{
"name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/AdCG2DNmA4zTnu24VKCwSW7ulKkgDA8cTe5sz74Q4Doo",
"widthPx": 4032,
"heightPx": 3024,
"authorAttributions": [
{
"displayName": "Jane Smith",
"uri": "https://maps.google.com/maps/contrib/107007354",
"photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjXvHp8Kg932h80MpoDSJ_Sl4F-no-mo"
}
],
"flagContentUri": "https://www.google.com/local/imagery/report/?cb_client=maps_api_places&image_key=!1e10!2XtMU_GKr",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5"
},
...
]链接失效
内容链接会一直有效,直到支持内容被移除。这些链接确实会继续打开对话框,以针对已移除的内容提交报告,但对已移除的内容提交报告没有任何效果。
试试看!
借助 API Explorer,您可以发出示例请求,以便熟悉 API 和 API 选项。
选择页面右侧的 API 图标
。(可选)展开显示标准参数,然后将
fields参数设置为字段掩码。您可以视需要修改请求正文。
选择执行按钮。在对话框中,选择您要用于提出请求的账号。
在“API Explorer”面板中,选择展开图标
以展开“API Explorer”窗口。