MCP Tools Reference: mapstools.googleapis.com

الأداة: compute_routes

تحسب هذه الطريقة مسارًا للسفر بين نقطة انطلاق ووجهة محدّدتين. أوضاع السفر المتاحة: القيادة (الوضع التلقائي) والمشي

متطلبات الإدخال (مهمة): تتطلّب كلّاً من المصدر والوجهة. يجب تقديم كلّ منها باستخدام إحدى الطرق التالية، مع تضمينها في الحقل الخاص بها:

  • ‫address: (سلسلة، مثل "برج إيفل، باريس"). ملاحظة: كلما كان العنوان المدخَل أكثر تفصيلاً أو تحديدًا، كانت النتائج أفضل.

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

  • place_id: (سلسلة، مثل ‫'ChIJOwE_Id1w5EAR4Q27FkL6T_0') ملاحظة: يمكن الحصول على هذا المعرّف من أداة search_places. يُسمح بأي تركيبة من أنواع الإدخال (مثل المصدر حسب العنوان والوجهة حسب lat_lng). في حال عدم توفّر المصدر أو الوجهة، يجب أن تطلب من المستخدم توضيحًا قبل محاولة طلب الأداة.

مثال على استدعاء أداة: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة compute_routes MCP.

Curl Request 
                  
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 (google.type.LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
الحقول
حقل الدمج location_type طرق مختلفة لتمثيل موقع جغرافي يمكن أن تكون location_type إحدى القيم التالية فقط:
latLng

object (google.type.LatLng)

نقطة محدّدة باستخدام الإحداثيات الجغرافية
placeId

string

تمثّل هذه السمة معرّف المكان المرتبط بنقطة الطريق.
address

string

عنوان يمكن لشخص عادي قراءته أو رمز Plus Codes لمزيد من التفاصيل، يُرجى الانتقال إلى 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
}
الحقول
distanceMeters

integer

تمثّل هذه السمة مسافة السفر للمسار، بالأمتار.
duration

string (Duration format)

هي المدة الزمنية اللازمة للتنقّل في المسار.

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"

المدة

تمثيل JSON 
{
  "seconds": string,
  "nanos": integer
}
الحقول
seconds

string (int64 format)

ثوانٍ موقّعة من الفترة الزمنية. يجب أن تتراوح القيمة بين ‎-315,576,000,000 و‎+315,576,000,000، بما في ذلك الرقمان. ملاحظة: يتم احتساب هذه الحدود من خلال: 60 ثانية/دقيقة * 60 دقيقة/ساعة * 24 ساعة/يوم * 365.25 يوم/سنة * 10000 سنة
nanos

integer

أجزاء من الثانية موقّعة بدقة النانو ثانية لمدة الفترة الزمنية. يتم تمثيل المدد الزمنية الأقل من ثانية واحدة بحقل 0 seconds وحقل nanos موجب أو سالب. بالنسبة إلى المدد التي تبلغ ثانية واحدة أو أكثر، يجب أن تكون قيمة الحقل nanos غير صفرية وأن تحمل العلامة نفسها التي يحملها الحقل seconds. يجب أن تتراوح القيمة بين ‎-999,999,999 و‎+999,999,999، بما في ذلك الرقمان.

التعليقات التوضيحية للأدوات

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