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

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

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

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

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

  • "खाने-पीने और खरीदारी के लिए कई विकल्प हैं. ये एक से पांच मिनट की पैदल दूरी पर हैं. इनमें Khao Kang Thai Kitchen, Roger's Deli & Donuts, और La Costeña शामिल हैं. सुशी के लिए, Joy Sushi एक अच्छा विकल्प है. किराने के सामान के लिए, Dollar Tree कई तरह के प्रॉडक्ट छूट वाली कीमतों पर उपलब्ध कराता है."

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

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

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

जगह की जनरेटिव खास जानकारी

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

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: यह पांच समीक्षाओं का कलेक्शन होता है. इसका इस्तेमाल, ब्यौरे की खास जानकारी देने के लिए किया जाता है. अगर ब्यौरे की कोई खास जानकारी नहीं है, तो यह कलेक्शन खाली होता है.
  • overviewFlagContentUri: एक लिंक, जहां उपयोगकर्ता, खास जानकारी वाली समरी में किसी समस्या को फ़्लैग कर सकते हैं.
  • descriptionFlagContentUri: ऐसा लिंक जहां उपयोगकर्ता, ब्यौरे की खास जानकारी से जुड़ी समस्या की शिकायत कर सकते हैं.

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

यह उदाहरण, places.generativeSummary के फ़ील्ड मास्क का इस्तेमाल करके, generativeSummary ऑब्जेक्ट को पूरी तरह दिखाता है. इसमें generativeSummary.overview, generativeSummary.description, और generativeSummary.references फ़ील्ड भी शामिल हैं:

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" \
https://places.googleapis.com/v1/places:searchText

जवाब इस फ़ॉर्मैट में है:

{
  "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": "John Smith",
                "uri": "https://www.google.com/maps/contrib/11685942231/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
              "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670"
            },
            . . .
          ]
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12",
        "descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12"
      }
    },
    {
      "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"
        },
        . . .
}

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

टेक्स्ट सर्च के इस उदाहरण में, माउंटेन व्यू, कैलिफ़ोर्निया में मौजूद, मसालेदार और शाकाहारी रेस्टोरेंट की सिर्फ़ 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"
        }
      }
    },
  . . .
}

जनरेटिव एरिया की खास जानकारी का अनुरोध करना

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

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

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

जवाब में इलाके की खास जानकारी शामिल करने के लिए, अनुरोध के फ़ील्ड मास्क में ये शामिल करें:

  • areaSummary (जगह की जानकारी)
  • places.areaSummary (टेक्स्ट से खोजें और आस-पास की जगहों की जानकारी).

जवाब में किसी जगह के लिए दिए गए areaSummary फ़ील्ड में flagContentUri फ़ील्ड होता है. इसका इस्तेमाल, आपत्तिजनक कॉन्टेंट को फ़्लैग करने के लिए किया जा सकता है, ताकि Google उसे हटा सके. इसमें ज़्यादा से ज़्यादा चार 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"
          ]
        }
      }
    ],
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12"
  }
}

किसी होटल के आस-पास के इलाके की खास जानकारी के लिए अनुरोध का उदाहरण

टेक्स्ट सर्च के इस अनुरोध में, माउंटेन व्यू, कैलिफ़ोर्निया में होटलों के बारे में जानकारी मांगी गई है:

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"
              ]
            }
          }
        ],
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12"
      }
    },
    ...
  ]
}

कॉन्टेक्स्ट के हिसाब से खोज के नतीजों का अनुरोध करना

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

संदर्भ के हिसाब से खास जानकारी देने के लिए, टेक्स्ट सर्च (नया) के जवाब में, 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": "Jane Doe",
            "uri": "https://www.google.com/maps/contrib/113193/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB",
          "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": "Bob Jones",
            "uri": "https://www.google.com/maps/contrib/11034435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db"
        },
        . . .
      ],
      "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/113010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db"
        },
        . . .
      ],
      "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": "Stan Davis",
                "uri": "https://www.google.com/maps/contrib/112959/reviews",
                "photoUri": "https://lh3.googleuser-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z",
              "flagContentUri": "https://www.google.com/local/review/rap/report?postt=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

वाहन संबंधित इस्तेमाल के उदाहरणों को लागू करने के लिए दिशा-निर्देश

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

  • ज़्यादा से ज़्यादा तीन लाइनें
  • 120 वर्ण या 24 शब्द या उससे कम
  • फ़्रंट साइज़ कम से कम 24dp होना चाहिए

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

एट्रिब्यूशन

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

जनरेटिव समरी के लिए एट्रिब्यूशन दिखाना

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

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

Google के अन्य डेटा के संदर्भ में जनरेटिव एआई की खास जानकारी

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

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

एट्रिब्यूशन के लिए, एआई की मदद से खास जानकारी देने वाले टेक्स्ट का इस्तेमाल करें.

जनरेटिव एआई की मदद से जनरेट की गई खास जानकारी

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

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

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

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

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

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

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

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

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

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

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

जगह की जनरेटिव खास जानकारी के लिए, ये दिखाएं:

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

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

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

जनरेटिव एआई से तैयार किए गए इलाके की खास जानकारी के लिए, ये दिखाएं:

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

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