Places API 会在响应中返回地点的相关信息。除了地址和电话号码等事实性内容之外,回答中还可能包含用户在 Google 地图上贡献的内容,例如评价和照片。此外,当您使用 Places API 的 Gemini 模型功能时,响应可以包含从 LLM 汇总和总结的生成式数据。
虽然 Google 已采取一系列措施,以便在 Google 地图 API 返回有问题的内容之前识别这些内容,但我们还为用户提供了举报不当内容的方法,以便 Google 将其移除。在此版本中,Places API 会在 Places API 响应中包含的所有评价、照片和生成式摘要中添加新的 flagContentUri
字段。此字段包含一个链接(包括唯一的内容标识符),供用户向 Google 举报不当内容。
例如,您发出一个请求,系统会返回某个地点的 5 条个别评价。每个评价都包含新的 flagContentUri
字段,其中包含该评价的唯一标识符,以便用户报告任何评价或所有评价存在的问题。
借助 API Explorer,您可以发出实时请求,以便熟悉这些新选项:
链接格式
flagContentUri
字段中包含的网址包含内容的唯一标识符。浏览此链接会打开一个由 Google 托管的网页,格式如下:
在该对话框中,用户可以向 Google 提交适当的问题类型报告。例如,他们可以举报粗言秽语、欺凌行为或内容存在的法律问题。
价格
此功能处于正式发布前预览阶段,在预览期间使用不收费,也就是说,结算金额为 0 美元。如需详细了解拟议的价格,请参阅 Places API 的使用量和结算。
显示内容举报链接
此预览版向已包含在 Google 地图 API 响应中的以下对象添加了新的 flagContentUri
字段:
Review
Photo
GenerativeSummary
仅GenerativeSummary
新增了两个字段:overviewFlagContentUri
:用于在概览中通知 Google 不当内容的链接。descriptionFlagContentUri
:用于通知 Google 说明中存在不当内容的链接。
在预览期间,您在向客户展示这些对象时无需显示内容举报链接。
不过,当此功能正式发布 (GA) 后,您在显示这些对象时必须显示内容举报链接,以便客户可以举报任何内容问题。
访问回复中的内容举报链接
以下地点详情请求的响应中包含地点评价:
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 窗口。