MCP Reference: mapstools.googleapis.com

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर, लार्ज लैंग्वेज मॉडल (एलएलएम) या एआई ऐप्लिकेशन को कॉन्टेक्स्ट, डेटा या सुविधाएं देने वाली बाहरी सेवा के बीच प्रॉक्सी के तौर पर काम करता है. MCP सर्वर, एआई ऐप्लिकेशन को डेटाबेस और वेब सेवाओं जैसे बाहरी सिस्टम से कनेक्ट करते हैं. साथ ही, उनके जवाबों को ऐसे फ़ॉर्मैट में बदलते हैं जिसे एआई ऐप्लिकेशन समझ सके.

यह Maps Grounding Lite API की ओर से उपलब्ध कराया गया MCP सर्वर है. यह सर्वर, डेवलपर को Google Maps Platform पर एलएलएम ऐप्लिकेशन बनाने के लिए टूल उपलब्ध कराता है.

सर्वर एंडपॉइंट

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

mapstools.googleapis.com एमसीपी सर्वर का एमसीपी एंडपॉइंट यह है:

• https://mapstools.googleapis.com/mcp

एमसीपी टूल

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

mapstools.googleapis.com एमसीपी सर्वर में ये टूल मौजूद हैं:

एमसीपी टूल
search_places	उपयोगकर्ता की अनुरोध में जगहें, कारोबार, पते, जगहें, दिलचस्पी की जगहें या Google Maps से जुड़ी कोई अन्य खोज करने के लिए कहा गया हो, तो इस टूल को कॉल करें. इनपुट से जुड़ी ज़रूरी शर्तें (अहम): text_query (string - ज़रूरी है): खोज के लिए मुख्य क्वेरी. इसमें साफ़ तौर पर बताया जाना चाहिए कि उपयोगकर्ता क्या ढूंढ रहा है. उदाहरण: 'restaurants in New York', 'coffee shops near Golden Gate Park', 'SF MoMA', '1600 Amphitheatre Pkwy, Mountain View, CA, USA', 'pets friendly parks in Manhattan, New York', 'date night restaurants in Chicago', 'accessible public libraries in Los Angeles'. किसी जगह के बारे में जानकारी पाने के लिए: अनुरोध किए गए एट्रिब्यूट को शामिल करें. जैसे, 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address'). location_bias (object - OPTIONAL): इसका इस्तेमाल, किसी खास भौगोलिक जगह के आस-पास के नतीजों को प्राथमिकता देने के लिए करें. फ़ॉर्मैट: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}} इस्तेमाल: 5 कि॰मी॰ के दायरे में खोज के नतीजों को प्राथमिकता देने के लिए: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}} सेंटर पॉइंट को ज़्यादा प्राथमिकता देने के लिए: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (radius_meters को छोड़कर). language_code (string - OPTIONAL): खोज के नतीजों की खास जानकारी दिखाने के लिए भाषा. फ़ॉर्मैट: दो अक्षरों वाला भाषा कोड (आईएसओ 639-1). इसके बाद, वैकल्पिक तौर पर अंडरस्कोर और दो अक्षरों वाला देश कोड (आईएसओ 3166-1 ऐल्फ़ा-2) हो सकता है. उदाहरण के लिए, en, ja, en_US, zh_CN, es_MX. अगर भाषा कोड नहीं दिया गया है, तो नतीजे अंग्रेज़ी में दिखेंगे. region_code (string - OPTIONAL): उपयोगकर्ता के देश/इलाके का यूनिकोड CLDR कोड. इस पैरामीटर का इस्तेमाल, जगह की जानकारी दिखाने के लिए किया जाता है. जैसे, अगर उपलब्ध हो, तो क्षेत्र के हिसाब से जगह का नाम. लागू होने वाले कानून के आधार पर, पैरामीटर से नतीजों पर असर पड़ सकता है. फ़ॉर्मैट: दो अक्षरों वाला देश का कोड (आईएसओ 3166-1 ऐल्फ़ा-2), जैसे कि US, CA. Instructions for Tool Call: जगह की जानकारी (ज़रूरी): खोज के नतीजों में जगह की पूरी जानकारी होनी चाहिए. अगर जगह की जानकारी साफ़ तौर पर नहीं दी गई है (जैसे, सिर्फ़ "पिज़्ज़ा की दुकानें"), तो आपको इसे text_query में बताना होगा (जैसे, "न्यूयॉर्क में पिज़्ज़ा बेचने वाली जगहें") या location_bias पैरामीटर का इस्तेमाल करें. अगर किसी जगह के बारे में ज़्यादा जानकारी देने की ज़रूरत हो, तो शहर, राज्य/प्रांत, और देश/इलाके का नाम शामिल करें. हमेशा text_query के बारे में ज़्यादा से ज़्यादा जानकारी दें. location_bias का इस्तेमाल सिर्फ़ तब करें, जब निर्देशांक साफ़ तौर पर दिए गए हों या जब उपयोगकर्ता के जाने-पहचाने कॉन्टेक्स्ट से जगह की जानकारी का अनुमान लगाना सही और बेहतर नतीजों के लिए ज़रूरी हो.
lookup_weather	यह ऐप्लिकेशन, किसी भी जगह के मौसम की मौजूदा स्थिति, हर घंटे के हिसाब से मौसम का पूर्वानुमान, और रोज़ाना के मौसम के पूर्वानुमान की जानकारी देता है. मौसम से जुड़ी सभी पूछताछ के लिए, इस टूल का इस्तेमाल करें. उपलब्ध खास डेटा: तापमान (मौजूदा, महसूस होने वाला, ज़्यादा से ज़्यादा/कम से कम, हीट इंडेक्स), हवा (रफ़्तार, झोंके, दिशा), खगोलीय घटनाएं (सूर्योदय/सूर्यास्त, चंद्रमा की कला), बारिश (टाइप, संभावना, मात्रा/क्यूपीएफ़), वायुमंडलीय स्थितियां (यूवी इंडेक्स, नमी, बादल, आंधी की संभावना) और जियोकोड की गई जगह का पता. इनपुट से जुड़ी ज़रूरी शर्तें (अहम): मौसम की मौजूदा स्थिति: इसके लिए सिर्फ़ जगह की जानकारी (जैसे, शहर या पता) की ज़रूरत होती है. तारीख या समय न बताएं. हर घंटे के हिसाब से मौसम का पूर्वानुमान: इसके लिए, जगह की जानकारी और समय (0-23) की ज़रूरत होती है. इसका इस्तेमाल तब करें, जब उपयोगकर्ता किसी खास समय के मौसम के बारे में पूछता है या 'अगले कुछ घंटे' या 'आज बाद में' जैसे शब्दों का इस्तेमाल करता है. रोज़ाना का अनुमान: इसके लिए, जगह की जानकारी और पूरी तारीख की ज़रूरत होती है. तारीख हैंडल करना (ज़रूरी): उपयोगकर्ता से मिली तारीख और समय की जानकारी, अनुरोध की गई जगह के स्थानीय समय क्षेत्र के हिसाब से होनी चाहिए. तारीखों को अलग-अलग पूर्णांक पैरामीटर में बांटा जाना चाहिए: साल, महीना, और दिन. इन पैरामीटर के लिए ज़रूरी फ़ॉर्मैट यह है: {"year": , "month": , "day": }
compute_routes	यह फ़ंक्शन, यात्रा शुरू करने की जगह और मंज़िल के बीच का रास्ता दिखाता है. यात्रा के लिए इस्तेमाल किए जा सकने वाले मोड: DRIVE (डिफ़ॉल्ट), WALK. इनपुट की ज़रूरी शर्तें (अहम): इसके लिए, शुरुआत की जगह और मंज़िल, दोनों की जानकारी देना ज़रूरी है. इनमें से हर एक को, यहां दिए गए किसी एक तरीके का इस्तेमाल करके उपलब्ध कराया जाना चाहिए. साथ ही, इन्हें इनके संबंधित फ़ील्ड में नेस्ट किया जाना चाहिए: address: (string, उदाहरण के लिए, 'आइफ़िल टावर, पैरिस'). ध्यान दें: पता जितना ज़्यादा सटीक होगा, नतीजे उतने ही बेहतर होंगे. lat_lng: (object, {"latitude": number, "longitude": number}) place_id: (string, e.g., 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') ध्यान दें: यह आईडी, search_places टूल से पाया जा सकता है. इनपुट टाइप के किसी भी कॉम्बिनेशन का इस्तेमाल किया जा सकता है. उदाहरण के लिए, पते के हिसाब से मूल जगह और अक्षांश/देशांतर के हिसाब से मंज़िल. अगर ऑरिजिन या डेस्टिनेशन में से कोई एक मौजूद नहीं है, तो टूल को कॉल करने से पहले, आपको उपयोगकर्ता से इस बारे में ज़्यादा जानकारी मांगनी होगी. उदाहरण के लिए, टूल कॉल: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}