با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Places API (جدید) اطلاعات یک مکان را در یک پاسخ برمی گرداند. همراه با محتوای واقعی، مانند آدرس و شماره تلفن، پاسخ همچنین می‌تواند حاوی محتوایی باشد که کاربران در Google Maps ارائه کرده‌اند، مانند نظرات و عکس‌ها. علاوه بر این، هنگامی که از قابلیت‌های مدل Gemini برای Places API (جدید) استفاده می‌کنید، پاسخ می‌تواند شامل داده‌های تولیدی باشد که از یک LLM جمع‌آوری و خلاصه می‌شوند.
اگرچه Google یک سری اقدامات را برای شناسایی محتوای مشکل دار قبل از بازگرداندن آن توسط Places API (جدید) انجام داده است، ما همچنین راهی را برای کاربران ارائه می دهیم که محتوای نامناسب را پرچم گذاری کنند تا Google بتواند آن را حذف کند. با این نسخه، Places API (جدید) شامل فیلد flagContentUri جدید در همه بررسی‌ها، عکس‌ها و خلاصه‌های تولیدی موجود در پاسخ Places API (جدید) می‌شود. این فیلد حاوی یک پیوند، شامل یک شناسه محتوای منحصربه‌فرد است که به کاربران امکان می‌دهد Google را از محتوای نامناسب مطلع کنند.
به عنوان مثال، شما درخواستی را ارائه می کنید که برای یک مکان، پنج بررسی جداگانه را برمی گرداند. هر مرور فردی شامل فیلد flagContentUri جدید با یک شناسه منحصربه‌فرد برای آن بررسی است تا کاربر بتواند مشکلی را در مورد هر یک یا همه نظرات گزارش کند.
API Explorer به شما امکان می دهد درخواست های زنده بنویسید تا بتوانید با این گزینه های جدید آشنا شوید:
URL موجود در قسمت flagContentUri شامل یک شناسه منحصر به فرد برای محتوا است. با مرور این پیوند، یک صفحه وب میزبانی شده توسط Google به شکل زیر باز می شود:
از این گفتگو، کاربران شما می توانند گزارشی را برای نوع مشکل مناسب با Google ارسال کنند. به عنوان مثال، آنها می توانند توهین، قلدری، یا یک مشکل قانونی را در مورد محتوا گزارش کنند.
نمایش لینک گزارش محتوا
فیلد flagContentUri در اشیاء زیر موجود است که قبلاً بخشی از پاسخ Places API (جدید) هستند:
{
"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 ، از جمله یک شناسه منحصر به فرد برای آن بررسی خاص است. مرور به آن پیوند به مشتریان شما امکان می دهد محتوای نامناسب را برای آن بررسی خاص گزارش کنند.
پیوندهای محتوا تا زمانی که محتوای پشتیبان حذف نشود فعال می مانند. پیوندها همچنان به باز کردن گفتگو برای محتوای حذف شده ادامه می دهند، اما ثبت گزارش در مورد محتوایی که قبلاً حذف شده است تأثیری ندارد.
آن را امتحان کنید!
API Explorer به شما امکان می دهد درخواست های نمونه بنویسید تا بتوانید با API و گزینه های API آشنا شوید.
نماد API را انتخاب کنید، ، در سمت راست صفحه.
به صورت اختیاری نمایش پارامترهای استاندارد را گسترش دهید و پارامتر fields را روی فیلد ماسک تنظیم کنید.
به صورت اختیاری بدنه درخواست را ویرایش کنید.
دکمه Execute را انتخاب کنید. در گفتگو، حسابی را که می‌خواهید برای ارسال درخواست استفاده کنید، انتخاب کنید.
در پانل API Explorer، نماد گسترش را انتخاب کنید، ، برای گسترش پنجره API Explorer.
تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی."],[[["\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,["The 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\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\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 **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\nLink 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\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"]]
، در سمت راست صفحه.
، برای گسترش پنجره API Explorer.