تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض Places API (الجديدة) معلومات حول مكان ما في ردّ.
بالإضافة إلى المحتوى الوقائعي، مثل العنوان ورقم الهاتف، يمكن أن يتضمّن الرد أيضًا محتوًى ساهم به المستخدمون على "خرائط Google"، مثل المراجعات والصور. بالإضافة إلى ذلك، عند استخدام إمكانات نموذج Gemini في
Places API (New)،
يمكن أن يتضمّن الردّ بيانات توليدية مجمّعة وملخّصة من نموذج لغوي كبير.
على الرغم من أنّ 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، بما في ذلك معرّف فريد لتلك المراجعة المحدّدة. يؤدي الانتقال إلى هذا الرابط إلى السماح لعملائك بالإبلاغ عن محتوى غير ملائم في تلك المراجعة المحدّدة.
تبقى روابط المحتوى نشطة إلى أن تتم إزالة المحتوى الأساسي. ستستمر الروابط في فتح مربّع الحوار الخاص بالمحتوى الذي تمت إزالته، ولكن لن يكون لتقديم بلاغ بشأن محتوى تمت إزالته أي تأثير.
جرِّبها الآن
يتيح لك "مستكشف واجهات برمجة التطبيقات" تقديم طلبات نموذجية لتتعرّف على واجهة برمجة التطبيقات وخياراتها.
انقر على رمز واجهة برمجة التطبيقات في الجانب الأيسر من الصفحة.
يمكنك اختياريًا توسيع عرض المَعلمات العادية وضبط المَعلمة fields على قناع الحقل.
يمكنك اختياريًا تعديل نص الطلب.
انقر على الزر تنفيذ. في مربّع الحوار، اختَر الحساب الذي تريد استخدامه لتقديم الطلب.
في لوحة "مستكشف واجهات برمجة التطبيقات"، انقر على رمز التوسيع لتوسيع نافذة "مستكشف واجهات برمجة التطبيقات".
تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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"]]