Places API (New) اطلاعات مربوط به مکان را در پاسخ برمیگرداند. همراه با محتوای واقعی، مانند نشانی و شماره تلفن، پاسخ میتواند حاوی محتوایی باشد که کاربران در Google Maps همیاری کردهاند، مانند مرورها و عکسها. علاوهبراین، وقتی از قابلیتهای مدل Gemini برای Places API (جدید) استفاده میکنید، پاسخ میتواند شامل دادههای زایایی باشد که از مدل زبانی بزرگ جمعآوری و خلاصه شده است.
اگرچه Google مجموعهای از اقدامات را برای شناسایی محتوای مشکلدار قبلاز اینکه توسط Places API (جدید) برگردانده شود اجرا کرده است، ما همچنین روشی را برای کاربران فراهم کردهایم تا محتوای نامناسب را پرچمگذاری کنند تا Google بتواند آن را بردارد. با
این نسخه پخش، «میانای برنامهسازی کاربردی مکانها (جدید)» شامل فیلد جدید flagContentUri
در همه مرورها، عکسها، و خلاصه زایا است که در
پاسخ «میانای برنامهسازی کاربردی مکانها (جدید)» گنجانده شده است. این فیلد حاوی پیوندی است که شامل یک شناسه محتوای یکتا است و به کاربران امکان میدهد Google را از محتوای نامناسب مطلع کنند.
برای مثال، درخواستی ارسال میکنید که پنج مرور جداگانه برای مکانی را برمیگرداند. هر مرور جداگانه شامل فیلد جدید flagContentUri با شناسه یکتا برای آن مرور است تا کاربر بتواند مشکل هرکدام یا همه مرورها را گزارش کند.
API Explorer به شما امکان میدهد درخواستهای مستقیم ارسال کنید تا بتوانید با این گزینههای جدید آشنا شوید:
قالب پیوند
نشانی وب موجود در فیلد flagContentUri شامل یک شناسه یکتا برای محتوا است. مرور کردن این پیوند صفحه وب میزبانیشده در Google را در این فرم باز میکند:
از این کادر گفتگو، کاربران شما میتوانند گزارشی را با Google برای نوع مشکل مناسب ثبت کنند. برای مثال، آنها میتوانند ناسزاگویی، زورگویی، یا یک مشکل قانونی با محتوا را گزارش کنند.
نمایش پیوند گزارش محتوا
فیلد flagContentUri در اشیای زیر که
ازقبل بخشی از پاسخ «میانای برنامهسازی کاربردی مکانها» (جدید) هستند دردسترس است:
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"
},
...
]انقضای پیوند
پیوندهای محتوا تا زمانی که محتوای پشتیبان برداشته نشود فعال میمانند. پیوندها همچنان کادر گفتگو را برای محتوایی که برداشته شده است باز میکنند، اما گزارش کردن محتوایی که قبلاً برداشته شده است هیچ تأثیری ندارد.
امتحان کنید!
API Explorer به شما امکان میدهد درخواستهای نمونه ایجاد کنید تا بتوانید با API و گزینههای API آشنا شوید.
نماد «میانای برنامهسازی کاربردی»
را در سمت چپ صفحه انتخاب کنید.درصورت تمایل، نمایش پارامترهای استاندارد را ازهم باز کنید و پارامتر
fieldsرا روی پوشش فیلد تنظیم کنید.درصورت تمایل، بدنه درخواست را ویرایش کنید.
دکمه اجرا را انتخاب کنید. در کادر گفتگو، حسابی را که میخواهید برای درخواست استفاده کنید انتخاب کنید.
در پانل «کاوشگر میانای برنامهسازی کاربردی»، نماد ازهم بازکردن،
، را برای ازهم بازکردن پنجره «کاوشگر میانای برنامهسازی کاربردی» انتخاب کنید.