MCP Tools Reference: mapstools.googleapis.com

टूल: compute_routes

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

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

  • address: (स्ट्रिंग, जैसे कि 'Eiffel Tower, Paris'). ध्यान दें: पता जितना ज़्यादा सटीक होगा, नतीजे उतने ही बेहतर होंगे.

  • lat_lng: (object, {"latitude": number, "longitude": number})

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

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

  • जवाब में दी गई जानकारी का स्रोत बताना ज़रूरी है. इसके लिए, attribution फ़ील्ड में मौजूद जानकारी का इस्तेमाल किया जाना चाहिए.

यहां दिए गए सैंपल में, curl का इस्तेमाल करके 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)

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

वेपॉइंट

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] की रेंज में होना चाहिए.

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

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

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

टूल एनोटेशन

डेटा में बदलाव करने से जुड़ी जानकारी: ❌ | एक ही कार्रवाई को बार-बार करने से जुड़ी जानकारी: ❌ | सिर्फ़ पढ़ने से जुड़ी जानकारी: ✅ | ओपन वर्ल्ड से जुड़ी जानकारी: ❌