ग्राउंडिंग लाइट

Google Maps Platform Grounding Lite, मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) के साथ काम करने वाली एक सेवा है. इससे, Google Maps के भरोसेमंद जियोस्पेशल डेटा की मदद से, अपने एआई ऐप्लिकेशन को आसानी से ग्राउंड किया जा सकता है. एमसीपी सर्वर ऐसे टूल उपलब्ध कराता है जिनकी मदद से एलएलएम, जगहों, मौसम, और रास्तों की जानकारी ऐक्सेस कर सकते हैं. एमसीपी सर्वर के साथ काम करने वाले किसी भी टूल में जाकर, Grounding Lite को चालू करके आज़माया जा सकता है.

टूल

Grounding Lite ऐसे टूल उपलब्ध कराता है जिनकी मदद से एलएलएम, Google Maps की इन सुविधाओं को ऐक्सेस कर सकते हैं:

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

  • रास्ते की जानकारी पाना: दो जगहों के बीच कार या पैदल जाने के रास्तों के बारे में जानकारी पाने का अनुरोध करना और रास्ते की दूरी और अवधि की जानकारी पाना.

Maps Grounding Lite MCP सर्वर को चालू करने से, एलएलएम को सर्वर से मिले नए टूल इस्तेमाल करने की अनुमति मिलती है. इससे, ऊपर दिए गए डेटा टाइप के लिए, ज़्यादा जानकारी मिलती है. एलएलएम, इस अतिरिक्त जानकारी का इस्तेमाल कॉन्टेक्स्ट के लिए कर सकता है. हालांकि, एलएलएम से मिले जवाब में, एमसीपी सर्वर से मिली सटीक जानकारी शामिल नहीं हो सकती. आपको जनरेट किए गए जवाब की पुष्टि करनी चाहिए.

Grounding Lite का सैंपल ऐप्लिकेशन आज़माएं (नए टैब में खोलें)

बिलिंग और कोटा

एक्सपेरिमेंटल मोड में Grounding Lite का इस्तेमाल करने के लिए कोई शुल्क नहीं लिया जाता. हालांकि, Grounding Lite की ओर से उपलब्ध कराए गए टूल पर ये कोटा लागू होते हैं:

  • जगहें खोजना: हर प्रोजेक्ट के लिए, हर मिनट में 100 क्वेरी. हर प्रोजेक्ट के लिए,हर दिन 1, 000 क्वेरी.
  • मौसम की जानकारी पाना: हर प्रोजेक्ट के लिए, हर मिनट में 300 क्वेरी.
  • रास्ते का हिसाब लगाएं: हर प्रोजेक्ट के लिए, हर मिनट में 300 क्वेरी.

नीतियां और सेवा की शर्तें

Grounding Lite पर Google Maps Platform की सेवा की शर्तें लागू होती हैं. इनमें इस सेवा के लिए सेवा से जुड़ी खास शर्तें भी शामिल हैं. इस सेक्शन में, Grounding Lite के इस्तेमाल से जुड़ी अन्य ज़रूरी शर्तों के बारे में बताया गया है. इनमें, इस्तेमाल किए जा सकने वाले एलएलएम और सोर्स एट्रिब्यूशन से जुड़ी ज़रूरी शर्तें शामिल हैं.

साथ काम करने वाले एलएलएम के लिए ज़रूरी शर्तें

Grounding Lite का इस्तेमाल सिर्फ़ ऐसे एलएलएम के साथ किया जा सकता है जो Google Maps Platform की सेवा की शर्तों का पालन करता हो.

उदाहरण के लिए, यह पक्का करना आपकी ज़िम्मेदारी है कि Google Maps के कॉन्टेंट को, आपके चुने गए एलएलएम के ज़रिए कैश न किया जाए, सेव न किया जाए या उसका इस्तेमाल एलएलएम को बेहतर बनाने के लिए न किया जाए. Grounding Lite का इस्तेमाल करने से पहले, आपको उस मॉडल की सेवा की शर्तें पढ़नी होंगी जिसका इस्तेमाल आपको Grounding Lite के साथ करना है. आपको Grounding Lite का इस्तेमाल ऐसे किसी भी मॉडल के साथ नहीं करना चाहिए जो मॉडल की ट्रेनिंग या उसे बेहतर बनाने के लिए, मॉडल में डाले गए डेटा का इस्तेमाल करता हो. यह पक्का करना आपकी ज़िम्मेदारी है कि मॉडल का इस्तेमाल, Google Maps Platform की सेवा की शर्तों में दिए गए Google Maps के कॉन्टेंट से जुड़ी पाबंदियों के मुताबिक हो. इसमें सेवा से जुड़ी खास शर्तें भी शामिल हैं.

Google Maps के सोर्स के लिए एट्रिब्यूशन से जुड़ी ज़रूरी शर्तें

Grounding Lite से मिलने वाले हर जवाब में, सोर्स शामिल होते हैं. Grounding Lite की ओर से उपलब्ध कराए गए टूल का इस्तेमाल करके नतीजे दिखाते समय, आपको Google Maps से जुड़े सोर्स को इस तरह शामिल करना होगा कि वे इन ज़रूरी शर्तों को पूरा करते हों:

  • Google Maps के सोर्स, जनरेट किए गए कॉन्टेंट के ठीक बाद होने चाहिए. साथ ही, सोर्स में मौजूद कॉन्टेंट, जनरेट किए गए कॉन्टेंट से मिलता-जुलता होना चाहिए. जनरेट किए गए इस कॉन्टेंट को भरोसेमंद सोर्स से मिला जवाब भी कहा जाता है.
  • Google Maps के सोर्स, उपयोगकर्ता के एक इंटरैक्शन में दिखने चाहिए.

'जगहें खोजें' टूल के लिए सोर्स

search_places टूल के places फ़ील्ड में, summary की पुष्टि करने वाले सोर्स दिए जाते हैं. places के लिए, यह मेटाडेटा दिखता है:

  • place (संसाधन का नाम)
  • id
  • location
  • googleMapsLinks

हर जगह के लिए, आपको लिंक की झलक जनरेट करनी होगी. इसके लिए, इन ज़रूरी शर्तों को पूरा करना होगा:

एलएलएम को एमसीपी सर्वर का इस्तेमाल करने के लिए कॉन्फ़िगर करना

Grounding Lite का इस्तेमाल करने के लिए, आपके पास ऐसा Google Cloud प्रोजेक्ट होना चाहिए जिसमें Maps Grounding Lite API सेवा चालू हो. साथ ही, आपके पास एपीआई कुंजी या OAuth क्लाइंट आईडी होना चाहिए. इसके बाद, एलएलएम को एमसीपी सर्वर ऐक्सेस करने के लिए कॉन्फ़िगर किया जा सकता है. Grounding Lite एमसीपी सर्वर, स्ट्रीम किए जा सकने वाले एचटीटीपी ट्रांसपोर्ट का इस्तेमाल करता है.

अपने Google Cloud प्रोजेक्ट पर Maps Grounding Lite सेवा चालू करें

अपने प्रोजेक्ट में एपीआई चालू करने के लिए:

  1. Google Cloud Console में जाकर, वह प्रोजेक्ट चुनें जिसका इस्तेमाल आपको Grounding Lite के लिए करना है.
  2. Google Cloud Console में जाकर, प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करें.
  3. सबसे ऊपर मौजूद नेविगेशन बार में जाकर, Cloud Shell टर्मिनल खोलें.

  4. सेवा और एमसीपी एंडपॉइंट चालू करने के लिए, ये कमांड चलाएं:

    gcloud beta services enable mapstools.googleapis.com --project=PROJECT_ID
gcloud beta services mcp enable mapstools.googleapis.com --project=PROJECT_ID

एपीआई पासकोड का इस्तेमाल करके पुष्टि करना

Maps Grounding Lite के साथ किसी मौजूदा एपीआई पासकोड का इस्तेमाल किया जा सकता है. इसके अलावा, नया पासकोड भी बनाया जा सकता है. हालांकि, इसके लिए आपको Google Cloud प्रोजेक्ट और पासकोड, दोनों पर Maps Grounding Lite API सेवा चालू करनी होगी.

एपीआई कुंजी का इस्तेमाल करके पुष्टि करने के लिए:

  1. Google Maps Platform का इस्तेमाल शुरू करना में दिए गए चरणों को पूरा करके, एपीआई पासकोड बनाएं या उसे कॉन्फ़िगर करें.
  2. X-Goog-Api-Key हेडर का इस्तेमाल करके, एमसीपी सर्वर को कुंजी पास करें. आपको इसे एलएलएम के एमसीपी टूल कॉन्फ़िगरेशन में, कस्टम एचटीटीपी हेडर के तौर पर सेट करना होगा.
लेख पढ़ें.

OAuth का इस्तेमाल करके पुष्टि करना

OAuth क्रेडेंशियल बनाकर और उन्हें एमसीपी होस्ट या एमसीपी सर्वर ऐप्लिकेशन को पास करके, OAuth का इस्तेमाल करके पुष्टि की जा सकती है.

OAuth का इस्तेमाल करके पुष्टि करने के लिए:

  1. Google Cloud Console में जाकर, वह प्रोजेक्ट चुनें जिसका इस्तेमाल आपको Grounding Lite के लिए करना है.
  2. एपीआई और सेवाएं मेन्यू में जाकर, क्रेडेंशियल को चुनें.
  3. सबसे ऊपर मौजूद मेन्यू में, क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी को चुनें.
  4. अगर प्रोजेक्ट में कॉन्फ़िगर की गई सहमति स्क्रीन नहीं है, तो सहमति स्क्रीन कॉन्फ़िगर करें पर क्लिक करें. इसके बाद, स्क्रीन पर दिए गए निर्देशों का पालन करें.
  5. मेट्रिक सेक्शन में, OAuth क्लाइंट बनाएं पर क्लिक करें.
  6. OAuth क्लाइंट आईडी बनाएं स्क्रीन पर, ऐप्लिकेशन का टाइप चुनें और क्लाइंट आईडी के लिए कोई नाम डालें.
  7. अपने आवेदन के टाइप के हिसाब से, ज़्यादा जानकारी दें. उदाहरण के लिए, अगर कोई वेब ऐप्लिकेशन बनाया जा रहा है, तो ब्राउज़र और सर्वर के अनुरोधों के लिए, अनुमति वाले यूआरआई जोड़ें.
  8. क्लाइंट बन जाने के बाद, क्लाइंट आईडी और सीक्रेट सेव करें.
  9. Grounding Lite को ऐक्सेस करने के लिए, अपने एमसीपी होस्ट या एमसीपी सर्वर ऐप्लिकेशन को कॉन्फ़िगर करते समय, अपना OAuth क्लाइंट आईडी और सीक्रेट पास करें.

ज़्यादा जानकारी के लिए, OAuth 2.0 का इस्तेमाल करके Google API ऐक्सेस करना लेख पढ़ें.

ग्राउंडिंग लाइट एमसीपी सर्वर को ऐक्सेस करने के लिए, एलएलएम कॉन्फ़िगर करना

Maps Grounding Lite API सेवा चालू होने के साथ-साथ मान्य क्रेडेंशियल वाला Google Cloud प्रोजेक्ट होने पर, एलएलएम को MCP सर्वर ऐक्सेस करने के लिए कॉन्फ़िगर किया जा सकता है. इसके लिए, MCP कॉन्फ़िगरेशन से जुड़े दस्तावेज़ में दिए गए निर्देशों का पालन करें. साथ ही, Grounding Lite MCP सर्वर का यह यूआरएल इस्तेमाल करें: https://mapstools.googleapis.com/mcp

ज़्यादा जानकारी के लिए, एआई ऐप्लिकेशन में एमसीपी कॉन्फ़िगर करना लेख पढ़ें.

Gemini CLI की मदद से, Grounding Lite को कॉन्फ़िगर करना

इस सेक्शन में, Gemini CLI का इस्तेमाल करके, Grounding Lite MCP सर्वर को कॉन्फ़िगर करने का उदाहरण दिया गया है. ज़्यादा जानकारी के लिए, Gemini CLI के साथ काम करने वाले एमसीपी सर्वर देखें.

  1. Gemini CLI इंस्टॉल करने के बाद, Maps Grounding Lite MCP सर्वर को कॉन्फ़िगर करने के लिए, add कमांड का इस्तेमाल किया जा सकता है:

    gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp

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

  2. यह पुष्टि करने के लिए कि सर्वर सही तरीके से काम कर रहा है, /mcp list कमांड चलाएं:

    > /mcp list

Configured MCP servers:

maps-grounding-lite-mcp - Ready (3 tools)
Tools:
-   compute_routes
-   lookup_weather
-   search_places

  3. सीएलआई की मदद से, Maps से जुड़े सवाल पूछना शुरू करें. उदाहरण के लिए, "मुझे माउंटेन व्यू के कुछ रेस्टोरेंट सुझाओ" आज़माएं. इससे आपकी ओर से search_places टूल को कॉल किया जाएगा.

सुझाव/राय देना या शिकायत करना

Grounding Lite के बारे में सुझाव/राय देने या शिकायत करने के लिए, इन फ़ॉर्म का इस्तेमाल करें: