举报不当内容

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 说明中含有不当内容的链接。

  • AreaSummary

  • ContextualContent

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

不过，当此功能正式发布 (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 窗口。