Pro एसकेयू के साथ, Maps Experience एजेंट टूल की ज़्यादा सुविधाओं का इस्तेमाल करें! ऐक्सेस पाने के लिए, सेल्स टीम से संपर्क करें.

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

Maps Experience एजेंट के टूल

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

Maps Experience agent tools एक ऐसा प्रॉडक्ट है जिसके दो एसकेयू हैं: Essentials और Pro. हर अनुरोध के लिए Essentials के तहत बिलिंग की जाती है. हालांकि, अगर Pro विकल्प का इस्तेमाल किया जाता है, तो उसके हिसाब से बिलिंग की जाती है. Pro प्लान में, किसी जगह के बारे में ज़्यादा जानकारी, हर खोज के लिए ज़्यादा जगहों के नतीजे, हर रास्ते के लिए ज़्यादा स्टॉप, और लाइव ट्रैफ़िक के साथ रूटिंग की सुविधा मिलती है. सीमित GA के दौरान, Pro के विकल्प सिर्फ़ उन प्रोजेक्ट के लिए उपलब्ध होते हैं जो Pro की अनुमति वाली सूची में शामिल होते हैं. दोनों एसकेयू, एक ही एमसीपी सर्वर, टूल, और क्रेडेंशियल का इस्तेमाल करते हैं. ज़्यादा जानकारी के लिए, Essentials और Pro देखें.

टूल

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

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

ध्यान दें: Maps Experience एजेंट टूल, सिलसिलेवार निर्देश या नेविगेशन की जानकारी नहीं देते. Pro विकल्पों के बिना कंप्यूट किए गए रास्तों में, लाइव ट्रैफ़िक की जानकारी शामिल नहीं होती.
नामों को रिज़ॉल्व करना और Maps के यूआरएल को रिज़ॉल्व करना: जगहों के नाम, पते, और Google Maps के यूआरएल को जगह के आईडी में रिज़ॉल्व करें. ज़्यादा जानकारी के लिए, Resolution API लेख पढ़ें.

एमसीपी सर्वर को चालू करने के बाद, एलएलएम इसके टूल को कॉल कर सकते हैं. इससे इन डेटा टाइप के लिए, ग्राउंडिंग की जानकारी मिल सकती है. एलएलएम, इस जानकारी का इस्तेमाल कॉन्टेक्स्ट के तौर पर कर सकता है. हालांकि, ऐसा हो सकता है कि इसके फ़ाइनल जवाब में वह सटीक जानकारी शामिल न हो जो एमसीपी सर्वर ने दी थी. आपको जनरेट किए गए जवाब की जाँच करनी चाहिए.

Essentials और Pro

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

Essentials, Pro, और Grounding with Google Maps की तुलना करना

Grounding with Google Maps एक अलग प्रॉडक्ट है. यह Gemini API, Google AI Studio, और Gemini Enterprise Agent Platform में Gemini मॉडल के साथ काम करता है. मॉडल यह तय करता है कि Google Maps से कब क्वेरी करनी है. साथ ही, वह उद्धरणों के साथ सटीक जवाब देता है. अगर आपको Gemini का इस्तेमाल करके कोई ऐप्लिकेशन बनाना है और मॉडल से ग्राउंडिंग करानी है, तो Google Maps से जानकारी लेने की सुविधा चुनें. अन्य मॉडल या एजेंट फ़्रेमवर्क के लिए, Maps Experience एजेंट टूल चुनें. इसके अलावा, हर टूल कॉल को सीधे तौर पर कंट्रोल करने के लिए भी इसे चुना जा सकता है.

	Maps Experience एजेंट के टूल		Google Maps से जानकारी लेना
	Essentials SKU (पहले इसका नाम Maps Grounding Lite था)	Pro SKU	Google Maps से जानकारी लेना
