MCP Tools Reference: mapstools.googleapis.com

एमसीपी टूल का रेफ़रंस:

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

एमसीएम टूल की खास जानकारी पाना

किसी एमसीपी सर्वर में मौजूद सभी टूल के लिए, एमसीपी टूल की खास जानकारी पाने के लिए, `tools/list` तरीके का इस्तेमाल करें. इस उदाहरण में, curl का इस्तेमाल करके, MCP सर्वर में फ़िलहाल उपलब्ध सभी टूल और उनकी खास बातों की सूची बनाने का तरीका बताया गया है.

Curl अनुरोध 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'

टूल: search_places

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

इनपुट से जुड़ी ज़रूरी शर्तें (अहम):

  1. 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').

  2. 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 को छोड़कर).

  3. language_code (string - OPTIONAL): खोज के नतीजों की खास जानकारी दिखाने के लिए भाषा.

    • फ़ॉर्मैट: दो अक्षरों वाला भाषा कोड (आईएसओ 639-1). इसके बाद, वैकल्पिक तौर पर अंडरस्कोर और दो अक्षरों वाला देश कोड (आईएसओ 3166-1 ऐल्फ़ा-2) हो सकता है. उदाहरण के लिए, en, ja, en_US, zh_CN, es_MX. अगर भाषा कोड नहीं दिया गया है, तो नतीजे अंग्रेज़ी में दिखेंगे.

  4. region_code (string - OPTIONAL): उपयोगकर्ता के देश/इलाके का यूनिकोड CLDR कोड. इस पैरामीटर का इस्तेमाल, जगह की जानकारी दिखाने के लिए किया जाता है. जैसे, अगर उपलब्ध हो, तो क्षेत्र के हिसाब से जगह का नाम. लागू होने वाले कानून के आधार पर, पैरामीटर से नतीजों पर असर पड़ सकता है.

    • फ़ॉर्मैट: दो अक्षरों वाला देश का कोड (आईएसओ 3166-1 ऐल्फ़ा-2), जैसे कि US, CA.

Instructions for Tool Call:

  • जगह की जानकारी (ज़रूरी): खोज के नतीजों में जगह की पूरी जानकारी होनी चाहिए. अगर जगह की जानकारी साफ़ तौर पर नहीं दी गई है (जैसे, सिर्फ़ "पिज़्ज़ा की दुकानें"), तो आपको इसे text_query में बताना होगा (जैसे, "न्यूयॉर्क में पिज़्ज़ा बेचने वाली जगहें") या location_bias पैरामीटर का इस्तेमाल करें. अगर किसी जगह के बारे में ज़्यादा जानकारी देने की ज़रूरत हो, तो शहर, राज्य/प्रांत, और देश/इलाके का नाम शामिल करें.

  • हमेशा text_query के बारे में ज़्यादा से ज़्यादा जानकारी दें.

  • location_bias का इस्तेमाल सिर्फ़ तब करें, जब निर्देशांक साफ़ तौर पर दिए गए हों या जब उपयोगकर्ता के जाने-पहचाने कॉन्टेक्स्ट से जगह की जानकारी का अनुमान लगाना सही और बेहतर नतीजों के लिए ज़रूरी हो.

यहां दिए गए उदाहरणों में, search_places MCP टूल को चालू करने के लिए curl का इस्तेमाल करने का तरीका बताया गया है.

Curl अनुरोध 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": search_places,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Tool: lookup_weather

यह ऐप्लिकेशन, किसी भी जगह के मौसम की मौजूदा स्थिति, हर घंटे के हिसाब से मौसम का पूर्वानुमान, और रोज़ाना के मौसम के पूर्वानुमान की जानकारी देता है. मौसम से जुड़ी सभी पूछताछ के लिए, इस टूल का इस्तेमाल करें.

उपलब्ध खास डेटा: तापमान (मौजूदा, महसूस होने वाला, ज़्यादा से ज़्यादा/कम से कम, हीट इंडेक्स), हवा (रफ़्तार, झोंके, दिशा), खगोलीय घटनाएं (सूर्योदय/सूर्यास्त, चंद्रमा की कला), बारिश (टाइप, संभावना, मात्रा/क्यूपीएफ़), वायुमंडलीय स्थितियां (यूवी इंडेक्स, नमी, बादल, आंधी की संभावना) और जियोकोड की गई जगह का पता.

इनपुट से जुड़ी ज़रूरी शर्तें (अहम):

  • मौसम की मौजूदा स्थिति: इसके लिए सिर्फ़ जगह की जानकारी (जैसे, शहर या पता) की ज़रूरत होती है. तारीख या समय न बताएं.

  • हर घंटे के हिसाब से मौसम का पूर्वानुमान: इसके लिए, जगह की जानकारी और समय (0-23) की ज़रूरत होती है. इसका इस्तेमाल तब करें, जब उपयोगकर्ता किसी खास समय के मौसम के बारे में पूछता है या 'अगले कुछ घंटे' या 'आज बाद में' जैसे शब्दों का इस्तेमाल करता है.

  • रोज़ाना का अनुमान: इसके लिए, जगह की जानकारी और पूरी तारीख की ज़रूरत होती है.

तारीख हैंडल करना (ज़रूरी): उपयोगकर्ता से मिली तारीख और समय की जानकारी, अनुरोध की गई जगह के स्थानीय समय क्षेत्र के हिसाब से होनी चाहिए. तारीखों को अलग-अलग पूर्णांक पैरामीटर में बांटा जाना चाहिए: साल, महीना, और दिन. इन पैरामीटर के लिए ज़रूरी फ़ॉर्मैट यह है: {"year": , "month": , "day": }

यहां दिए गए सैंपल में, lookup_weather MCP टूल को चालू करने के लिए curl का इस्तेमाल करने का तरीका बताया गया है.

Curl अनुरोध 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": lookup_weather,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

टूल: 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"}

नीचे दिए गए उदाहरणों में, compute_routes एमसीपी टूल को शुरू करने के लिए curl का इस्तेमाल करने का तरीका बताया गया है.

Curl अनुरोध 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": compute_routes,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'