MCP Tools Reference: mapstools.googleapis.com

টুল: compute_routes

নির্দিষ্ট উৎস এবং গন্তব্যের মধ্যে একটি ভ্রমণ পথ গণনা করে। সমর্থিত ভ্রমণ মোড: ড্রাইভ (ডিফল্ট), ওয়াক।

প্রয়োজনীয় তথ্য (অত্যাবশ্যক): উৎস এবং গন্তব্য উভয়ই আবশ্যক। প্রত্যেকটি অবশ্যই নিম্নলিখিত পদ্ধতিগুলোর যেকোনো একটি ব্যবহার করে, নিজ নিজ ফিল্ডের মধ্যে অন্তর্ভুক্ত করে প্রদান করতে হবে:

  • ঠিকানা: (স্ট্রিং, যেমন, 'আইফেল টাওয়ার, প্যারিস')। দ্রষ্টব্য: ইনপুট ঠিকানা যত বেশি সুনির্দিষ্ট বা বিস্তারিত হবে, ফলাফল তত ভালো হবে।

  • 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 MCP টুলটি চালু করতে হয়।

কার্ল অনুরোধ 
                  
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 দেখুন।

অক্ষাংশ দ্রাঘিমাংশ

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)

সময়কালের স্বাক্ষরিত সেকেন্ড। অবশ্যই -৩১৫,৫৭৬,০০০,০০০ থেকে +৩১৫,৫৭৬,০০০,০০০ পর্যন্ত হতে হবে (উভয় সংখ্যাসহ)। দ্রষ্টব্য: এই সীমাগুলো নিম্নলিখিত সূত্র থেকে গণনা করা হয়েছে: ৬০ সেকেন্ড/মিনিট * ৬০ মিনিট/ঘণ্টা * ২৪ ঘণ্টা/দিন * ৩৬৫.২৫ দিন/বছর * ১০০০০ বছর

nanos

integer

ন্যানোসেকেন্ড রেজোলিউশনে সময়কালের চিহ্নযুক্ত ভগ্নাংশ। এক সেকেন্ডের কম সময়কালকে একটি ০ seconds ফিল্ড এবং একটি ধনাত্মক বা ঋণাত্মক nanos ফিল্ড দ্বারা প্রকাশ করা হয়। এক সেকেন্ড বা তার বেশি সময়কালের জন্য, nanos ফিল্ডের অশূন্য মানটির চিহ্ন অবশ্যই seconds ফিল্ডের চিহ্নের সমান হতে হবে। এর মান অবশ্যই -৯৯৯,৯৯৯,৯৯৯ থেকে +৯৯৯,৯৯৯,৯৯৯ (উভয় সংখ্যাসহ) এর মধ্যে হতে হবে।

অ্যাট্রিবিউশন

JSON উপস্থাপনা 
{
  "title": string,
  "url": string
}
ক্ষেত্র
title

string

কৃতিত্ব প্রদানের জন্য প্রদর্শিত শিরোনাম।

url

string

অ্যাট্রিবিউশনের জন্য লিঙ্ক করার ইউআরএল।

টুল টীকা

ধ্বংসাত্মক ইঙ্গিত: ❌ | স্ব-সূচক ইঙ্গিত: ❌ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ✅ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