अनुरोधों के लिए बिलिंग कैसे की जाती है	टूल के लिए किया गया ऐसा हर अनुरोध जिसमें Pro विकल्प का इस्तेमाल नहीं किया जाता	हर टूल अनुरोध के लिए, Pro विकल्प का इस्तेमाल किया जाता है: `include_extended_details`, 5 से ज़्यादा `page_size`, `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL` या 10 से ज़्यादा इंटरमीडिएट वेपॉइंट	Google Maps की हर क्वेरी या ग्राउंडेड प्रॉम्प्ट, प्लैटफ़ॉर्म और मॉडल के हिसाब से
मॉडल और प्लैटफ़ॉर्म	एमसीपी के साथ काम करने वाला कोई भी मॉडल या एजेंट फ़्रेमवर्क. एक एमसीपी सर्वर, टूल का एक सेट, और दोनों एसकेयू के लिए एक जैसे क्रेडेंशियल		Gemini API, Google AI Studio, और Gemini Enterprise के एजेंट प्लैटफ़ॉर्म में Gemini के मॉडल
टूल से क्या मिलता है	मुख्य जानकारी: हर खोज के लिए ज़्यादा से ज़्यादा पांच जगहों की जानकारी, लाइव ट्रैफ़िक के बिना रास्ते की दूरी और समय, और मौजूदा मौसम और पूर्वानुमान	Essentials प्लान की सभी सुविधाएं. साथ ही, किसी जगह की ज़्यादा जानकारी (जैसे, समीक्षाओं से मिली अहम जानकारी), हर खोज के लिए ज़्यादा से ज़्यादा 10 जगहें, लाइव ट्रैफ़िक की जानकारी के साथ रास्ते, और ज़्यादा से ज़्यादा 25 इंटरमीडिएट वेपॉइंट	समीक्षाओं से जगहों की जानकारी और अहम जानकारी. साथ ही, लाइव ट्रैफ़िक के साथ रास्ते की जानकारी
अनुरोधों के उदाहरण	तथ्यों और लॉजिस्टिक से जुड़े सवाल: स्टोर या कारोबारों को ढूंढना, उनके खुले होने का समय, पते, और दूरी या यात्रा में लगने वाले समय का अनुमान	व्यक्तिगत राय या सामान्य सवाल: माहौल, सिग्नेचर डिश, घूमने आने वाले लोगों के लिए सलाह, 6 से 10 जगहों की तुलना, और मौजूदा ट्रैफ़िक में यात्रा में लगने वाला समय	Gemini में बातचीत वाला टूल, यात्रा की योजना बनाने की सुविधा, और स्थानीय जगहों को खोजने की सुविधा
जगहों की जानकारी देने वाली यूआई किट के विज़ुअलाइज़ेशन	एजेंटिक डेटा विज़ुअलाइज़ेशन टोकन (झलक) के साथ बिना किसी अतिरिक्त शुल्क के उपलब्ध है		अलग से बिल किया गया
हर महीने बिना किसी शुल्क के इस्तेमाल	10,000 अनुरोध	5,000 अनुरोध	यह प्लैटफ़ॉर्म और मॉडल पर निर्भर करता है. उदाहरण के लिए, Gemini API में Gemini 3 और इसके बाद के मॉडल के लिए, हर महीने 5,000 सर्च क्वेरी मुफ़्त में की जा सकती हैं. इसके बाद, हर 1,000 सर्च क्वेरी के लिए 14 डॉलर का शुल्क लिया जाता है.
इस्तेमाल के हिसाब से पैसे चुकाने की सुविधा की कीमत	हर 1,000 अनुरोध के लिए 7 डॉलर.साथ ही, ज़्यादा इस्तेमाल के आधार पर शुल्क में छूट	हर 1,000 अनुरोध के लिए 14.00 डॉलर. ज़्यादा डीएयू पर मिलने वाली छूट के बारे में जानने के लिए, सेल्स टीम से संपर्क करें.
बचत करने के लिए सदस्यता लें	Essentials और Pro प्लान में शामिल है	शामिल नहीं है	उपलब्ध नहीं है
अपनी प्रोफ़ाइल बनाना शुरू करें	दोनों एसकेयू के लिए एक सेटअप: एमसीपी सर्वर का इस्तेमाल करने के लिए एलएलएम कॉन्फ़िगर करना लेख पढ़ें. सीमित GA के दौरान, Pro के विकल्पों के लिए यह भी ज़रूरी है कि प्रोजेक्ट, Pro की अनुमति वाली सूची में शामिल हो.		Gemini API या Agent Platform

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

