MCP Tools Reference: mapstools.googleapis.com

ابزار: compute_routes

مسیر سفر بین مبدا و مقصد مشخص شده را محاسبه می‌کند. حالت‌های سفر پشتیبانی شده: رانندگی (پیش‌فرض)، پیاده‌روی.

الزامات ورودی (حیاتی): به مبدا و مقصد نیاز دارد. هر کدام باید با استفاده از یکی از روش‌های زیر، که در فیلد مربوطه قرار دارند، ارائه شوند:

  • آدرس: (رشته، مثلاً «برج ایفل، پاریس»). توجه: هرچه آدرس ورودی جزئی‌تر یا خاص‌تر باشد، نتایج بهتر خواهند بود.

  • lat_lng: (شیء، {"عرض جغرافیایی": عدد، "طول جغرافیایی": عدد})

  • place_id: (رشته، مثلاً 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') توجه: این شناسه را می‌توان از ابزار search_places دریافت کرد. هر ترکیبی از انواع ورودی مجاز است (مثلاً مبدأ بر اساس آدرس، مقصد بر اساس lat_lng). اگر مبدأ یا مقصد وجود ندارد، قبل از تلاش برای فراخوانی ابزار، باید از کاربر توضیح بخواهید .

مثال فراخوانی ابزار: {"origin":{"address":"برج ایفل"},"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
}'

طرحواره ورودی

درخواست مسیر محاسباتی.

درخواست مسیر محاسباتی

نمایش 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

طول جغرافیایی بر حسب درجه. باید در محدوده [-۱۸۰.۰، +۱۸۰.۰] باشد.

حالت سفر مسیر

مجموعه‌ای از مقادیر که برای مشخص کردن نحوه سفر استفاده می‌شوند.

انوم‌ها
ROUTE_TRAVEL_MODE_UNSPECIFIED حالت سفر مشخص نشده است. پیش‌فرض روی DRIVE است.
DRIVE سفر با ماشین شخصی.
WALK با پیاده‌روی سفر کنید. توجه: مسیرهای WALK در نسخه بتا هستند و ممکن است گاهی اوقات فاقد پیاده‌روهای خالی یا مسیرهای عابر پیاده باشند. شما باید این هشدار را برای تمام مسیرهای پیاده‌روی که در برنامه خود نمایش می‌دهید، به کاربر نمایش دهید.

طرحواره خروجی

پاسخ مسیرها را محاسبه کنید.

پاسخ‌های ComputeRoutes

نمایش 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

کسرهای علامت‌دار از ثانیه با وضوح نانوثانیه از بازه زمانی. مدت زمان‌های کمتر از یک ثانیه با یک فیلد 0 seconds و یک فیلد nanos مثبت یا منفی نمایش داده می‌شوند. برای مدت زمان‌های یک ثانیه یا بیشتر، مقدار غیر صفر برای فیلد nanos باید با علامت فیلد seconds یکسان باشد. باید از -999,999,999 تا +999,999,999 باشد.

انتساب

نمایش JSON 
{
  "title": string,
  "url": string
}
فیلدها
title

string

عنوانی که برای انتساب نمایش داده می‌شود.

url

string

نشانی اینترنتی (URL) برای پیوند دادن به منبع.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ❌ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