MCP Reference: mapstools.googleapis.com

यह एक एमसीपी सर्वर है, जिसे Maps Experience Agent Tools ने उपलब्ध कराया है. यह सर्वर, डेवलपर को Google Maps Platform पर एलएलएम ऐप्लिकेशन बनाने के लिए टूल उपलब्ध कराता है.

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

सर्वर का सेटअप

इस्तेमाल करने से पहले, आपको एमसीपी सर्वर चालू करने और पुष्टि करने की सुविधा सेट अप करने की ज़रूरत होगी. Google और Google Cloud के रिमोट एमसीपी सर्वर इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Google Cloud के एमसीपी सर्वर के बारे में खास जानकारी देखें.

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

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

Maps Experience Agent Tools के एमसीपी सर्वर में, यह ग्लोबल एमसीपी एंडपॉइंट होता है:

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

एमसीपी टूल

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

टूल

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

एमसीपी टूल
search_places

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

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

  1. text_query (स्ट्रिंग - ज़रूरी): मुख्य सर्च क्वेरी. इससे साफ़ तौर पर पता चलना चाहिए कि उपयोगकर्ता क्या खोज रहा है.

    • उदाहरण: '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)]}}}
    • इस्तेमाल:
      • पांच कि॰मी॰ के दायरे में मौजूद जगहों को प्राथमिकता देने के लिए: {"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 (स्ट्रिंग - ज़रूरी नहीं): खोज के नतीजों की खास जानकारी दिखाने के लिए इस्तेमाल की जाने वाली भाषा.

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

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

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

टूल कॉल के लिए निर्देश:

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

  • हमेशा सबसे सटीक और काम की text_query दें.

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

  • उपलब्ध होने पर, attribution फ़ील्ड की जानकारी का इस्तेमाल करके, ग्राउंडेड आउटपुट को सोर्स के साथ एट्रिब्यूट किया जाना चाहिए.
lookup_weather

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

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

जगह और जगह से जुड़े नियम (ज़रूरी):

जिस जगह के मौसम का डेटा चाहिए उसे location फ़ील्ड का इस्तेमाल करके बताया जाता है. यह फ़ील्ड 'oneof' स्ट्रक्चर है. इसका मतलब है कि मौसम के डेटा को सटीक तरीके से देखने के लिए, आपको यहां दिए गए तीन लोकेशन सब-फ़ील्ड में से सिर्फ़ एक के लिए वैल्यू देनी होगी.

  1. भौगोलिक निर्देशांक (lat_lng)

    • इसका इस्तेमाल तब करें, जब आपको सटीक अक्षांश/देशांतर निर्देशांक दिए गए हों.
    • उदाहरण: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // लॉस एंजेलिस

  2. जगह का आईडी (place_id)

    • एक यूनीक स्ट्रिंग आइडेंटिफ़ायर (Google Maps पर जगह का आईडी).
    • place_id को search_places टूल से फ़ेच किया जा सकता है.
    • उदाहरण: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // एफ़िल टावर

  3. पते की स्ट्रिंग (address)

    • यह फ़्री-फ़ॉर्म स्ट्रिंग है. इसमें जियोकोडिंग के लिए, सटीक जानकारी की ज़रूरत होती है.
    • शहर और इलाका: हमेशा इलाका/देश शामिल करें. उदाहरण के लिए, "लंदन" के बजाय "लंदन, यूके" लिखें.
    • मोहल्ले का पता: पूरा पता दें. जैसे, "1600 Pennsylvania Ave NW, Washington, DC".
    • पिन कोड: इसके साथ देश का नाम ज़रूर होना चाहिए. उदाहरण के लिए, "90210, USA", न कि "90210".
    • उदाहरण: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

इस्तेमाल करने के मोड:

  • मौजूदा मौसम: सिर्फ़ location की जानकारी दें. date और hour की वैल्यू न दें.

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

  • रोज़ाना का पूर्वानुमान: location और date की जानकारी दें. hour की वैल्यू न दें. इसका इस्तेमाल, किसी सामान्य दिन के मौसम की जानकारी पाने के लिए करें. जैसे, "कल का मौसम", "शुक्रवार का मौसम", "25 दिसंबर का मौसम". अगर आज की तारीख कॉन्टेक्स्ट में नहीं है, तो आपको उपयोगकर्ता को इसके बारे में साफ़ तौर पर बताना चाहिए. आज की तारीख को मिलाकर, 10 दिनों से ज़्यादा के लिए रोज़ाना का पूर्वानुमान नहीं दिखाया जा सकता. मौसम की पुरानी जानकारी उपलब्ध नहीं है.

पैरामीटर की सीमाएं:

  • टाइम ज़ोन: date और hour के सभी इनपुट, जगह के स्थानीय टाइम ज़ोन के हिसाब से होने चाहिए, न कि उपयोगकर्ता के टाइम ज़ोन के हिसाब से.
  • तारीख का फ़ॉर्मैट: इनपुट को {year, month, day} पूर्णांकों में अलग-अलग किया जाना चाहिए.
  • इकाइयां: डिफ़ॉल्ट रूप से METRIC पर सेट होती हैं. अगर उपयोगकर्ता अमेरिका के स्टैंडर्ड के हिसाब से जानकारी मांगता है या साफ़ तौर पर अनुरोध करता है, तो फ़ैरनहाइट/मील के लिए units_system को IMPERIAL पर सेट करें.

  • उपलब्ध होने पर, attribution फ़ील्ड की जानकारी का इस्तेमाल करके, ग्राउंडेड आउटपुट को सोर्स के साथ एट्रिब्यूट किया जाना चाहिए.
compute_routes

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

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

  1. origin और destination (ऑब्जेक्ट - ज़रूरी): इनमें से हर एक को इनमें से किसी एक का इस्तेमाल करके उपलब्ध कराया जाना चाहिए:

    • address (स्ट्रिंग, जैसे कि 'Eiffel Tower, Paris'). नाम वाली जगहों, लैंडमार्क, और कारोबारों को सीधे तौर पर रिज़ॉल्व किया जाता है. इसलिए, किसी वेपॉइंट को जियोकोड करने के लिए, पहले search_places को कॉल न करें. उपयोगकर्ता ने जिस शहर, इलाके या देश का नाम लिया है उसे शामिल करें.
    • lat_lng (object, {"latitude": number, "longitude": number}).
    • place_id (स्ट्रिंग, जैसे कि 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), उदाहरण के लिए, search_places से.

  2. intermediate_waypoints (ऑब्जेक्ट का कलेक्शन - ज़रूरी नहीं): यात्रा शुरू करने की जगह और मंज़िल के बीच, क्रम से ज़्यादा से ज़्यादा 10 स्टॉप. origin जैसा फ़ॉर्मैट. TRANSIT के साथ काम नहीं करता. सिर्फ़ वे स्टॉप शामिल करें जिनके लिए उपयोगकर्ता ने अनुरोध किया है.

  3. travel_mode (enum - ज़रूरी नहीं): DRIVE (डिफ़ॉल्ट), WALK, BICYCLE या TRANSIT.

  4. समय (ज़रूरी नहीं - ज़्यादा से ज़्यादा एक सेट करें): यूटीसी ऑफ़सेट के साथ आरएफ़सी 3339 टाइमस्टैंप, जैसे कि '2026-09-19T08:00:00-07:00'. डिफ़ॉल्ट रूप से, यह 'अभी रवाना हो रही है' पर सेट होता है. TRANSIT के लिए, समय को पिछले सात दिनों या आने वाले 100 दिनों तक के लिए सेट किया जा सकता है. अन्य मोड के लिए, समय को आने वाले 365 दिनों तक के लिए सेट किया जा सकता है. हालांकि, इसे बीते हुए समय के लिए सेट नहीं किया जा सकता.

    • departure_time: इसका इस्तेमाल तब करें, जब उपयोगकर्ता यह बताए कि वह कब रवाना होगा (उदाहरण के लिए, "कल सुबह 8 बजे").
    • arrival_time: इसका इस्तेमाल तब करें, जब उपयोगकर्ता यह बताए कि उसे कब पहुंचना है. उदाहरण के लिए, "सुबह 9 बजे तक वहां पहुंचना है".

  5. routing_preference (enum - ज़रूरी नहीं है):

    • ROUTING_PREFERENCE_TRAFFIC_UNAWARE (डिफ़ॉल्ट): यह लाइव ट्रैफ़िक, घटनाओं, और बंद सड़कों को अनदेखा करता है. इंतज़ार का समय सबसे कम.
    • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: उपलब्ध होने पर, लाइव ट्रैफ़िक की जानकारी का इस्तेमाल करता है. यह सुविधा WALK या BICYCLE के लिए उपलब्ध नहीं है. इसे सिर्फ़ तब सेट करें, जब उपयोगकर्ता ट्रैफ़िक, भीड़भाड़ या ट्रैफ़िक के हिसाब से ईटीए के बारे में पूछे. इसमें ज़्यादा लागत और इंतज़ार का समय लगता है.

  6. location_bias (ऑब्जेक्ट - ज़रूरी नहीं): {"latitude": number, "longitude": number} इसका इस्तेमाल, वेपॉइंट के पतों में जगहों के नामों को साफ़ तौर पर बताने के लिए किया जाता है. अगर किसी जगह का नाम साफ़ तौर पर नहीं बताया गया है (जैसे, "स्प्रिंगफ़ील्ड") और उपयोगकर्ता ने कोई इलाका नहीं बताया है, तो नाम को address में दिए गए नाम के तौर पर ही रखें. साथ ही, किसी इलाके का अनुमान लगाने के बजाय, location_bias को उस इलाके पर सेट करें जहां आपको जाना है.

  7. compute_alternative_routes (बूलियन - ज़रूरी नहीं): इसे true पर सिर्फ़ तब सेट करें, जब उपयोगकर्ता रास्ते के विकल्प या अन्य रास्ते के बारे में पूछे. डिफ़ॉल्ट रूप से, false पर सेट होता है. इससे सिर्फ़ सुझाया गया रास्ता दिखता है.

  8. include_polyline (बूलियन - ज़रूरी नहीं): इसे true पर सिर्फ़ तब सेट करें, जब रास्ते की ज्यामिति (encoded_polyline) की ज़रूरत हो. डिफ़ॉल्ट रूप से, यह false पर सेट होता है.

टूल कॉल के लिए निर्देश:

  • अगर शुरुआत या मंज़िल की जानकारी मौजूद नहीं है, तो टूल को कॉल करने से पहले, आपको उपयोगकर्ता से साफ़ तौर पर जानकारी मांगनी होगी.
  • "A से B कितनी दूर है?" जैसे सवालों के लिए, B को origin और A को destination के तौर पर इस्तेमाल करें.

टूल कॉल का उदाहरण: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"Louvre Museum"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"}

जवाब देने के लिए निर्देश:

  • जब वैकल्पिक रास्तों का अनुरोध किया जाता है, तो रास्तों को सबसे ज़्यादा से लेकर सबसे कम सुझाए गए क्रम में लगाया जाता है.
  • अगर routes खाली है, तो उपयोगकर्ता को बताएं कि कोई रास्ता नहीं मिला. रास्ते का अनुमान न लगाएं.
  • सिर्फ़ टूल से मिले तथ्यों को बताएं. मोड़-दर-मोड़ निर्देश, बस, मेट्रो वगैरह की लाइनें, स्टेशन, प्लैटफ़ॉर्म या ट्रांसफ़र की जानकारी खुद से न बनाएं.
  • तथ्यों पर आधारित आउटपुट को सोर्स के साथ एट्रिब्यूट किया जाना चाहिए. इसके लिए, हर रूट के attribution फ़ील्ड का इस्तेमाल करें. हालांकि, ऐसा तब ही करें, जब यह फ़ील्ड उपलब्ध हो.
resolve_names

यह एपीआई, किसी खास जगह की क्वेरी (लैंडमार्क के नाम या सटीक पते) की बैच लिस्ट को Google Maps के कैननिकल जगह के आईडी में बदलता है.

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

  1. queries (ऑब्जेक्ट का कलेक्शन - ज़रूरी है): जगह की जानकारी से जुड़ी क्वेरी की सूची, जिन्हें हल करना है. ज़्यादा से ज़्यादा 20 क्वेरी डाली जा सकती हैं.

    • हर क्वेरी ऑब्जेक्ट में ये चीज़ें होनी चाहिए:
      • text (स्ट्रिंग - ज़रूरी है): टेक्स्ट क्वेरी, जिसमें किसी जगह का नाम या पता शामिल होता है.
        • उदाहरण: 'Googleplex, Mountain View, CA', '1600 Amphitheatre Pkwy, Mountain View, CA', 'Eiffel Tower, Paris'.

  2. location_bias (object - OPTIONAL): इसका इस्तेमाल करके, किसी खास भौगोलिक इलाके के आस-पास के नतीजों को प्राथमिकता दी जा सकती है.

    • फ़ॉर्मैट: {"viewport": {"low": {"latitude": [value], "longitude": [value]}, "high": {"latitude": [value], "longitude": [value]}}}

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

टूल कॉल के लिए निर्देश:

  • सटीक जानकारी (ज़रूरी): क्वेरी में किसी जगह का नाम या पता सटीक होना चाहिए. 'restaurants' जैसी सामान्य खोजों या 'Starbucks' जैसे चेन के नामों के लिए यह सुविधा काम नहीं करती.
  • अगर आपको जिन डाउनस्ट्रीम टूल को कॉल करना है वे पहले से ही रॉ पते या जगह के नाम की स्ट्रिंग को सीधे तौर पर स्वीकार करते हैं, तो इस टूल को कॉल न करें.

Google Maps में सेव करना:

  • जवाब में save_to_maps_url फ़ील्ड शामिल होता है: Google Maps का एक लिंक, जिसमें उन सभी जगहों की जानकारी होती है जिन्हें सही तरीके से रिज़ॉल्व किया गया है.
  • जब उपयोगकर्ता, Google Maps में जगहों की सूची को सेव, शेयर या खोलना चाहे, तो उसे यह लिंक दिखाएं. इस लिंक को खुद न बनाएं.

गड़बड़ी ठीक करना (ज़रूरी):

  • यह एक बैच प्रोसेसिंग टूल है. किसी अनुरोध के जवाब में "मिले-जुले नतीजे" मिल सकते हैं. उदाहरण के लिए, कुछ क्वेरी का जवाब मिल सकता है, जबकि कुछ का नहीं.
  • results की आउटपुट सूची, इनपुट queries इंडेक्स के साथ 1:1 मैप करने की गारंटी देती है. क्वेरी पूरी न होने पर, results सूची में उसके इंडेक्स पर, खाली Result मैसेज दिखेगा. साथ ही, कोई entity सेट नहीं होगा.
  • आपको रिस्पॉन्स में failed_requests मैप फ़ील्ड की जांच ज़रूर करनी चाहिए, ताकि यह पता चल सके कि किस क्वेरी इंडेक्स में गड़बड़ी हुई है. failed_requests की कुंजी, अनुरोध में मौजूद उस क्वेरी के 0-आधारित इंडेक्स को दिखाती है जो पूरी नहीं हो सकी. यह न मानें कि कुछ गड़बड़ियों की वजह से पूरा बैच कॉल फ़ेल हो गया है.
resolve_maps_urls

यह Google Maps के यूआरएल की सूची को Google Maps के कैननिकल जगह के आईडी में बदलता है.

इस टूल को कब कॉल करना चाहिए (अहम जानकारी):

  • इस टूल का इस्तेमाल तब करें, जब उपयोगकर्ता Google Maps पर शेयर किए गए एक या उससे ज़्यादा लिंक या यूआरएल उपलब्ध कराता है. जैसे, 'https://maps.app.goo.gl/...', 'https://www.google.com/maps/place/...' या 'https://maps.google.com/...') और आपको कैननिकल जगह का आईडी निकालने हैं.
  • एक ही बैच अनुरोध में, ज़्यादा से ज़्यादा 20 यूआरएल की समस्या हल की जा सकती है.

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

  • urls (स्ट्रिंग का कलेक्शन - ज़रूरी): Google Maps के उन यूआरएल की सूची जिन्हें रिज़ॉल्व करना है. हर यूआरएल, Google Maps का एक मान्य यूआरएल होना चाहिए. साथ ही, वह किसी एक जगह का होना चाहिए.

Google Maps में सेव करना:

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

गड़बड़ी ठीक करना (ज़रूरी):

  • यह एक बैच प्रोसेसिंग टूल है. किसी अनुरोध के "मिले-जुले नतीजे" मिल सकते हैं. उदाहरण के लिए, कुछ यूआरएल को सही तरीके से रिज़ॉल्व किया जा सकता है, जबकि कुछ को नहीं.
  • entities की आउटपुट सूची, इनपुट urls इंडेक्स के साथ 1:1 मैप करने की गारंटी देती है. यूआरएल रिज़ॉल्यूशन पूरा न होने पर, entities सूची में मौजूद इंडेक्स पर, Entity मैसेज खाली रहेगा. इसका मतलब है कि कोई भी फ़ील्ड सेट नहीं किया गया है.
  • आपको रिस्पॉन्स में failed_requests मैप फ़ील्ड की जांच ज़रूर करनी चाहिए, ताकि यह पता चल सके कि किस यूआरएल को इंडेक्स नहीं किया जा सका. failed_requests की कुंजी, अनुरोध में मौजूद उस यूआरएल के 0-आधारित इंडेक्स को दिखाती है जिसे प्रोसेस नहीं किया जा सका. यह न मानें कि कुछ गड़बड़ियों की वजह से पूरा बैच कॉल फ़ेल हो गया है.

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

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

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
}'