Places API (新版) 會在回應中傳回地點資訊。除了地址和電話號碼等實際內容,回覆也可能包含使用者在 Google 地圖上提供的內容,例如評論和相片。此外,使用 Gemini 模型功能搭配 Places API (新版) 時,回應可能會包含從 LLM 匯總及摘要的生成式資料。
雖然 Google 已採取一系列措施,在 Places API (新版) 傳回內容前識別有問題的內容,但我們也提供使用者檢舉不當內容的方式,以便 Google 移除這類內容。在此版本中,Places API (新版) 會在 Places API (新版) 回應中包含的所有評論、相片和生成摘要中,加入新的 flagContentUri 欄位。這個欄位包含連結 (包括專屬內容 ID),可讓使用者向 Google 檢舉不當內容。
[null,null,["上次更新時間:2025-08-29 (世界標準時間)。"],[[["\u003cp\u003eThe Places API now includes a \u003ccode\u003eflagContentUri\u003c/code\u003e field in reviews, photos, and generative summaries, enabling users to report inappropriate content directly to Google.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is currently in Preview and free of charge; billing details for when it reaches General Availability can be found in the Places API Usage and Billing documentation.\u003c/p\u003e\n"],["\u003cp\u003eWhile not mandatory during Preview, displaying the content reporting link will be required upon General Availability to facilitate user reporting of content issues.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eflagContentUri\u003c/code\u003e field contains a unique URL that opens a Google-hosted webpage for users to specify the issue type and submit their report.\u003c/p\u003e\n"],["\u003cp\u003eThese content reporting links will remain functional until the associated content is removed, although reporting on removed content will have no effect.\u003c/p\u003e\n"]]],["The Places API now includes a `flagContentUri` field in reviews, photos, and generative summaries, allowing users to report inappropriate content. This field provides a unique URL for each item, directing users to a Google-hosted page where they can report issues like profanity or bullying. During the pre-GA preview, this feature is free to use, but upon GA release, displaying the content reporting link will become mandatory. The feature can be tested using the API Explorer.\n"],null,["# Report inappropriate content\n\nThe Places API (New) returns information about a place in a response.\nAlong with factual content, such as an address and phone number, the response\ncan also contain content that users have contributed on Google Maps, such as\nreviews and photos. In addition, when you use [Gemini model capabilities for\nPlaces API (New)](/maps/documentation/places/web-service/experimental/places-generative),\nthe response can include generative data aggregated and summarized from a LLM.\n\nAlthough Google has implemented a series of measures to identify problematic\ncontent before it is returned by the Places API (New), we also provide a\nway for users to flag inappropriate content so that Google can remove it. With\nthis release, the Places API (New) includes the new `flagContentUri` field\nin all reviews, photos, and generative summaries included in a\nPlaces API (New) response. This field contains a link, including a unique\ncontent identifier, that lets users notify Google of inappropriate content.\n\nFor example, you make a request that returns five individual reviews for a\nplace. Each individual review includes the new `flagContentUri` field with a\nunique identifier for that review so that a user can report an issue with any or\nall of the reviews.\n\nThe API Explorer lets you make live requests so that you can get familiar with\nthese new options:\n\n[Try it!](#try-it)\n\nLink format\n-----------\n\nThe URL contained in the `flagContentUri` field includes a unique identifier for\nthe content. Browsing to this link opens a Google-hosted web page in the form:\n\nFrom this dialog, your users can file a report with Google for the appropriate\nissue type. For example, they can report profanity, bullying, or a legal issue\nwith the content.\n\nDisplay the content reporting link\n----------------------------------\n\nThe `flagContentUri` field is available in the following objects that are\nalready part of the Places API (New) response:\n\n- [`Review`](/maps/documentation/places/web-service/reference/rest/v1/places#review)\n- [`Photo`](/maps/documentation/places/web-service/reference/rest/v1/places#photo)\n- [`GenerativeSummary`](/maps/documentation/places/web-service/reference/rest/v1/places#generativesummary)\n- [`NeighborhoodSummary`](/maps/documentation/places/web-service/reference/rest/v1/places#neighborhoodsummary)\n- [`EvChargeAmenitySummary`](/maps/documentation/places/web-service/reference/rest/v1/places#evchargeamenitysummary)\n- [`ReviewSummary`](/maps/documentation/places/web-service/reference/rest/v1/places#reviewsummary)\n- [`ContextualContent`](/maps/documentation/places/web-service/reference/rest/v1/places/searchText#ContextualContent)\n\nYou must display the content reporting link when you display these objects so\nthat your customers can report any content issues.\n\nAccess the content reporting link in the response\n-------------------------------------------------\n\n| **Note:** See the [Gemini model capabilities for\n| Places API (New)](/maps/documentation/places/web-service/experimental/places-generative) for examples using `GenerativeSummary`, `NeighborhoodSummary`, `EvChargeAmenitySummary`, and `ReviewSummary`.\n\nThe following Place Details (New) request includes place reviews in the\nresponse: \n\n```\ncurl -X GET -H 'Content-Type: application/json' \\\n-H \"X-Goog-Api-Key: API_KEY\" \\\n-H \"X-Goog-FieldMask: id,displayName,reviews\" \\\nhttps://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw\n```\n\nThe response is in the form:\n**Note:** The example URLs shown in the responses below are placeholders for real content URLs and cannot be used to report an issue. \n\n```text\n{\n \"id\": \"ChIJj61dQgK6j4AR4GeTYWZsKWw\",\n \"displayName\": {\n \"text\": \"Googleplex\",\n \"languageCode\": \"en\"\n },\n \"reviews\": [\n {\n \"name\": \"places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/ChdDjNnRRAB\",\n \"relativePublishTimeDescription\": \"7 months ago\",\n \"rating\": 3,\n \"text\": {\n \"text\": \"Came here for a tour and honestly,...\",\n \"languageCode\": \"en\"\n },\n \"originalText\": {\n \"text\": \"Came here for a tour and honestly,...\",\n \"languageCode\": \"en\"\n },\n \"authorAttribution\": {\n \"displayName\": \"John Smith\",\n \"uri\": \"https://www.google.com/maps/contrib/10198693/reviews\",\n \"photoUri\": \"https://lh3.googleusercontent.com/a-/A-c00-cc-rp-mo-ba6\"\n },\n \"publishTime\": \"2024-02-24T19:26:18.091264Z\",\n \"flagContentUri\": \"https://www.google.com/local/review/rap/report?postId=CJ2&t=1\",\n \"googleMapsUri\": \"https://www.google.com/maps/reviews/data=!4m6!14m5\"\n },\n …\n ]\n}\n```\n\nEach entry in the `reviews` array contains the `flagContentUri` field, including\na unique identifier for that specific review. Browsing to that link lets your\ncustomers report inappropriate content for that specific review.\n\nIf you include `photos` in the field mask: \n\n```\ncurl -X GET -H 'Content-Type: application/json' \\\n-H \"X-Goog-Api-Key: API_KEY\" \\\n-H \"X-Goog-FieldMask: id,displayName,reviews,photos\" \\\nhttps://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw\n```\n\nThe response also includes the `photos` array where each element contains the\n`flagContentUri` field: \n\n```scdoc\n ...\n \"photos\": [\n {\n \"name\": \"places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/AdCG2DNmA4zTnu24VKCwSW7ulKkgDA8cTe5sz74Q4Doo\",\n \"widthPx\": 4032,\n \"heightPx\": 3024,\n \"authorAttributions\": [\n {\n \"displayName\": \"Jane Smith\",\n \"uri\": \"https://maps.google.com/maps/contrib/107007354\",\n \"photoUri\": \"https://lh3.googleusercontent.com/a-/ALV-UjXvHp8Kg932h80MpoDSJ_Sl4F-no-mo\"\n }\n ],\n \"flagContentUri\": \"https://www.google.com/local/imagery/report/?cb_client=maps_api_places&image_key=!1e10!2XtMU_GKr\",\n \"googleMapsUri\": \"https://www.google.com/maps/reviews/data=!4m6!14m5\"\n },\n ...\n ]\n```\n\n### Link expiration\n\nThe content links remain active until the backing content is removed. The links\ndo continue to open the dialog for content that has been removed, but filing a\nreport on content that has already been removed has no effect.\n\nTry it!\n-------\n\nThe API Explorer lets you make sample requests so that you can get familiar with\nthe API and the API options.\n\n1. Select the API icon, , on the right\n side of the page.\n\n2. Optionally expand **Show standard parameters** and set **the `fields`\n parameter** to the [field\n mask](/maps/documentation/places/web-service/choose-fields).\n\n3. Optionally edit the **Request body**.\n\n4. Select **Execute** button. In the dialog, choose the account that you want\n to use to make the request.\n\n5. In the API Explorer panel, select the expand icon, , to expand the API Explorer window.\n\n \u003cbr /\u003e\n\n \u003cbr /\u003e"]]