Places API के लिए Gemini मॉडल की सुविधाएं

Places API (नया) के लिए Gemini मॉडल की सुविधाओं की मदद से, Places API में एलएलएम का इस्तेमाल किया जा सकता है. इससे आपको किसी जगह से जुड़ा डेटा (जैसे, कारोबार के खुले होने का समय, समीक्षाएं, फ़ोटो) और एलएलएम से मिले डेटा को वापस करने में मदद मिलती है. इस जनरेटिव डेटा में एलएलएम से इकट्ठा किया गया और खास जानकारी वाला डेटा शामिल होता है. इसका मकसद, किसी जगह से पहले से जुड़े डेटा को बेहतर बनाना है.

उदाहरण के लिए, "ईवी चार्जिंग स्टेशन" के लिए टेक्स्ट सर्च (नया) स्टैंडर्ड तौर पर, ईवी चार्जिंग स्टेशन की जगहों की लिस्ट दिखाता है. अगर आपको आस-पास मौजूद ईवी चार्जर या वाहन के लिए इस्तेमाल होने वाला सबसे नज़दीकी ईवी चार्जर चाहिए, तो आपको इस तरह का रिस्पॉन्स देना ठीक रहेगा.

हालांकि, आपको चार्जिंग स्टेशन के आस-पास के इलाके की भी बेहतर जानकारी चाहिए. खास तौर पर तब, जब आपका वाहन चार्ज होने के एक घंटे या उससे ज़्यादा समय तक वहां जाना हो. एक ही खोज के लिए Gemini मॉडल की सुविधाओं का इस्तेमाल करने पर, जवाब में जवाब में शामिल हर जगह के बारे में डाइनैमिक और जनरेटिव एआई के ज़रिए जानकारी दी जा सकती है. इसमें चार्जिंग स्टेशन के आस-पास की जगह की जानकारी भी शामिल हो सकती है:

• "दो से चार मिनट की पैदल दूरी पर, खान-पान और खरीदारी के कई विकल्प हैं. इनमें शेफ़ चूज़, जेन कोरियन बारबेक्यू हाउस, ऐंबर इंडिया, पैसिफ़िक कैच, और Walmart, Whole Foods Market, और Trader Joe's जैसे किराने की दुकानें शामिल हैं."

• "एक से पांच मिनट की पैदल दूरी पर, खान-पान और खरीदारी के कई विकल्प हैं. इनमें खाओ कांग थाई किचन, रॉजर की डेली ऐंड डोनट्स, और ला कोस्टेनिया शामिल हैं. सुशी के लिए, जॉय सूशी एक अच्छा विकल्प है. किराने के सामान की खरीदारी के लिए, डॉलर ट्री में अलग-अलग तरह के प्रॉडक्ट छूट पर उपलब्ध हैं."

एलएलएम से मिलने वाला यह जनरेटिव कॉन्टेंट, जवाब देने के अनुभव को बेहतर बनाता है और उपयोगकर्ताओं को सोच-समझकर फ़ैसला लेने में मदद करने के लिए ज़्यादा जानकारी देता है.

Places API में, एआई की मदद से काम करने वाली नई सुविधाएं जोड़ी गईं (नई)

ये क्षमताएं, Places API (नए) के रिस्पॉन्स में यह डेटा जोड़ती हैं:

• किसी जगह के बारे में जनरेटिव एआई से जुड़ी खास जानकारी. जगह की खास जानकारी जगह की जानकारी (नया), टेक्स्ट सर्च (नया), और आस-पास की खोज (नया) पर काम करती है.

• जनरेटिव एआई से जुड़ी खास जानकारी, जो किसी जगह के आस-पास की किसी खास जगह के बारे में हो. इलाके की खास जानकारी में जगह की जानकारी (नया), टेक्स्ट सर्च (नया), और आस-पास की खोज (नया) का इस्तेमाल किया जाता है.

• संदर्भ के हिसाब से खोज के नतीजे, Text Search (नए) के साथ काम करते हैं. इनमें किसी जगह से सीधे तौर पर जुड़े डेटा के बजाय, अनुरोध में पास की गई खोज स्ट्रिंग पर आधारित डेटा होता है. इस डेटा से यह समझने में मदद मिलती है कि टेक्स्ट सर्च (नया) रिस्पॉन्स कैसे तय करता है.

जनरेटिव एआई से जुड़ी खास जानकारी

जनरेटिव खास जानकारी, खास तौर पर किसी जगह के आईडी के लिए होती है. जगह की खास जानकारी में कई तरह के डेटा को एक साथ रखा जाता है.

Places API (नया वर्शन), दो तरह की जनरेटिव एआई से जुड़ी खास जानकारी देता है:

• खास जानकारी: औसतन 100 वर्णों में किसी जगह के बारे में खास जानकारी, जिससे उपयोगकर्ताओं को किसी जगह का स्नैपशॉट पाने में मदद मिल सकती है.

• जानकारी का सारांश: किसी जगह के बारे में ज़्यादा से ज़्यादा 400 वर्णों वाली खास जानकारी. इसमें जगह से जुड़ी मुख्य बातों के बारे में पूरी जानकारी दी जाती है.

फ़िलहाल, जगहों की खास जानकारी संस्कृति, मनोरंजन और मनोरंजन, खाना-पीना, खरीदारी, और खेल-कूद कैटगरी के लिए काम करने वाली कैटगरी में दिखाई गई है.

जनरेटिव एआई के ज़रिए खास जानकारी

एलएलएम, किसी जगह के आस-पास के इलाके के लिए, जनरेटिव एआई से खास जानकारी जनरेट करता है. किसी जगह की खास जानकारी में वह सारी जानकारी शामिल हो सकती है जो उपयोगकर्ता को फ़ैसला लेने में मदद करती है. इसमें इलाके की जानकारी देखने के लिए, उपयोगकर्ता को और अनुरोध करने की ज़रूरत नहीं होती.

इस जवाब में इलाके की जानकारी के साथ-साथ, ब्यौरे में बताई गई जगहों के लिए जगह के आईडी की सूची और अलग-अलग कॉन्टेंट के हिसाब से क्रम में लगाई गई जगहों की सूची भी शामिल होती है. उदाहरण के लिए, कॉन्टेंट के एक टाइप में, उस इलाके में होने वाली गतिविधियों से जुड़ी जगहों की सूची होती है और दूसरे कॉन्टेंट टाइप में, उस इलाके के रेस्टोरेंट की सूची होती है.

फ़िलहाल, जगह की खास जानकारी की सुविधा उन जगहों के लिए उपलब्ध है जो ठहरने की जगह कैटगरी के लिए काम करने वाली जगह में दिखाई गई हैं. साथ ही, खास जानकारी electric_vehicle_charging_station, geocode, और premise के लिए भी उपलब्ध है.

जगह और इलाके के बारे में खास जानकारी जनरेट करना

Google, जनरेटिव एआई और जनरेटिव एआई से जुड़ी खास जानकारी, दोनों को ऑफ़लाइन जनरेट करता है. इन खास जानकारी को ऑफ़लाइन जनरेट करके, Gemini की मदद से काम करने वाले कॉन्टेंट का फ़ायदा लिया जा सकता है. साथ ही, आपको Places API (नए) की पहले जैसी परफ़ॉर्मेंस मिलती रहेगी.

Google, खास जानकारी को अक्सर फिर से जनरेट करता है, ताकि यह पक्का किया जा सके कि यह जानकारी, उपलब्ध जानकारी के हिसाब से नई हो. इसका मतलब है कि एपीआई को कॉल करने पर, आपको अपनी सेवा में सबसे नया डेटा दिखेगा.

खोज के हिसाब से नतीजे

टेक्स्ट सर्च (नया) किसी स्ट्रिंग के आधार पर, जगहों की जानकारी दिखाता है — उदाहरण के लिए, "दिल्ली में पिज़्ज़ा" या "ओटावा के आस-पास के जूतों की दुकान". टेक्स्ट से खोजें (नया) जवाब में, टेक्स्ट स्ट्रिंग से मेल खाने वाली जगहों की सूची और अनुरोध में सेट की गई जगह का मापदंड शामिल होता है.

जब जवाब में काम के खोज नतीजे जोड़े जाते हैं, तो जवाब में अब समीक्षाएं, फ़ोटो, और वजहें शामिल होती हैं. इनसे लोगों को सवालों के जवाब पाने में मदद मिलती है:

• मुझे नतीजों में यह जगह क्यों दिख रही है?
• मुझे इस जगह को क्यों चुनना चाहिए?

उदाहरण के लिए, आपने आज ही जगह की जानकारी (नया), टेक्स्ट सर्च (नया) या 'आस-पास खोज' (नया) के लिए अनुरोध किया और उसके जवाब में कोई खास जगह शामिल की. किसी जगह के लिए रिस्पॉन्स डेटा, सभी तीन अनुरोधों के लिए एक ही होता है. इसकी वजह यह है कि वापस भेजा गया डेटा उस जगह से जुड़ा होता है.

हालांकि, नई सुविधाओं का इस्तेमाल करके टेक्स्ट सर्च (नया) के लिए, रिस्पॉन्स में इनपुट क्वेरी स्ट्रिंग से लिया गया डेटा शामिल हो सकता है. इसका मतलब है कि संदर्भ के हिसाब से खोज के नतीजे, क्वेरी स्ट्रिंग के लिए यूनीक होते हैं. उदाहरण के लिए, इस क्वेरी स्ट्रिंग की मदद से टेक्स्ट सर्च (नया) का अनुरोध किया जाता है:

"माउंटेन व्यू, कैलिफ़ोर्निया में शाकाहारी रेस्टोरेंट"

इसके बाद, सभी इनपुट पैरामीटर को एक जैसा छोड़ दिया जाता है और क्वेरी स्ट्रिंग को सिर्फ़ इसमें बदल दिया जाता है:

"माउंटेन व्यू, कैलिफ़ोर्निया में मसालेदार वीगन रेस्टोरेंट"

अगर किसी रेस्टोरेंट के दोनों जवाब में जवाब दिखते हैं, तो उस रेस्टोरेंट की जगह से जुड़ा रिस्पॉन्स डेटा एक ही होगा. इसकी वजह यह है कि यह डेटा किसी जगह से जुड़ा होता है. हालांकि, क्वेरी के हिसाब से खोज के नतीजे यूनीक होते हैं, क्योंकि वे क्वेरी स्ट्रिंग से लिए जाते हैं. इसके बाद, उपयोगकर्ताओं को खोज के हिसाब से मिले नतीजों में मौजूद समीक्षाएं, फ़ोटो, और ज़रूरी बातें दिखाई जा सकती हैं. इससे उन्हें यह तय करने में मदद मिलती है कि उनके खोज अनुरोध के लिए, जवाब में दी गई कौनसी जगह सबसे सही है.

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.overview, generativeSummary.description, और generativeSummary.references फ़ील्ड के साथ-साथ पूरे generativeSummary ऑब्जेक्ट को लौटाने के लिए, places.generativeSummary के फ़ील्ड मास्क का इस्तेमाल किया जाता है:

{
  "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":[]
}

contextualContents कलेक्शन में मौजूद ContextualContent टाइप का हर एलिमेंट, places कलेक्शन में मौजूद जगह के तौर पर, उससे जुड़े कलेक्शन की लोकेशन पर होता है. इसका मतलब है कि contextualContents[0] में मौजूद एलिमेंट, places[0] में मौजूद जगह से जुड़ा है.

अरे के हर एलिमेंट में ये अरे फ़ील्ड होते हैं:

• contextualContents.reviews: ज़्यादा से ज़्यादा तीन समीक्षाओं का कलेक्शन.
• contextualContents.photos: ज़्यादा से ज़्यादा पांच फ़ोटो का कलेक्शन.

• contextualContents.justifications: जगह के लिए वजह का कलेक्शन, जिसमें ये भी शामिल हैं:

  • reviewJustification: उपयोगकर्ता की समीक्षा के ऐसे सेक्शन को हाइलाइट करें जो असली उपयोगकर्ता को पसंद आ सकता है.
  • businessAvailabilityAttributesJustification: इसमें किसी कारोबार की ऐसी विशेषताएं शामिल होती हैं जो असली उपयोगकर्ता को पसंद आ सकती हैं.

जवाब में काम के खोज नतीजे शामिल करने के लिए, टेक्स्ट सर्च (नया) अनुरोध के फ़ील्ड मास्क में 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 या उससे कम शब्द
• सामने का कम से कम 24dp साइज़

खास तौर पर, वाहन संबंधित मामलों में जनरेटिव एआई की खास जानकारी को इस तरह से रेंडर करना डेवलपर की ज़िम्मेदारी है जो सुरक्षित हो और स्थानीय नियमों और कानूनों का पालन करता हो.

एट्रिब्यूशन

अपने ऐप्लिकेशन में समीक्षाएं, फ़ोटो, और जनरेटिव एआई से जुड़ी खास जानकारी दिखाते समय, आपको ज़रूरी एट्रिब्यूशन भी दिखाना होगा. इसमें जगह और इलाके की जानकारी, दोनों शामिल हैं.

जनरेटिव एआई के ज़रिए तैयार की गई खास जानकारी के लिए डिसप्ले एट्रिब्यूशन

अपने ऐप्लिकेशन में जनरेटिव एआई से मिली खास जानकारी दिखाते समय, आपको ज़रूरी एट्रिब्यूशन भी दिखाने चाहिए. इसमें, जगह और इलाके की खास जानकारी भी शामिल है. इस सेक्शन में, ऐप्लिकेशन में जनरेटिव एआई की खास जानकारी दिखाने के तरीके के आधार पर, एट्रिब्यूशन दिखाने का तरीका बताया गया है.

सभी मामलों में, एट्रिब्यूशन को वाक्य के रूप में इस्तेमाल करना चाहिए. एट्रिब्यूशन और Google का लोगो, रंग, स्टाइल, और टाइपफ़ेस के सभी मानकों के मुताबिक होना चाहिए. इन मानकों के बारे में ज़्यादा जानकारी पाने के लिए, Location API (नया) से जुड़ी नीतियां देखें.

जनरेटिव एआई के ज़रिए दिखाई गई खास जानकारी, जिसे Google के अन्य डेटा के हिसाब से दिखाया जाता है

इस मामले में, जनरेटिव एआई एट्रिब्यूशन को जवाब के ऊपर या नीचे दिखाया जा सकता है. ऐसा, कॉन्टेंट के लिए Google एट्रिब्यूशन के आधार पर किया जाएगा.

एट्रिब्यूशन के लिए, "एआई की मदद से तैयार की गई खास जानकारी" टेक्स्ट का इस्तेमाल करें, जैसा कि इस इमेज में दिखाया गया है:

जनरेटिव एआई के ज़रिए दिखाई गई खास जानकारी को अलग से दिखाया गया

जब जनरेटिव एआई की खास जानकारी, Google Maps में मौजूद किसी अन्य कॉन्टेंट की जगह जनरेटिव एआई के ज़रिए दिखती है, तो उसमें जनरेटिव एआई के एट्रिब्यूशन और Google को एट्रिब्यूशन, दोनों की जानकारी शामिल होनी चाहिए. इन्हें इंटरपंक्ट की मदद से अलग करके दिखाया जाना चाहिए. एट्रिब्यूशन के लिए, "एआई की मदद से जनरेट की गई खास जानकारी" टेक्स्ट और Google का लोगो इस्तेमाल करें, जैसा कि इस इमेज में दिखाया गया है:

सूची में जनरेटिव एआई के ज़रिए दिखाई गई खास जानकारी का दोहराव

जनरेटिव एआई के ज़रिए जगह के बारे में खास जानकारी को दोहराने के दौरान, उन जगहों की सूची देखें जहां सभी:

• सूची का कॉन्टेंट Google से जुड़ा है
• खास जानकारी, एआई से जनरेट की गई है
• कॉन्टेंट, Google से उपलब्ध है

एट्रिब्यूशन को सूची के ऊपर या नीचे एक ही लाइन में दिखाया जाना चाहिए. एआई एट्रिब्यूशन बाईं ओर अलाइन है और Google एट्रिब्यूशन दाईं ओर अलाइन है:

अगर किसी सूची में लंबे समय के जनरेटिव एआई के ज़रिए ब्यौरे की खास जानकारी का इस्तेमाल किया जाता है, तो हर जवाब में एआई एट्रिब्यूशन होना चाहिए. इसे जानकारी वाले आइकॉन/बटन के साथ ("एआई से तैयार किया गया" कहें).

जनरेटिव एआई के ज़रिए मिली खास जानकारी के बारे में जानकारी को डायलॉग बॉक्स में दिखाएं

जनरेटिव एआई से मिली खास जानकारी के साथ-साथ, आपको असली उपयोगकर्ताओं को एक डायलॉग बॉक्स भी उपलब्ध कराना होगा. इस डायलॉग बॉक्स में, जवाब की जानकारी देने के साथ-साथ, समस्याओं की शिकायत करने का लिंक भी दिया जाएगा. जनरेटिव एआई के ज़रिए ब्यौरे की खास जानकारी का इस्तेमाल करते समय, आपको जवाब के सोर्स की जानकारी शामिल करनी होगी. इस जानकारी को references कहा जाता है.

इस डायलॉग बॉक्स के ऐक्सेस को चालू करें. इसके लिए, एआई एट्रिब्यूशन के साथ जानकारी आइकॉन (इंटरैक्टिव सुविधा के तौर पर) शामिल करें (जैसा कि ऊपर दिए गए उदाहरणों में दिखाया गया है) और एआई एट्रिब्यूशन एरिया और आइकॉन को एक प्रेस/क्लिक के हिसाब से रिस्पॉन्स देने के लिए सेट करें.

जनरेटिव एआई से जुड़ी खास जानकारी के लिए, यह जानकारी दिखाएं:

इसके बारे में जानकारी	एआई से मिली जगह की खास जानकारी, Google की समीक्षाओं और अन्य डेटा से जनरेट होती है.
किसी समस्या की रिपोर्ट करें	जवाब के कॉन्टेंट के बारे में Google से समस्या की शिकायत करने के लिए, इस लिंक पर जाएं.
रेफ़रंस	सोर्स की समीक्षाएं

उदाहरण के लिए:

जनरेटिव एआई से जुड़ी खास जानकारी के लिए, यह जानकारी दिखाएं:

इसके बारे में जानकारी	एआई से जुड़ी खास जानकारी, Google की समीक्षाओं और स्थानीय डेटा से जनरेट की जाती है.
किसी समस्या की रिपोर्ट करें	जवाब के कॉन्टेंट के बारे में Google से समस्या की शिकायत करने के लिए, इस लिंक पर जाएं.