Pro एसकेयू के तहत किस चीज़ का शुल्क लिया जाता है

टूल	अनुमति	Essentials	Pro
जगहें खोजना	हर अनुरोध के लिए जगहें	5 तक हो सकते हैं	6 से 10 (6 से 10 तक `page_size`)
जगहें खोजना	खोज के नतीजों की खास जानकारी में, किसी जगह के बारे में ज़्यादा जानकारी (समीक्षाओं से मिली अहम जानकारी, मेन्यू की खास बातें, माहौल, किसी जगह पर कितनी भीड़ है, विज़िटर के लिए सलाह, और आस-पास की जगहों के बारे में क्वेरी के लिए दूरी या यात्रा में लगने वाला समय)	उपलब्ध नहीं है	`include_extended_details` के साथ उपलब्ध है
रास्तों का हिसाब लगाना	रूटिंग की प्राथमिकता	लाइव ट्रैफ़िक की जानकारी नहीं मिलती	`ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL` की मदद से, लाइव ट्रैफ़िक या बस, मेट्रो वगैरह के रास्तों के लिए रीयल-टाइम डेटा का हिसाब लगाता है
रास्तों का हिसाब लगाना	हर रास्ते के लिए इंटरमीडिएट वेपॉइंट	ज़्यादा से ज़्यादा 10 सेकंड	11 से 25 (10 से ज़्यादा `intermediate_waypoints`)
Lookup weather और Resolution API	Pro वर्शन के लिए कोई विकल्प नहीं है. सभी अनुरोधों के लिए, Essentials SKU के तहत बिलिंग की जाती है.

हर सुविधा को चालू करने वाले अनुरोध के विकल्पों के लिए, जगहें खोजें और रास्ते कंप्यूट करें देखें.

सीमित उपलब्धता के दौरान Pro के विकल्प

GA की पाबंदी के दौरान, Pro के विकल्प सिर्फ़ उन Google Cloud प्रोजेक्ट के लिए उपलब्ध होते हैं जो Pro की अनुमति वाली सूची में शामिल होते हैं. ऐक्सेस का अनुरोध करने के लिए, सेल्स टीम से संपर्क करें. किसी प्रोजेक्ट को अनुमति वाली सूची में शामिल करने के बाद, उसमें मौजूद हर एपीआई पासकोड और OAuth क्लाइंट, Pro वर्शन के विकल्पों का इस्तेमाल कर सकता है.

अगर आपका प्रोजेक्ट अब तक अनुमति वाली सूची में शामिल नहीं है, तो Pro वर्शन की सुविधाओं का इस्तेमाल करने वाले अनुरोधों को इस तरह मैनेज किया जाता है:

जगहें खोजें: include_extended_details को अनदेखा कर दिया जाता है और जवाब में ज़्यादा से ज़्यादा पांच जगहें शामिल होती हैं. भले ही, आपने page_size को ज़्यादा पर सेट किया हो. अनुरोध के लिए, Essentials एसकेयू के तहत शुल्क लिया जाता है.
रास्ते की जानकारी पाना: ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL को ROUTING_PREFERENCE_TRAFFIC_UNAWARE माना जाता है और अनुरोध के लिए, Essentials एसकेयू के तहत बिल भेजा जाता है. अगर किसी अनुरोध में 10 से ज़्यादा इंटरमीडिएट वेपॉइंट शामिल हैं, तो INVALID_ARGUMENT गड़बड़ी का मैसेज दिखता है.

यह देखने के लिए कि आपका प्रोजेक्ट अनुमति वाली सूची में है या नहीं, search_places का अनुरोध भेजें. इसमें page_size को 10 पर सेट करें. restaurants in Chicago जैसी ब्रॉड क्वेरी का इस्तेमाल करें. अनुमति वाली सूची में शामिल कोई प्रोजेक्ट, पांच से ज़्यादा जगहों की जानकारी दिखा सकता है. इसके लिए, Pro SKU के तहत बिलिंग की जाती है. अन्य प्रोजेक्ट ज़्यादा से ज़्यादा पांच जगहों की जानकारी दिखाते हैं.

