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

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

टूल

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

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

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

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

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

एक्सपेरिमेंटल मोड में 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 का इस्तेमाल करने के लिए, आपके पास Maps Grounding Lite API सेवा चालू करने वाला एपीआई पासकोड होना चाहिए. इसके बाद, एलएलएम को एमसीपी सर्वर ऐक्सेस करने के लिए कॉन्फ़िगर किया जा सकता है. Grounding Lite MCP सर्वर, स्ट्रीम किए जा सकने वाले एचटीटीपी ट्रांसपोर्ट का इस्तेमाल करता है.

एपीआई पासकोड बनाना या कॉन्फ़िगर करना

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

एपीआई चालू करने के लिए:

  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

  5. एपीआई पासकोड बनाने या कॉन्फ़िगर करने के लिए, Google Maps Platform का इस्तेमाल शुरू करना में दिया गया तरीका अपनाएं.

लेख पढ़ें.

एपीआई पासकोड को MCP सर्वर पर, हेडर X-Goog-Api-Key का इस्तेमाल करके भेजा जाना चाहिए. आपको इसे एलएलएम के एमसीपी टूल कॉन्फ़िगरेशन में, कस्टम एचटीटीपी हेडर के तौर पर सेट करना होगा.

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

Maps Grounding Lite API सेवा चालू होने पर, आपको एक एपीआई पासकोड मिलेगा. इसके बाद, एलएलएम को 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 के बारे में सुझाव/राय देने या शिकायत करने के लिए, इन फ़ॉर्म का इस्तेमाल करें: