举报不当内容

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 字段:

在预览期间,您在向客户展示这些对象时无需显示内容举报链接。

不过,当此功能正式发布 (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 选项。

  1. 选择页面右侧的 API 图标 展开 API Explorer。

  2. (可选)展开显示标准参数,然后将 fields 参数设置为字段掩码

  3. 您可以视需要修改请求正文

  4. 选择执行按钮。在对话框中,选择您要使用哪个账号发出请求。

  5. 在 API Explorer 面板中,选择展开图标 展开 API Explorer。 以展开 API Explorer 窗口。