Control Pro का इस्तेमाल

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

मॉडल को बताएं कि Pro मॉडल के विकल्प कब सही होते हैं. उदाहरण के लिए: "include_extended_details को सिर्फ़ तब सेट करें, जब उपयोगकर्ता समीक्षाओं, मेन्यू या माहौल के बारे में पूछे." या: "ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL का इस्तेमाल सिर्फ़ तब करें, जब उपयोगकर्ता यात्रा में लगने वाले मौजूदा समय के बारे में पूछे."
किसी एजेंट को Essentials एसकेयू पर बनाए रखने के लिए, मॉडल को निर्देश दें कि वह कभी भी Pro विकल्प का इस्तेमाल न करे. Pro वर्शन में, include_extended_details, page_size, 5 से ज़्यादा, ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, और 10 से ज़्यादा इंटरमीडिएट वेपॉइंट जोड़ने की सुविधा मिलती है. अगर आपका एमसीपी क्लाइंट, टूल के आर्ग्युमेंट पर पाबंदी लगा सकता है, तो टूल के कॉन्फ़िगरेशन में जाकर उन वैल्यू को ब्लॉक भी किया जा सकता है.
बिलिंग रिपोर्ट में, अपने इस्तेमाल पर नज़र रखें और बजट से जुड़ी सूचनाएं सेट करें.

Resolution API

Maps Experience एजेंट टूल, रिज़ॉल्यूशन एपीआई उपलब्ध कराता है. यह जगह की जानकारी के फ़्री-फ़ॉर्म टेक्स्ट और यूआरएल को, Google Maps पर मौजूद जगह के स्ट्रक्चर्ड आइडेंटिफ़ायर में बदलता है. Resolution API, REST मेथड और एमसीपी सर्वर पर टूल के तौर पर उपलब्ध है:

नामों को रिज़ॉल्व करना (REST, MCP): Google Maps पर, जगहों के नामों या पतों के बैच को किसी खास जगह की इकाइयों के साथ रिज़ॉल्व करें. यह सुविधा, उपयोगकर्ता की क्वेरी को जगह के आईडी में बदलने के लिए काम की है.
Maps के यूआरएल रिज़ॉल्व करना (REST, MCP): Google Maps के यूआरएल के बैच को किसी खास जगह की इकाइयों के लिए रिज़ॉल्व करें. इस्तेमाल किए जा सकने वाले फ़ॉर्मैट में, स्टैंडर्ड जगह के यूआरएल और छोटे किए गए यूआरएल शामिल हैं.

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

ज़्यादा जानकारी के लिए, Maps Tools Resolution API देखें.

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

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

बिलिंग का तरीका

Google Maps Platform के इस्तेमाल के हिसाब से पैसे चुकाने के मॉडल के तहत, Maps Experience एजेंट के टूल के इस्तेमाल का हिसाब हर अनुरोध के लिए लगाया जाता है. हर अनुरोध, एक बिलिंग इवेंट को दिखाता है. हर प्रॉडक्ट SKU के लिए, इस्तेमाल को ट्रैक किया जाता है. आपके बिल में, कुल शुल्क के अलावा हर SKU के लिए एक लाइन आइटम दिखता है. ज़्यादा जानकारी के लिए, रिपोर्टिंग की खास जानकारी देखें.

जगहें खोजने, रास्ते का हिसाब लगाने या मौसम की जानकारी देखने के हर अनुरोध के लिए, सिर्फ़ एक SKU के तहत बिल भेजा जाता है. यह SKU, Essentials या Pro हो सकता है. Pro के किसी भी विकल्प का इस्तेमाल करने वाले अनुरोध के लिए, Pro SKU के तहत बिलिंग की जाती है. दोनों एसकेयू के लिए, कभी भी एक साथ बिल नहीं भेजा जाता. साथ ही, Pro के विकल्पों की संख्या से शुल्क पर कोई असर नहीं पड़ता. एसकेयू तय करने के लिए, ये विकल्प उपलब्ध हैं:

