MCP Tools Reference: mapstools.googleapis.com

टूल: compute_routes

यह टूल, बताई गई जगह से यात्रा शुरू करने और मंज़िल तक पहुंचने के लिए, रास्ते की जानकारी देता है. यात्रा के इन तरीकों के लिए काम करता है: DRIVE (डिफ़ॉल्ट), WALK.

ज़रूरी इनपुट (अहम जानकारी): इसके लिए, यात्रा शुरू करने की जगह और मंज़िल की जानकारी देना ज़रूरी है. इन दोनों की जानकारी, यहां दिए गए किसी एक तरीके से दी जानी चाहिए. साथ ही, इन्हें अपने-अपने फ़ील्ड में नेस्ट किया जाना चाहिए:

  • address: (स्ट्रिंग, जैसे, 'आइफ़िल टावर, पेरिस'). ध्यान दें: पते की जानकारी जितनी ज़्यादा और सटीक होगी, नतीजे उतने ही बेहतर होंगे.

  • lat_lng: (ऑब्जेक्ट, {"latitude": नंबर, "longitude": नंबर})

  • place_id: (स्ट्रिंग, जैसे, 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') ध्यान दें: यह आईडी, search_places टूल से हासिल किया जा सकता है. इनपुट के टाइप के किसी भी कॉम्बिनेशन का इस्तेमाल किया जा सकता है. जैसे, यात्रा शुरू करने की जगह के लिए पता और मंज़िल के लिए lat_lng. अगर यात्रा शुरू करने की जगह या मंज़िल की जानकारी नहीं दी गई है, तो टूल को कॉल करने से पहले, आपको उपयोगकर्ता से इस बारे में पूछना होगा.

टूल को कॉल करने का उदाहरण: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

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

यहां दिए गए उदाहरण में, compute_routes एमसीपी टूल को कॉल करने के लिए, 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": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

ComputeRoutesRequest.

ComputeRoutesRequest

JSON के काेड में दिखाना 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode)
}
फ़ील्ड
origin

object (Waypoint)

ज़रूरी है. यात्रा शुरू करने की जगह का वेपॉइंट.
destination

object (Waypoint)

ज़रूरी है. मंज़िल का वेपॉइंट.
travelMode

enum (RouteTravelMode)

ज़रूरी नहीं. इससे, परिवहन के साधन के बारे में पता चलता है.

Waypoint

JSON के काेड में दिखाना 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
फ़ील्ड
यूनियन फ़ील्ड location_type. किसी जगह को दिखाने के अलग-अलग तरीके. location_type की वैल्यू, इनमें से कोई एक हो सकती है:
latLng

object (LatLng)

भौगोलिक कोऑर्डिनेट का इस्तेमाल करके तय किया गया पॉइंट.
placeId

string

वेपॉइंट से जुड़ा प्लेस आईडी.
address

string

ऐसा पता या प्लस कोड जिसे कोई भी व्यक्ति आसानी से पढ़ सके. ज़्यादा जानकारी के लिए, https://plus.codes पर जाएं.

LatLng

JSON के काेड में दिखाना 
{
  "latitude": number,
  "longitude": number
}
फ़ील्ड
latitude

number

डिग्री में अक्षांश. यह [-90.0, +90.0] के बीच होना चाहिए.
longitude

number

डिग्री में देशांतर. यह [-180.0, +180.0] के बीच होना चाहिए.

RouteTravelMode

यह वैल्यू का एक सेट है. इसका इस्तेमाल, यात्रा के साधन के बारे में बताने के लिए किया जाता है.

Enums
ROUTE_TRAVEL_MODE_UNSPECIFIED यात्रा के साधन की जानकारी नहीं दी गई है. डिफ़ॉल्ट रूप से, DRIVE को चुना जाता है.
DRIVE पैसेंजर कार से यात्रा करना.
WALK पैदल यात्रा करना. ध्यान दें: WALK के रास्ते, बीटा वर्शन में उपलब्ध हैं. इसलिए, हो सकता है कि इनमें पैदल चलने के लिए साफ़ तौर पर बने रास्ते या फ़ुटपाथ की जानकारी न हो. आपको अपने ऐप्लिकेशन में पैदल चलने के लिए दिखाए जाने वाले हर रास्ते के लिए, उपयोगकर्ता को यह चेतावनी दिखानी होगी.

आउटपुट स्कीमा

ComputeRoutesResponse.

ComputeRoutesResponse

JSON के काेड में दिखाना 
{
  "routes": [
    {
      object (Route)
    }
  ]
}
फ़ील्ड
routes[]

object (Route)

इसमें, यात्रा शुरू करने की जगह और मंज़िल के बीच के रास्ते शामिल होते हैं. फ़िलहाल, सिर्फ़ एक रास्ता दिखाया जाता है.

रास्ता

JSON के काेड में दिखाना 
{
  "distanceMeters": integer,
  "duration": string,
  "attribution": {
    object (Attribution)
  }
}
फ़ील्ड
distanceMeters

integer

रास्ते की दूरी, मीटर में.
duration

string (Duration format)

रास्ते पर नेविगेट करने में लगने वाला समय.

यह समय सेकंड में होता है. इसमें नौ फ़्रैक्शनल डिजिट तक हो सकती हैं. यह 's' से खत्म होता है. उदाहरण: "3.5s".
attribution

object (Attribution)

रास्ते के साथ एट्रिब्यूशन दिखाना ज़रूरी है.

कुल समय

JSON के काेड में दिखाना 
{
  "seconds": string,
  "nanos": integer
}
फ़ील्ड
seconds

string (int64 format)

समय के स्पैन के लिए, साइन किए गए सेकंड. यह -315,576,000,000 से लेकर +315,576,000,000 के बीच होना चाहिए. ध्यान दें: ये बाउंड्री, इस फ़ॉर्मूले से तय की जाती हैं: 60 सेकंड/मिनट * 60 मिनट/घंटा * 24 घंटे/दिन * 365.25 दिन/साल * 10,000 साल
nanos

integer

समय के स्पैन के लिए, नैनोसेकंड रिज़ॉल्यूशन पर, साइन किए गए सेकंड के फ़्रैक्शन. एक सेकंड से कम समय को, 0 seconds फ़ील्ड और पॉज़िटिव या नेगेटिव nanos फ़ील्ड से दिखाया जाता है. एक सेकंड या उससे ज़्यादा समय के लिए, nanos फ़ील्ड की नॉन-ज़ीरो वैल्यू का साइन, seconds फ़ील्ड के साइन जैसा होना चाहिए. यह -999,999,999 से लेकर +999,999,999 के बीच होना चाहिए.

एट्रिब्यूशन

JSON के काेड में दिखाना 
{
  "title": string,
  "url": string
}
फ़ील्ड
title

string

एट्रिब्यूशन के लिए दिखने वाला टाइटल.
url

string

एट्रिब्यूशन के लिए लिंक किया जाने वाला यूआरएल.

टूल के एनोटेशन

डिस्ट्रक्टिव हिंट: ❌ | आइडमपोटेंट हिंट: ❌ | रीड ओनली हिंट: ✅ | ओपन वर्ल्ड हिंट: ❌