Places API (नया) के लिए Gemini मॉडल की सुविधाएं, एलएलएम के लिए Places API का इस्तेमाल करती हैं, ताकि आप किसी जगह से जुड़ा डेटा (कारोबार के खुलने का समय, समीक्षाएं, फ़ोटो) के साथ-साथ एलएलएम से मिले डेटा को भी वापस कर सकें. इस जनरेटिव डेटा में, किसी जगह से पहले से जुड़े डेटा को बेहतर बनाने के लिए, एलएलएम से इकट्ठा किया गया और खास जानकारी वाला डेटा शामिल होता है.
उदाहरण के लिए, "ईवी चार्जिंग स्टेशन" के लिए स्टैंडर्ड Text Search (नया) दिखाने पर, ईवी चार्जिंग की सुविधा देने वाली जगहों की सूची दिखती है. अगर आपको नज़दीकी ईवी चार्जर या अपने वाहन के साथ काम करने वाले सबसे नज़दीकी ईवी चार्जर की तलाश है, तो इस तरह का जवाब दें.
हालांकि, आपको चार्जिंग स्टेशन के आस-पास के इलाके के बारे में बेहतर जानकारी चाहिए. खास तौर पर, जब आपको वहां एक घंटे या उससे ज़्यादा समय तक जाना हो, और गाड़ी चार्ज करते समय. उसी खोज के लिए Gemini मॉडल की सुविधाओं का इस्तेमाल करने पर, जवाब में मौजूद हर जगह के बारे में डाइनैमिक और जनरेटिव जानकारी दी जा सकती है. इसमें चार्जिंग स्टेशन के आस-पास के इलाके की जानकारी भी शामिल हो सकती है:
"दो से चार मिनट की पैदल दूरी पर खाने-पीने और शॉपिंग के कई विकल्प मौजूद हैं. जैसे, शेफ़ चू, जेन कोरियन बारबेक्यू हाउस, ऐंबर इंडिया, पेसिफ़िक कैच, और राशन की कई दुकानें, जैसे कि Walmart, Whole Foods Market, और Trader Joe's."
"1 से 5 मिनट की पैदल दूरी पर खाने-पीने और शॉपिंग के कई विकल्प मौजूद हैं. इनमें खाओ कांग थाई किचन, रॉजर्स डेली और डोनट, और ला कोस्टेनिया शामिल हैं. सुशी के लिए, जॉय सुशी एक अच्छा विकल्प है. किराने के सामान के लिए, डॉलर ट्री छूट पर कई तरह के प्रॉडक्ट ऑफ़र करता है."
एलएलएम के इस जनरेटिव कॉन्टेंट से, जवाब को बेहतर बनाया जाता है. साथ ही, इससे उपयोगकर्ताओं को ज़्यादा जानकारी मिलती है, ताकि वे सोच-समझकर फ़ैसला ले सकें.
Places API में, एआई की मदद से काम करने वाली नई सुविधाएं जोड़ी गई हैं (नई)
ये सुविधाएं, Places API (नया) रिस्पॉन्स में नीचे दिया गया डेटा जोड़ती हैं:
जगह के बारे में जनरेटिव एआई की खास जानकारी, जो किसी खास जगह के बारे में हो. जगह की खास जानकारी का इस्तेमाल, जगह की जानकारी (नई), टेक्स्ट खोज (नई), और आस-पास की जाने वाली खोज (नई) के साथ किया जा सकता है.
इलाके के बारे में खास जानकारी, जो किसी जगह के आस-पास के इलाके से जुड़ी होती है. इलाके की खास जानकारी में जगह की जानकारी (नई), टेक्स्ट खोज (नया), और आस-पास खोज (नई) सुविधा का इस्तेमाल किया जा सकता है.
संदर्भ के हिसाब से खोज के नतीजे, Text Search (नए) के साथ काम करते हैं. इनमें सीधे तौर पर किसी जगह से जुड़े डेटा के बजाय, अनुरोध में की गई खोज स्ट्रिंग के आधार पर डेटा शामिल होता है. इस डेटा से यह समझने में मदद मिलती है कि Text Search (नया) रिस्पॉन्स कैसे तय करता है.
जनरेटिव एआई की मदद से जगहों के बारे में खास जानकारी
जनरेटिव एआई से होने वाली जगह की जानकारी, खास तौर पर किसी जगह के आईडी के लिए होती है. जगह के बारे में खास जानकारी से, किसी जगह के लिए अलग-अलग तरह के डेटा को एक ही जवाब में इकट्ठा किया जाता है.
Places API (नया) दो तरह से जनरेटिव प्लेस के बारे में खास जानकारी देता है:
खास जानकारी: किसी जगह के बारे में खास जानकारी, औसतन 100 वर्णों में दी जाती है. इससे उपयोगकर्ताओं को किसी जगह का स्नैपशॉट पाने में मदद मिलती है.
ब्यौरे का सारांश: किसी जगह के बारे में खास जानकारी, औसतन करीब 400 वर्णों में होती है. इस जानकारी से, उस जगह के मुख्य पहलुओं के बारे में खास जानकारी मिलती है.
फ़िलहाल, जगहों की खास जानकारी उन जगहों के टाइप के लिए उपलब्ध है जो सांस्कृतिक, मनोरंजन और मनोरंजन, खाने-पीने की चीज़ें, शॉपिंग, और खेल-कूद कैटगरी में काम करती हैं.
जनरेटिव एरिया से जुड़ी खास जानकारी
एलएलएम, किसी जगह के आस-पास के इलाके के लिए जनरेटिव एरिया से जुड़ी ख़ास जानकारी जनरेट करता है. किसी स्थान के क्षेत्र के सारांश में वह सभी जानकारी हो सकती है जो उपयोगकर्ता को कोई फ़ैसला लेने में मदद करती है. इसके लिए, उपयोगकर्ता को इलाके की जानकारी देखने के दूसरे अनुरोध करने की ज़रूरत नहीं होती.
इस जवाब में इलाके के ब्यौरे के साथ-साथ, ब्यौरे में बताई गई जगहों के जगहों के आईडी की सूची और अलग-अलग तरह के कॉन्टेंट के मुताबिक क्रम में लगाई गई जगहों के आईडी भी शामिल होते हैं. उदाहरण के लिए, एक कॉन्टेंट टाइप में उस इलाके में होने वाली गतिविधियों से जुड़ी जगहों की सूची और दूसरे में उस इलाके के रेस्टोरेंट की सूची शामिल होती है.
फ़िलहाल, इलाके की खास जानकारी उन जगहों के टाइप के लिए उपलब्ध है जिन्हें लॉजिंग कैटगरी के लिए काम करने वाली जगह के टाइप में दिखाया गया है. साथ ही, जगहों के बारे में खास जानकारी भी उपलब्ध है. यह टाइप electric_vehicle_charging_station, geocode, और premise जैसी जगहों के लिए भी उपलब्ध है.
जगहों और इलाकों की खास जानकारी जनरेट करना
Google, अक्सर जनरेटिव एआई की मदद से जनरेट की गई जगह और जनरेटिव एरिया की खास जानकारी, दोनों को ऑफ़लाइन जनरेट करता है. खास जानकारी को ऑफ़लाइन जनरेट करके, Gemini के कॉन्टेंट का फ़ायदा पाया जा सकता है. साथ ही, Places API (नया) से आपकी उम्मीद के मुताबिक काम किया जा सकता है.
Google अक्सर इन खास जानकारी को फिर से जनरेट करता है, ताकि यह पक्का किया जा सके कि ये नई जानकारी के आधार पर नए हैं. इसका मतलब है कि एपीआई को कॉल करने पर, आपको अपनी सेवा में सबसे नया डेटा दिखेगा.
कॉन्टेक्स्ट के हिसाब से खोज के नतीजे
टेक्स्ट खोज (नया) स्ट्रिंग के आधार पर जगहों के सेट के बारे में जानकारी दिखाता है — उदाहरण के लिए, "न्यूयॉर्क में पिज़्ज़ा" या "ओटावा के आस-पास के जूतों की दुकानें". टेक्स्ट खोज (नया) रिस्पॉन्स में टेक्स्ट स्ट्रिंग से मेल खाने वाली जगहों की सूची और अनुरोध में सेट की गई जगह से जुड़े पूर्वाग्रह होते हैं.
जब जवाब में काम के खोज नतीजे जोड़े जाते हैं, तो अब रिस्पॉन्स में समीक्षाएं, फ़ोटो, और सही वजहें शामिल होती हैं. इनसे उपयोगकर्ताओं को सवालों के जवाब देने में मदद मिलती है:
- मुझे नतीजों में यह जगह क्यों दिख रही है?
- मुझे इस जगह को क्यों चुनना चाहिए?
उदाहरण के लिए, आज आपने जगह की जानकारी (नया), टेक्स्ट सर्च (नया) या आस-पास खोज (नई सुविधा) के लिए अनुरोध किया है, जिसमें जवाब में कोई खास जगह शामिल है. जगह के लिए रिस्पॉन्स डेटा, तीनों अनुरोधों के लिए एक जैसा होता है, क्योंकि दिखाया गया डेटा उसी जगह से जुड़ा होता है.
हालांकि, नई सुविधाओं का इस्तेमाल करने वाले टेक्स्ट सर्च (नई सुविधा) के लिए, रिस्पॉन्स में इनपुट क्वेरी स्ट्रिंग से मिला डेटा भी शामिल हो सकता है. इसका मतलब है कि क्वेरी स्ट्रिंग के हिसाब से खोज के नतीजे यूनीक होते हैं. उदाहरण के लिए, इस क्वेरी स्ट्रिंग का इस्तेमाल करके Text Search (नया) अनुरोध किया जाता है:
"माउंटेन व्यू, कैलिफ़ोर्निया में मसालेदार शाकाहारी रेस्टोरेंट"
इसके बाद, सभी इनपुट पैरामीटर को एक जैसा छोड़ दें और क्वेरी स्ट्रिंग को सिर्फ़ इनमें बदलें:
"माउंटेन व्यू, कैलिफ़ोर्निया में स्पाइसी वीगन रेस्टोरेंट"
दोनों जवाबों में दिखने वाले किसी रेस्टोरेंट के लिए, जगह के बारे में रिस्पॉन्स डेटा एक जैसा होता है, क्योंकि वह डेटा जगह से ही जुड़ा होता है. हालांकि, क्वेरी के लिए मिलते-जुलते खोज नतीजे यूनीक होते हैं, क्योंकि वे क्वेरी स्ट्रिंग से लिए जाते हैं. इसके बाद आप अपने उपयोगकर्ताओं को संदर्भ के हिसाब से खोज नतीजों में दिखाई गई समीक्षाएं, फ़ोटो, और सही ठहराने की जानकारी दिखा सकते हैं. इससे उन्हें यह तय करने में मदद मिलती है कि उनके खोज अनुरोध के लिए जवाब में कौनसी जगह सबसे ज़्यादा सही है.
Places API के लिए Gemini मॉडल की सुविधाओं को चालू करें (नया)
अगर आपको Places API (नया) के लिए Gemini मॉडल की सुविधाओं का इस्तेमाल करना है, तो आपको Places API (नया) चालू करना होगा. ज़्यादा जानकारी के लिए, Google Cloud प्रोजेक्ट सेट अप करना देखें.
एक्सपेरिमेंट के तौर पर रिलीज़ करने से जुड़ी पाबंदियां
इस रिलीज़ में, अमेरिका में मौजूद जगहों और इलाकों के बारे में खास जानकारी सिर्फ़ अंग्रेज़ी में उपलब्ध है.
Gemini क्या है?
Gemini मॉडल के बारे में जानने के लिए, Gemini के बारे में अक्सर पूछे जाने वाले सवाल देखें.
जनरेटिव एआई की मदद से जनरेट की गई जगह की जानकारी का अनुरोध करना
जगह के बारे में खास जानकारी, जनरेटिव एआई के रूप में बनाई जाती है, जिसे एलएलएम किसी खास जगह के लिए बनाता है. Places API (नया) किसी जवाब में दो तरह की खास जानकारी जोड़ता है:
खास जानकारी, जनरेटिव एआई से जुड़ी ऐसी खास जानकारी जो किसी जगह के बारे में स्टैटिक एडिटोरियल खास जानकारी से मिलती-जुलती हो. जनरेटिव कम शब्दों वाले जवाब, औसतन 100 वर्णों में होने के कई फ़ायदे हैं:
कई जगहों पर एडिटोरियल की खास जानकारी नहीं होती है. इस वजह से, उस जगह के बारे में उपलब्ध जानकारी में कमी आ जाती है.
ये एलएलएम से जनरेट होते हैं. इसलिए, जगह के मालिक को इनका रखरखाव करने की ज़रूरत नहीं होती.
जानकारी में, जनरेटिव एआई की मदद से जनरेट की गई खास जानकारी कई सोर्स से ली जाती है. इनमें Google Maps पर की गई समीक्षाएं भी शामिल हैं. औसतन 400 वर्णों के ब्यौरे में, उन समीक्षाओं की सूची शामिल होती है जिनका इस्तेमाल करके लंबा ब्यौरा जनरेट किया जाता है.
मैन्युअल तरीके से जानकारी का सारांश जनरेट करने के लिए, व्यक्ति को कई जगहों से डेटा इकट्ठा करके उसे हाथ से बनाना होता है. साथ ही, उस कॉन्टेंट का रखरखाव करना होता है. Places API (नया) के लिए Gemini मॉडल की सुविधाएं, एलएलएम से ये जवाब तैयार करती हैं. इससे जनरेट किए गए कॉन्टेंट का दायरा और नयापन बनाए रखने में मदद मिलती है.
जगह की खास जानकारी का इस्तेमाल, जगह की जानकारी (नई), टेक्स्ट खोज (नई), और आस-पास की जाने वाली खोज (नई) के साथ किया जा सकता है. जवाब में जगह की खास जानकारी शामिल करने के लिए, अनुरोध के फ़ील्ड मास्क में इस फ़ील्ड को शामिल करें:
जगह की जानकारी:
generativeSummaryटेक्स्ट खोज और आस-पास की खोज:
places.generativeSummary
generativeSummary फ़ील्ड में ये फ़ील्ड होते हैं:
generativeSummary.overview: जनरेटिव एआई के बारे में खास जानकारी.generativeSummary.description: जनरेटिव एआई के बारे में खास जानकारी.generativeSummary.references: ब्यौरे की जानकारी देने वाले जवाब का कॉन्टेंट उपलब्ध कराने के लिए इस्तेमाल की जाने वाली ज़्यादा से ज़्यादा पांच समीक्षाओं की कैटगरी. अगर ब्यौरे की कोई खास जानकारी नहीं है, तो यह कलेक्शन खाली होता है.
खास जानकारी वाले अनुरोध का उदाहरण
टेक्स्ट सर्च का यह उदाहरण, माउंटेन व्यू, कैलिफ़ोर्निया के मसालेदार शाकाहारी रेस्टोरेंट के लिए सिर्फ़ overview की खास जानकारी दिखाता है:
curl -X POST -d '{
"textQuery": "Spicy Vegetarian Food",
"location_bias":{
"rectangle":{
"low": {
"latitude": 37.415,
"longitude": -122.091},
"high":{
"latitude": 37.429,
"longitude": -122.065}
}
},
"maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary.overview" \
https://places.googleapis.com/v1/places:searchText
जवाब में generativeSummary.overview फ़ील्ड शामिल होता है, जिसमें overview.text और overview.languageCode शामिल होते हैं:
{
"places": [
{
"id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
"displayName": {
"text": "Zareen's",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
"languageCode": "en-US"
}
}
},
{
"id": "ChIJETHw0F-7j4AR85V_I6OobCI",
"displayName": {
"text": "Hyderabad Dum Biryani",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
"languageCode": "en-US"
}
}
},
. . .
}
खास जानकारी और जानकारी की खास जानकारी के अनुरोध का उदाहरण
यह उदाहरण वही क्वेरी बनाता है जैसा पिछले उदाहरण में दिखाया गया है. हालांकि, पूरे generativeSummary ऑब्जेक्ट को दिखाने के लिए, places.generativeSummary के फ़ील्ड मास्क का इस्तेमाल करता है. इसमें generativeSummary.overview, generativeSummary.description, और generativeSummary.references फ़ील्ड शामिल हैं:
{
"places": [
{
"id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
"displayName": {
"text": "Zareen's",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
"languageCode": "en-US"
},
"description": {
"text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
"languageCode": "en-US"
},
"references": {
"reviews": [
{
"name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
"relativePublishTimeDescription": "12 months ago",
"rating": 5,
"text": {
"text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
"languageCode": "en"
},
"originalText": {
"text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Anam Qureshi",
"uri": "https://www.google.com/maps/contrib/116859422317024657778/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1dl9FTSmec0x00000000-cc-rp-mo"
},
"publishTime": "2023-05-09T07:24:36Z"
},
. . .
]
}
}
},
{
"id": "ChIJETHw0F-7j4AR85V_I6OobCI",
"displayName": {
"text": "Hyderabad Dum Biryani",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
"languageCode": "en-US"
},
. . .
}
जनरेटिव एरिया की खास जानकारी का अनुरोध करें
एरिया के बारे में खास जानकारी, जनरेटिव एआई के ज़रिए किसी जगह के आस-पास के इलाके के लिए बनाई जाती है. इलाके के बारे में खास जानकारी, उपयोगकर्ताओं के लिए किसी जगह के बारे में फ़ैसला लेने के लिए अहम हो सकती है.
उदाहरण के लिए, आप किसी नए शहर में होटल बुक करना चाहते हैं और आपको अपनी ज़रूरतों के हिसाब से कोई होटल मिल सकता है, तो वहीं दूसरी तरफ़, आपको होटल के आस-पास के इलाके के बारे में भी ज़्यादा जानना है. आस-पास के क्षेत्र का मैप देखने और मैप पर मौजूद हर जगह की जांच-पड़ताल करने के बजाय, आप होटल के लिए क्षेत्र की खास जानकारी जनरेट कर सकते हैं.
इलाके की खास जानकारी में जगह की जानकारी (नई), टेक्स्ट खोज (नया), और आस-पास खोज (नई) सुविधा का इस्तेमाल किया जा सकता है.
जवाब में एरिया की खास जानकारी शामिल करने के लिए, अनुरोध के फ़ील्ड मास्क में इसे शामिल करें:
areaSummary(जगह की जानकारी)places.areaSummary(टेक्स्ट खोज और आस-पास की खोज).
रिस्पॉन्स में किसी जगह के लिए, areaSummary फ़ील्ड में ज़्यादा से ज़्यादा चार contentBlocks का कलेक्शन होता है.
हर ब्लॉक का विषय, जगह के हिसाब से तय होता है:
ईवी चार्जिंग स्टेशन के लिए,
electric_vehicle_charging_stationटाइप की जगह, विषय के ब्लॉक में शामिल होती है:"overview","coffee","restaurant", और"store".लॉजिंग कैटगरी में तय की गई जगह और खास तरह की जगह
geocodeऔरpremiseमें, विषय ब्लॉक में ये शामिल हैं:"overview","activity","restaurant", और"store".
ईवी चार्जिंग स्टेशन के एरिया की खास जानकारी के अनुरोध का उदाहरण
जगह की जानकारी के इस अनुरोध के उदाहरण में, माउंटेन व्यू में किसी ईवी चार्जिंग स्टेशन के इलाके की खास जानकारी दिखाई गई है. इस स्टेशन की पहचान, जगह के आईडी से की गई है
ChIJC5b6QKiwj4ARgn2EwlnJnWU:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,areaSummary" \ https://places.googleapis.com/v1/places/ChIJC5b6QKiwj4ARgn2EwlnJnWU
रिस्पॉन्स में areaSummary फ़ील्ड शामिल होता है. इसमें contentBlocks कलेक्शन भी शामिल होता है:
topicफ़ील्ड से यह तय होता है कि कॉन्टेंट ब्लॉक किस तरह का है. इस उदाहरण में दी गई जगह एक ईवी चार्जिंग स्टेशन है. इसलिए, कॉन्टेंट के चार ब्लॉक,"overview","coffee","restaurant", और"store"हैं.contentफ़ील्ड में उस विषय की खास जानकारी होती है. इसमें भाषा का कोड भी शामिल होता है.referencesकलेक्शन, जगह के रिसॉर्स के नामों के बारे मेंplaces/PLACE_IDफ़ॉर्म में बताता है. इनका इस्तेमाल कॉन्टेंट ब्लॉक के लिए कॉन्टेंट उपलब्ध कराने के लिए किया जाता है.
{
"id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
"displayName": {
"text": "EVgo Charging Station",
"languageCode": "en"
},
"areaSummary": {
"contentBlocks": [
{
"topic": "overview",
"content": {
"text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
"places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
]
}
},
{
"topic": "coffee",
"content": {
"text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
]
}
},
{
"topic": "restaurant",
"content": {
"text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
"places/ChIJETHw0F-7j4AR85V_I6OobCI",
"places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
"places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
]
}
},
{
"topic": "store",
"content": {
"text": "Safeway provides a range of groceries, along with a deli and a bakery.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
]
}
}
]
}
}
किसी होटल के इलाके की खास जानकारी के अनुरोध का उदाहरण
माउंटेन व्यू, कैलिफ़ोर्निया में होटल के लिए, टेक्स्ट सर्च के अनुरोध का यह उदाहरण:
curl -X POST -d '{
"textQuery": "Hotels",
"location_bias":{
"rectangle":{
"low": {
"latitude": 37.415,
"longitude": -122.091},
"high":{
"latitude": 37.429,
"longitude": -122.065}
}
},
"maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.areaSummary" \
https://places.googleapis.com/v1/places:searchText
रिस्पॉन्स में, areaSummary फ़ील्ड शामिल होता है. इसमें contentBlocks कलेक्शन भी शामिल होता है. होटल जैसी जगहों के लिए दिए गए जवाब में, "overview", "activity", "restaurant", और "store" विषयों के लिए, कॉन्टेंट ब्लॉक शामिल हैं:
{
"places": [
{
"id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
"displayName": {
"text": "Shashi Hotel Mountain View, an Urban Resort",
"languageCode": "en"
},
"areaSummary": {
"contentBlocks": [
{
"topic": "overview",
"content": {
"text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJOYvCo1W3j4AR1LAifgk13rs",
"places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
"places/ChIJo4za6vi5j4ARMua093RgGGA",
"places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
]
}
},
{
"topic": "activity",
"content": {
"text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJOYvCo1W3j4AR1LAifgk13rs",
"places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
"places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
]
}
},
{
"topic": "restaurant",
"content": {
"text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
"places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
"places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
]
}
},
{
"topic": "store",
"content": {
"text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJh64-r0O3j4ARy1P41IH2j3k",
"places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
]
}
}
]
}
},
...
]
}
ज़रूरत के हिसाब से खोज के नतीजों का अनुरोध करना
Text Search (नया) अनुरोध के जवाब में कई जगहों की जानकारी शामिल होती है. ये जगहें, इनपुट सर्च स्ट्रिंग की शर्तों से मेल खाती हैं. अब एपीआई को दी गई इनपुट क्वेरी के आधार पर, रिस्पॉन्स के हिसाब से खोज के डेटा का अनुरोध किया जा सकता है.
कॉन्टेक्स्ट के हिसाब से खास जानकारी दिखाने के लिए, Text Search (नया) से मिले जवाब में contextualContents नाम का नया कलेक्शन मौजूद होगा. जवाब में मौजूद places कलेक्शन के लेवल के बराबर ही होगा:
{
"places": [],
"contextualContents":[]
}
ContextualContent टाइप के contextualContents कलेक्शन में मौजूद हर एलिमेंट, places कलेक्शन में उसी जगह पर है जहां वह अरे की जानकारी में मौजूद है. इसका मतलब है कि contextualContents[0] में मौजूद एलिमेंट, places[0] में मौजूद जगह से जुड़ा है.
कलेक्शन के हर एलिमेंट में ये अरे फ़ील्ड शामिल होते हैं:
contextualContents.reviews: ज़्यादा से ज़्यादा तीन समीक्षाओं की कैटगरी.contextualContents.photos: ज़्यादा से ज़्यादा पांच फ़ोटो की कैटगरी.contextualContents.justifications: जगह के लिए वजहों की कैटगरी. इसमें ये शामिल हैं:reviewJustification: उपयोगकर्ता की समीक्षा के किसी ऐसे सेक्शन को हाइलाइट करें जो असली उपयोगकर्ता की पसंद का हो.businessAvailabilityAttributesJustification: इसमें कारोबार के ऐसे एट्रिब्यूट शामिल होते हैं जिनमें असली उपयोगकर्ता की दिलचस्पी हो सकती है.
जवाब में, कॉन्टेक्स्ट के हिसाब से खोज के नतीजे शामिल करने के लिए, Text Search (नया) अनुरोध के फ़ील्ड मास्क में contextualContents शामिल करें:
curl -X POST -d '{
"textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
"openNow": true,
"maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText
रिस्पॉन्स में, हर जगह के लिए contextualContents कलेक्शन शामिल होता है:
{
"places": [
{
"id": "ChIJETHw0F-7j4AR85V_I6OobCI",
"displayName": {
"text": "Hyderabad Dum Biryani",
"languageCode": "en"
}
},
. . .
],
"contextualContents": [
{
"reviews": [
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
"relativePublishTimeDescription": "a year ago",
"rating": 5,
"text": {
"text": "Very tasty! Rich spices and textures. We really appreciated
all of the vegan options. We shared samosas (great sauce!) , tofu 65
(spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
enjoyed all of it, with the pakoras being the table's favorite.",
"languageCode": "en"
},
"originalText": {
"text": "Very tasty! Rich spices and textures. We really appreciated
all of the vegan options. We shared samosas (great sauce!) , tofu 65
(spicy!!), gobi manchurian (less flavorful but a nice sweet offset
to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
We enjoyed all of it, with the pakoras being the table's favorite.",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Guillaume Riesen",
"uri": "https://www.google.com/maps/contrib/1131462893/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwG_WXt1SjB1rJg=s128-c-c0x00000000-cc-rp-mo-br100"
},
"publishTime": "2023-04-18T02:48:02Z"
},
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSUNKZzlhTG53RRAB",
"relativePublishTimeDescription": "10 months ago",
"rating": 5,
"text": {
"text": "This is a nice little spot to eat at. I'm a big fan of
curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
"languageCode": "en"
},
"originalText": {
"text": "This is a nice little spot to eat at. I'm a big fan of curries,
and they are spot on when it comes to flavor and spice. I highly recommend this place.",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Paul Sacks",
"uri": "https://www.google.com/maps/contrib/1106671734435/reviews",
"photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9sVQ=s128-c-c0x00000000-cc-rp-mo-ba4-br100"
},
"publishTime": "2023-07-03T16:51:49Z"
},
. . .
],
"photos": [
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
"widthPx": 1920,
"heightPx": 1080,
"authorAttributions": [
{
"displayName": "A Google User",
"uri": "//maps.google.com/maps/contrib/113209927655010465422",
"photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgycOLDgOqPRYhzJ0EJlBFyKo9OrmacOo3C5YvrtR4Q=s100-p-k-no-mo"
}
]
},
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9YNzyjkjDMD15gyobIQtIYg1GFPy3BdQHAaA3iNwhk24vK212hZo",
"widthPx": 960,
"heightPx": 720,
"authorAttributions": [
{
"displayName": "Toast"
}
]
},
. . .
],
"justifications": [
{
"reviewJustification": {
"highlightedText": {
"text": "\"Not too spicy or oily.\"",
"highlightedTextRanges": [
{
"startIndex": 9,
"endIndex": 14
}
]
},
"review": {
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
"relativePublishTimeDescription": "10 months ago",
"rating": 5,
"text": {
"text": "Not too spicy or oily. We have the mutton dum biryanis
and tandoori fish. Very flavorful. The food was served promptly.
Clean environment. A little small more like a hole in the wall.
We'd come back for sure.",
"languageCode": "en"
},
"originalText": {
"text": "Not too spicy or oily. We have the mutton dum biryanis
and tandoori fish. Very flavorful. The food was served promptly.
Clean environment. A little small more like a hole in the wall.
We'd come back for sure.",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Harpal Kochar",
"uri": "https://www.google.com/maps/contrib/1166232959/reviews",
"photoUri": "https://lh3.googleusercoEnzB1zdrNbR00000-cc-rp-mo"
},
"publishTime": "2023-06-18T06:12:41Z"
}
}
},
{
"businessAvailabilityAttributesJustification": {
"dineIn": true
}
}
]
},
. . .
]
}
वाहन संबंधित इस्तेमाल के उदाहरणों को लागू करने के लिए दिशा-निर्देश
ड्राइवर की सुरक्षा के लिए, Google का सुझाव है कि वाहन संबंधित अनुभव के लिए, पार्क किए मोड में जनरेटिव एआई से मिली जानकारी को रेंडर करें. अगर ड्राइविंग मोड में जवाब रेंडर किया जा रहा है, तो स्क्रीन पर दी गई जानकारी आसान, साफ़, और कम शब्दों में होनी चाहिए. इससे यह पक्का किया जा सकता है कि ड्राइवर का ध्यान सड़क पर तेज़ी से आए.
- तीन से ज़्यादा लाइन नहीं होनी चाहिए
- 120 वर्ण या 24 शब्द या उससे कम
- सामने का कम से कम साइज़ 24 डीपी
खास तौर पर, वाहन संबंधित मामलों में, यह डेवलपर की ज़िम्मेदारी है कि वह जनरेटिव एआई से मिली खास जानकारी को इस तरह से दिखाए कि वह सुरक्षित हो और सभी स्थानीय नियमों और कानूनों के मुताबिक हो.
एट्रिब्यूशन
अपने ऐप्लिकेशन में समीक्षाएं, फ़ोटो, और जनरेटिव एआई की मदद से मिली खास जानकारी दिखाते समय, आपको यह पक्का करना होगा कि ज़रूरी एट्रिब्यूशन दिखाए जाएं. इसमें जगह और इलाके की खास जानकारी भी शामिल है.
जनरेटिव एआई से जुड़ी खास जानकारी के लिए डिसप्ले एट्रिब्यूशन
अपने ऐप्लिकेशन में जनरेटिव एआई से मिलने वाली खास जानकारी दिखाते समय, आपको ज़रूरी एट्रिब्यूशन भी दिखाने होंगे. इसमें जगह और इलाके की खास जानकारी भी शामिल है. इस सेक्शन में बताया गया है कि अपने ऐप्लिकेशन में जनरेटिव एआई से जुड़ी खास जानकारी दिखाने के आधार पर, एट्रिब्यूशन कैसे दिखाए जाएं.
सभी मामलों में, एट्रिब्यूशन में वाक्य के अक्षरों का इस्तेमाल करना चाहिए. एट्रिब्यूशन और Google लोगो सभी रंग, स्टाइल और टाइपफ़ेस के मानकों के मुताबिक होना चाहिए. इन मानकों के बारे में ज़्यादा जानकारी के लिए, Places API (नया) के लिए नीतियां देखें.
Google के अन्य डेटा के लिए दिखाए जाने वाले जनरेटिव एआई के ज़रिए दिखाई गई खास जानकारी
ऐसे मामले में, जनरेटिव एआई एट्रिब्यूशन को खास जानकारी के ऊपर या नीचे दिखाया जा सकता है. इसके लिए, किसी दूसरी जगह कॉन्टेंट के Google एट्रिब्यूशन का इस्तेमाल किया जाना चाहिए.
एट्रिब्यूशन के लिए, इस इमेज में दिखाए गए तरीके से "एआई की मदद से खास जानकारी" टेक्स्ट का इस्तेमाल करें:
जनरेटिव एआई के ज़रिए दिखाई गई खास जानकारी को अलग से दिखाया गया
जब जनरेटिव एआई वाला कोई जवाब, Google Maps के किसी अन्य कॉन्टेंट के अलावा दिखता है, तो उसमें Google के लिए जनरेटिव एआई एट्रिब्यूशन और एट्रिब्यूशन, दोनों को शामिल किया जाना चाहिए. इन्हें इंटरपंकंट से अलग किया जाना चाहिए. एट्रिब्यूशन के लिए, "एआई की मदद से खास जानकारी" टेक्स्ट और Google के लोगो का इस्तेमाल करें, जैसा कि इस इमेज में दिखाया गया है:
सूची में जनरेटिव एआई के ज़रिए दिखाई गई खास जानकारी को दोहराया गया
जगहों की सूची में जनरेटिव एआई जगह की खास जानकारी की खास जानकारी को दोहराते समय:
- सूची में मौजूद कॉन्टेंट का क्रेडिट Google को दिया गया है
- ये खास जानकारी एआई से जनरेट की गई हैं
- यह कॉन्टेंट, Google पर उपलब्ध है
एट्रिब्यूशन को सूची के ऊपर या नीचे किसी एक लाइन में दिखाया जाना चाहिए. एआई एट्रिब्यूशन की सुविधा बाईं ओर अलाइन है और Google एट्रिब्यूशन मॉडल दाईं ओर अलाइन है:
अगर किसी सूची में लंबे समय तक जनरेटिव एआई ब्यौरे की खास जानकारी का इस्तेमाल किया जाता है, तो हर जवाब में एआई एट्रिब्यूशन होना चाहिए. “एआई से खास जानकारी” देने के लिए, जानकारी वाले आइकॉन/बटन का इस्तेमाल करना होगा.
जनरेटिव एआई के ज़रिए जनरेट की गई खास जानकारी के बारे में जानकारी को डायलॉग बॉक्स में दिखाएं
जनरेटिव एआई से मिलने वाली खास जानकारी के साथ, आपको उपयोगकर्ताओं के लिए एक डायलॉग उपलब्ध कराना होगा. इसमें, खास जानकारी के बारे में जानकारी दिखेगी. साथ ही, समस्याओं की शिकायत करने के लिए एक लिंक भी उपलब्ध कराना होगा. जनरेटिव एआई के ब्यौरे की खास जानकारी का इस्तेमाल करते समय, आपको जवाब के सोर्स की जानकारी शामिल करनी होगी. इस जानकारी को references कहा जाता है.
एआई एट्रिब्यूशन (जैसा कि ऊपर दिए गए उदाहरणों में दिखाया गया है) के साथ जानकारी वाला आइकॉन (इंटरैक्टिविटी के तौर पर) शामिल करके, इस डायलॉग बॉक्स का ऐक्सेस चालू करें. साथ ही, एआई एट्रिब्यूशन एरिया और आइकॉन को किसी प्रेस/क्लिक के हिसाब से बनाएं.
जगह के बारे में जनरेटिव एआई से जानकारी पाने के लिए, यह जानकारी दिखाएं:
| इसके बारे में जानकारी | एआई की मदद से जगह की खास जानकारी, Google समीक्षाओं और अन्य डेटा के आधार पर जनरेट की जाती है. |
| किसी समस्या की रिपोर्ट करें | खास जानकारी के कॉन्टेंट के बारे में Google से किसी समस्या की शिकायत करने के लिए, इस लिंक पर जाएं. |
| रेफ़रंस | स्रोत की समीक्षाएं |
उदाहरण के लिए:
जनरेटिव एरिया से जुड़ी खास जानकारी पाने के लिए, यह जानकारी दिखाएं:
| इसके बारे में जानकारी | Google पर की गई समीक्षाओं और स्थानीय डेटा के आधार पर, एआई (AI) के इस्तेमाल की खास जानकारी जनरेट की जाती है. |
| किसी समस्या की रिपोर्ट करें | खास जानकारी के कॉन्टेंट के बारे में Google से किसी समस्या की शिकायत करने के लिए, इस लिंक पर जाएं. |