टूल	Essentials	Pro
`search_places`	Pro विकल्प के बिना किया गया कोई भी अनुरोध: `page_size` की वैल्यू 5 या इससे कम हो और `include_extended_details` सेट न हो या `false` हो	`include_extended_details` को `true` पर सेट करें या `page_size` को 6 से 10 के बीच सेट करें
`compute_routes`	Pro विकल्प के बिना किया गया कोई भी अनुरोध: `routing_preference` सेट नहीं किया गया या `ROUTING_PREFERENCE_TRAFFIC_UNAWARE`, और यात्रा के किसी भी मोड के साथ 10 या उससे कम इंटरमीडिएट वेपॉइंट	`routing_preference` को `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL` पर सेट किया गया हो या 11 से 25 इंटरमीडिएट वेपॉइंट हों
`lookup_weather`	हर अनुरोध	—

Essentials की कीमत जानने के लिए, Essentials के एसकेयू की जानकारी देखें. Pro वर्शन के लिए, हर महीने शुरुआती 5,000 अनुरोधों के बाद, हर 1,000 अनुरोधों के लिए 14 डॉलर का शुल्क लिया जाता है. ज़्यादा डीएयू पर मिलने वाली छूट के बारे में जानने के लिए, सेल्स टीम से संपर्क करें.

सीमित जीए के दौरान, Pro के विकल्प सिर्फ़ उन प्रोजेक्ट पर लागू होते हैं जो Pro की अनुमति वाली सूची में शामिल हैं. ज़्यादा जानकारी के लिए, सीमित तौर पर उपलब्ध होने के दौरान Gemini Advanced की सुविधाएं देखें.

कीमत की जानकारी के लिए, कीमत की मुख्य टेबल और भारत के लिए कीमत की टेबल देखें.

Places API टेक्स्ट से खोजें Essentials (IDs Only) एसकेयू के तहत, रिज़ॉल्यूशन एपीआई अनुरोधों (ResolveNames और ResolveMapsUrls) के लिए कोई शुल्क नहीं लिया जाता.

Essentials SKU का इस्तेमाल, Essentials और Pro के Subscribe to save पैकेज में भी शामिल है. Pro SKU, 'सदस्यता लें और बचत करें' पैकेज में शामिल नहीं है.

कोटा

Maps Experience एजेंट टूल से मिलने वाले टूल और एपीआई पर, ये कोटा लागू होते हैं:

जगहें खोजना: हर प्रोजेक्ट के लिए, हर मिनट में 300 क्वेरी.
मौसम की जानकारी देखना: हर प्रोजेक्ट के लिए, हर मिनट में 300 क्वेरी.
रास्ते का हिसाब लगाना: हर प्रोजेक्ट के लिए, हर मिनट 300 क्वेरी.
नामों को रिज़ॉल्व करना: हर प्रोजेक्ट के लिए, हर मिनट 600 क्वेरी.
Maps के यूआरएल रिज़ॉल्व करना: हर प्रोजेक्ट के लिए, हर मिनट 600 क्वेरी.

कोटा, हर टूल के हिसाब से गिना जाता है. साथ ही, इसे Essentials और Pro एसकेयू के साथ शेयर किया जाता है. Pro प्लान के तहत किसी टूल से किए गए अनुरोध के लिए, Essentials प्लान के तहत किए गए अनुरोध के बराबर ही कोटा खर्च होता है.

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

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

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

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

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

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

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

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

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

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

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

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

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

Maps Experience एजेंट के टूल के टेक्स्ट एट्रिब्यूशन से जुड़े दिशा-निर्देशों का पालन करते हुए, हर सोर्स का एट्रिब्यूशन Google Maps को दें.
जवाब में मौजूद places.googleMapsLinks.placeUrl का इस्तेमाल करके, सोर्स से लिंक करें.

ये शर्तें, उन खास जानकारी पर भी लागू होती हैं जिनमें Pro से मिली जगह की ज़्यादा जानकारी शामिल होती है. जैसे, समीक्षाओं से मिली अहम जानकारी. summary, हर जगह को शून्य से शुरू होने वाले इंडेक्स के साथ दिखाता है. उदाहरण के लिए, [0], जो places में मौजूद किसी एंट्री पर मैप करता है. हर जगह की जानकारी में googleMapsLinks.reviewsUrl भी शामिल होता है. यह Google Maps पर उस जगह की समीक्षाओं से लिंक करता है. उपयोगकर्ता इस लिंक पर क्लिक करके, अहम जानकारी के पीछे मौजूद समीक्षाएं देख सकते हैं.

