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