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

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

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

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

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

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

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

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

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

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

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

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

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

  • जानकारी का सारांश: औसतन किसी जगह की ज़्यादा जानकारी करीब 400 वर्ण में, जिसमें वेब पेज के सबसे ऊपर के हिस्से के बारे में पूरी जानकारी दी जाती है जानकारी मिलती है.

वर्तमान में स्थान के सारांश समर्थित स्थान प्रकारों के लिए उपलब्ध हैं कैटगरी के लिए टाइप संस्कृति, मनोरंजन और मनोरंजन, खाना-पीना, खरीदारी, और खेल-कूद.

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

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

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

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

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

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

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

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

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

जवाब के साथ खोज के मिलते-जुलते नतीजे जोड़ने पर, वह जवाब अभी उनमें ऐसी समीक्षाएं, फ़ोटो, और वजह बताई गई हों जिनसे उपयोगकर्ताओं को सवाल:

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

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

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

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

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

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

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

Places API के लिए Gemini मॉडल की सुविधाएँ चालू करें (नई सुविधा)

Gemini मॉडल की सुविधाओं का इस्तेमाल करने के लिए, आपको Places API (नया वर्शन) को चालू करना होगा 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"
        }
      }
    },
  . . .
}

खास जानकारी और खास जानकारी के अनुरोध का उदाहरण

यह उदाहरण ठीक वैसी ही क्वेरी बनाता है जैसा पिछले उदाहरण में दिखाया गया है, लेकिन पूरा रिटर्न दिखाने के लिए places.generativeSummary का फ़ील्ड मास्क 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"
              ]
            }
          }
        ]
      }
    },
    ...
  ]
}

काम के खोज नतीजों के लिए अनुरोध करना

इसके लिए जवाब टेक्स्ट खोज (नई सुविधा) अनुरोध में ऐसी जगहों का कलेक्शन है जो इनपुट खोज की शर्तों से मेल खाते हैं स्ट्रिंग. अब आप एपीआई में क्वेरी डालें.

कॉन्टेक्स्ट के हिसाब से जवाब देने के लिए, टेक्स्ट खोज (नई सुविधा) इसमें 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 लोगो सभी रंग, शैली और टाइपफ़ेस के मानकों के मुताबिक होना चाहिए. ज़्यादा के लिए इन मानकों की जानकारी मिलेगी, तो Places API (नया) के लिए नीतियां.

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

इस मामले में, जनरेटिव एआई एट्रिब्यूशन को ऊपर या नीचे जवाब के नीचे, कॉन्टेंट के लिए Google एट्रिब्यूशन पर भरोसा करना.

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

एट्रिब्यूशन के लिए, एआई से तैयार किए गए टेक्स्ट का इस्तेमाल करें.

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

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

अलग से दिखाई गई खास जानकारी के लिए, जनरेटिव एआई एट्रिब्यूशन को शामिल करें और
  Google एट्रिब्यूशन को इंटरपंक्ट से अलग किया गया.

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

बार-बार जनरेटिव एआई का इस्तेमाल करते समय जगह की जानकारी की खास जानकारी के साथ, जहां सभी:

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

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

किसी सूची के लिए, एट्रिब्यूशन को सूची के ऊपर या नीचे एक ही लाइन में दिखाएं.

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

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

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

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

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

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

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

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

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

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

डिसप्ले एरिया की खास जानकारी का एट्रिब्यूशन.