वॉइस-फ़र्स्ट इंटरफ़ेस

अगर आपका ऐप्लिकेशन, Maps Experience agent tools के नतीजों को बोलकर सुनाता है, तो आपको वॉइस-फ़र्स्ट इंटरफ़ेस की ज़रूरी शर्तें भी पूरी करनी होंगी. सारांश में:

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

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

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

अपने Google क्लाउड प्रोजेक्ट पर Maps Experience agent tools चालू करें

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

Google Cloud Console में, वह प्रोजेक्ट चुनें जिसका इस्तेमाल आपको Maps Experience एजेंट टूल के लिए करना है.
Google Cloud Console में जाकर, प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करें.
Google Cloud Console API लाइब्रेरी में जाकर, Maps Experience एजेंट टूल चालू करें.

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

Maps Experience एजेंट टूल के साथ, किसी मौजूदा एपीआई पासकोड का इस्तेमाल किया जा सकता है या नया पासकोड बनाया जा सकता है. दोनों ही मामलों में, Google Cloud प्रोजेक्ट और एपीआई पासकोड, दोनों पर Maps Experience agent tools API service को चालू करें.

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

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

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

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

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

Google Cloud Console में, वह प्रोजेक्ट चुनें जिसका इस्तेमाल आपको Maps Experience एजेंट टूल के लिए करना है.
एपीआई और सेवाएं मेन्यू में, क्रेडेंशियल चुनें.
सबसे ऊपर दिए गए मेन्यू में, क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी को चुनें.
अगर प्रोजेक्ट के लिए, सहमति वाली स्क्रीन कॉन्फ़िगर नहीं की गई है, तो सहमति वाली स्क्रीन कॉन्फ़िगर करें पर क्लिक करें. इसके बाद, स्क्रीन पर दिए गए निर्देशों का पालन करें.
मेट्रिक सेक्शन में, OAuth क्लाइंट बनाएं पर क्लिक करें.
OAuth क्लाइंट आईडी बनाएं स्क्रीन पर, ऐप्लिकेशन का टाइप चुनें और क्लाइंट आईडी के लिए कोई नाम डालें.
अपने ऐप्लिकेशन टाइप के हिसाब से, अन्य जानकारी दें. उदाहरण के लिए, अगर कोई वेब ऐप्लिकेशन बनाया जा रहा है, तो ब्राउज़र और सर्वर के अनुरोधों के लिए, अनुमति वाले यूआरआई जोड़ें.
क्लाइंट आईडी बन जाने के बाद, क्लाइंट आईडी और सीक्रेट को सेव करें.
एमसीपी होस्ट या एमसीपी सर्वर ऐप्लिकेशन को कॉन्फ़िगर करते समय, अपना OAuth क्लाइंट आईडी और सीक्रेट पास करें. आपको इस स्कोप के लिए भी अनुरोध करना होगा: https://www.googleapis.com/auth/maps-platform.mapstools.

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

Maps Experience एजेंट टूल के एमसीपी सर्वर को ऐक्सेस करने के लिए, एलएलएम कॉन्फ़िगर करना

Maps Experience agent tools सेवा चालू करने और क्रेडेंशियल बनाने के बाद, एमसीपी सर्वर को ऐक्सेस करने के लिए एलएलएम कॉन्फ़िगर किए जा सकते हैं. अपने एलएलएम के एमसीपी कॉन्फ़िगरेशन से जुड़े दस्तावेज़ में दिए गए निर्देशों का पालन करें और एमसीपी सर्वर के इस यूआरएल का इस्तेमाल करें: https://mapstools.googleapis.com/mcp

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

Gemini CLI की मदद से, Maps Experience एजेंट के टूल कॉन्फ़िगर करना

