Places API (नया प्रॉडक्ट), किसी जगह के बारे में जानकारी को जवाब के तौर पर दिखाता है. जवाब में, पते और फ़ोन नंबर जैसे तथ्यों के साथ-साथ, ऐसा कॉन्टेंट भी शामिल हो सकता है जिसे लोगों ने Google Maps पर शेयर किया है. जैसे, समीक्षाएं और फ़ोटो. इसके अलावा, Places API (नया) के लिए Gemini मॉडल की सुविधाओं का इस्तेमाल करने पर, जवाब में जनरेटिव डेटा शामिल हो सकता है. यह डेटा, एलएलएम से इकट्ठा किया जाता है और इसकी खास जानकारी दी जाती है.
Google ने Places API (नया) के जवाब में समस्या पैदा करने वाला कॉन्टेंट दिखने से पहले ही उसे पहचान लेने के लिए कई तरीके लागू किए हैं. हालांकि, हम उपयोगकर्ताओं को आपत्तिजनक कॉन्टेंट की शिकायत करने का विकल्प भी देते हैं, ताकि Google उसे हटा सके. इस रिलीज़ के साथ, Places API (नया वर्शन) में flagContentUri फ़ील्ड शामिल किया गया है. यह फ़ील्ड, Places API (नया वर्शन) से मिले जवाब में शामिल सभी समीक्षाओं, फ़ोटो, और जनरेटिव एआई से तैयार की गई खास जानकारी में मौजूद होता है. इस फ़ील्ड में एक लिंक होता है. इसमें कॉन्टेंट का यूनीक आइडेंटिफ़ायर भी शामिल होता है. इसकी मदद से, उपयोगकर्ता Google को आपत्तिजनक कॉन्टेंट के बारे में सूचना दे सकते हैं.
उदाहरण के लिए, आपने किसी जगह के लिए पांच अलग-अलग समीक्षाओं का अनुरोध किया. हर समीक्षा में नया flagContentUri फ़ील्ड शामिल होता है. इसमें समीक्षा के लिए यूनीक आइडेंटिफ़ायर होता है, ताकि उपयोगकर्ता किसी भी या सभी समीक्षाओं से जुड़ी समस्या की शिकायत कर सके.
APIs Explorer की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको इन नए विकल्पों के बारे में जानने में मदद मिलती है:
लिंक का फ़ॉर्मैट
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"
},
...
]लिंक की समयसीमा खत्म होना
कॉन्टेंट के लिंक तब तक काम करते रहेंगे, जब तक उनसे जुड़ा कॉन्टेंट हटा नहीं दिया जाता. हटाए गए कॉन्टेंट के लिए, लिंक अब भी डायलॉग बॉक्स खोलते हैं. हालांकि, पहले से हटाए गए कॉन्टेंट के ख़िलाफ़ शिकायत करने से कोई फ़र्क़ नहीं पड़ता.
इसे आज़माएं!
API Explorer की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.
पेज के दाईं ओर मौजूद एपीआई आइकॉन
को चुनें.इसके अलावा, स्टैंडर्ड पैरामीटर दिखाएं को बड़ा करें और
fieldsपैरामीटर को फ़ील्ड मास्क पर सेट करें.अनुरोध के मुख्य हिस्से में बदलाव करें. हालाँकि, ऐसा करना ज़रूरी नहीं है.
लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.
एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, बड़ा करें आइकॉन
चुनें.