इस सेक्शन में, Gemini सीएलआई का इस्तेमाल करके, Maps Experience एजेंट टूल के एमसीपी सर्वर को कॉन्फ़िगर करने का उदाहरण दिया गया है. ज़्यादा जानकारी के लिए, Gemini सीएलआई के साथ एमसीपी सर्वर देखें.

Gemini सीएलआई इंस्टॉल करने के बाद, एमसीपी सर्वर को कॉन्फ़िगर करने के लिए gemini mcp add चलाएं:
```
gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-experience-agent-tools-mcp https://mapstools.googleapis.com/mcp
```
अगर कॉन्फ़िगरेशन पूरा हो गया है, तो आपको एक पुष्टि दिखेगी कि सर्वर को आपकी उपयोगकर्ता सेटिंग में जोड़ दिया गया है.

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

> /mcp list

Configured MCP servers:

maps-experience-agent-tools-mcp - Ready (5 tools)
Tools:
-   compute_routes
-   lookup_weather
-   resolve_maps_urls
-   resolve_names
-   search_places

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

Agent Development Kit (ADK) की मदद से, Maps Experience एजेंट के टूल कॉन्फ़िगर करना

इस सेक्शन में, Python, Java या TypeScript में Agent Development Kit (ADK) के साथ एमसीपी सर्वर को कॉन्फ़िगर करने का तरीका बताया गया है.

Python

GitHub पर adk-samples रिपॉज़िटरी में, इस उदाहरण को लागू करने का पूरा तरीका देखा जा सकता है.

पहला चरण: Maps Experience एजेंट टूल के लिए, `McpToolset` की मदद से अपने एजेंट के बारे में जानकारी देना

अपनी agent.py फ़ाइल में बदलाव करें. YOUR_GOOGLE_MAPS_API_KEY को अपने असल एपीआई पासकोड से बदलें.

# ./adk_agent_samples/mcp_agent/agent.py
import os
from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

# Retrieve the API key from an environment variable or directly insert it.
GOOGLE_MAPS_API_KEY = os.getenv("GOOGLE_MAPS_API_KEY")
if not GOOGLE_MAPS_API_KEY:
    GOOGLE_MAPS_API_KEY = "YOUR_GOOGLE_MAPS_API_KEY_HERE"

if GOOGLE_MAPS_API_KEY == "YOUR_GOOGLE_MAPS_API_KEY_HERE":
    print("WARNING: GOOGLE_MAPS_API_KEY is not set.")

root_agent = Agent(
    model='gemini-flash-latest',
    name='travel_planner_agent',
    description='A helpful assistant for planning travel routes.',
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mapstools.googleapis.com/mcp",
                headers={
                    "X-Goog-Api-Key": GOOGLE_MAPS_API_KEY,
                    "Content-Type": "application/json",
                    "Accept": "application/json, text/event-stream"
                }
            )
        )
    ]
)

दूसरा चरण: पक्का करें कि `init.py` मौजूद है

पक्का करें कि आपके पास उसी डायरेक्ट्री में __init__.py है जिसमें आपका agent.py है:

from . import agent

तीसरा चरण: `adk web` को चलाना और उससे इंटरैक्ट करना

एनवायरमेंट वैरिएबल सेट करें:
अपने टर्मिनल में, Google Maps API पासकोड को एनवायरमेंट वैरिएबल के तौर पर सेट करें:
```
export GOOGLE_MAPS_API_KEY="YOUR_ACTUAL_GOOGLE_MAPS_API_KEY"
        
```
adk web चलाएं:
एडीके वेब इंटरफ़ेस शुरू करने के लिए, यह निर्देश चलाएं:
```
adk web
        
```
यूज़र इंटरफ़ेस (यूआई) में इंटरैक्ट करना:
- travel_planner_agent चुनें.
- इस तरह के प्रॉम्प्ट आज़माएं:
  - "मैं कल सैन फ़्रांसिस्को में रहूँगा. मौसम कैसा है?"
  - "गोल्डन गेट पार्क के आस-पास कॉफ़ी शॉप ढूंढो."
  - "GooglePlex से सैन फ़्रांसिस्को एयरपोर्ट तक जाने के लिए निर्देश दिखाओ."

Java

Java में McpToolset को शुरू करने वाला एजेंट तय करें. अगर एनवायरमेंट वैरिएबल का इस्तेमाल नहीं किया जाता है, तो YOUR_GOOGLE_MAPS_API_KEY_HERE को उस एपीआई पासकोड से बदलें जो आपको मिला है.

package agents;

import com.google.adk.agents.LlmAgent;
import com.google.adk.runner.InMemoryRunner;
import com.google.adk.sessions.SessionKey;
import com.google.adk.tools.mcp.McpToolset;
import com.google.adk.tools.mcp.StreamableHttpServerParameters;
import com.google.genai.types.Content;
import com.google.genai.types.Part;
import java.util.HashMap;
import java.util.Map;

public class MapsAgentCreator {
    public static void main(String[] args) {
        String googleMapsApiKey = System.getenv("GOOGLE_MAPS_API_KEY");
        if (googleMapsApiKey == null || googleMapsApiKey.trim().isEmpty()) {
            googleMapsApiKey = "YOUR_GOOGLE_MAPS_API_KEY_HERE";
            if ("YOUR_GOOGLE_MAPS_API_KEY_HERE".equals(googleMapsApiKey)) {
                System.out.println("WARNING: GOOGLE_MAPS_API_KEY is not set.");
            }
        }

        Map<String, String> headers = new HashMap<>();
        headers.put("X-Goog-Api-Key", googleMapsApiKey);
        headers.put("Content-Type", "application/json");
        headers.put("Accept", "application/json, text/event-stream");

        StreamableHttpServerParameters serverParams =
                StreamableHttpServerParameters.builder("https://mapstools.googleapis.com/mcp")
                        .headers(headers)
                        .build();

        try (McpToolset toolset = new McpToolset(serverParams)) {
            LlmAgent agent = LlmAgent.builder()
                    .model("gemini-flash-latest")
                    .name("travel_planner_agent")
                    .description("A helpful assistant for planning travel routes.")
                    .tools(toolset)
                    .build();

            System.out.println("Agent created: " + agent.name());

            InMemoryRunner runner = new InMemoryRunner(agent);
            String userId = "maps-user-" + System.currentTimeMillis();
            String sessionId = "maps-session-" + System.currentTimeMillis();
            String promptText =
                    "Please give me directions to the nearest pharmacy to Madison Square Garden.";

            SessionKey sessionKey = runner.sessionService()
                    .createSession(runner.appName(), userId, null, sessionId)
                    .blockingGet()
                    .sessionKey();
            System.out.println("Session created: " + sessionId + " for user: " + userId);

            Content promptContent = Content.fromParts(Part.fromText(promptText));
            System.out.println("\nSending prompt: \"" + promptText + "\" to agent...\n");

            runner.runAsync(sessionKey, promptContent)
                    .blockingForEach(event -> {
                        System.out.println("Event received: " + event.toJson());
                    });
        } catch (Exception e) {
            System.err.println("An error occurred: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

TypeScript

TypeScript में MCPToolset को शुरू करने वाला एजेंट तय करें:

import 'dotenv/config';
import {LlmAgent, MCPToolset} from "@google/adk";

const googleMapsApiKey = process.env.GOOGLE_MAPS_API_KEY;
if (!googleMapsApiKey) {
    console.warn("WARNING: GOOGLE_MAPS_API_KEY is not set.");
    throw new Error(
        'GOOGLE_MAPS_API_KEY is not provided, please run "export GOOGLE_MAPS_API_KEY=YOUR_ACTUAL_KEY" to add that.'
    );
}

export const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "travel_planner_agent",
    description: "A helpful assistant for planning travel.",
    tools: [
        new MCPToolset({
            type: "SseConnectionParams",
            url: "https://mapstools.googleapis.com/mcp",
            headers: {
                "X-Goog-Api-Key": googleMapsApiKey,
                "Content-Type": "application/json",
                "Accept": "application/json, text/event-stream"
            }
        })
    ],
});

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

Maps Experience एजेंट टूल के बारे में सुझाव/राय देने या शिकायत करने के लिए, इन फ़ॉर्म का इस्तेमाल करें: