أنواع المركبات المتاحة للمسارات

يمكنك الحصول على مسار مناسب لأنواع مختلفة من المركبات. إذا لم تحدّد نوع المركبة، ستستخدم Routes API القيمة التلقائية لسيارة تعمل بالبنزين (DRIVE).

لضبط وسيلة النقل في طلب HTTP من النوع computeRoutes POST، يجب تمرير الحقل travelMode في نص طلب JSON باستخدام قيمة تعداد RouteTravelMode ، مع خيارات النقل العام أو القيادة أو المركبات ذات العجلتين أو الشاحنات أو المشي أو ركوب الدراجات.

نوع المركبة	قيمة RouteTravelMode	الوصف
درّاجة	BICYCLE	احتساب مسار للدراجات الهوائية وغيرها من وسائل النقل التي تعتمد على القوة البشرية بالنسبة إلى المركبات الآلية ذات العجلتين، يُرجى الاطّلاع على المركبات ذات العجلتين.
Drive	DRIVE	احتسِب مسار قيادة. DRIVE هو الخيار التلقائي إذا لم تحدّد نوع المركبة.
النقل العام	TRANSIT	يمكنك الحصول على مسار نقل عام للحصول على تعليمات التنقّل باستخدام خيارات النقل العام المتاحة في المنطقة. ويمكن أن تشمل خيارات النقل العام الحافلات ومترو الأنفاق والقطارات وغيرها. يتضمّن مسار النقل العام أيضًا عادةً تعليمات حول المشي من وإلى محطات النقل العام وبينها.
مركبة ذات عجلتين	TWO_WHEELER	تشير المركبات ذات العجلتين إلى المركبات الآلية ذات العجلتين (مثل الدراجات النارية). يختلف وضع السفر بالدراجة النارية عن وضع السفر بالدراجة الهوائية، وهو وضع سفر يعتمد على القوة البشرية.
شاحنة	TRUCK	يمكنك احتساب مسار مخصّص لمركبة كبيرة من خلال تحديد سماتها وقيودها المادية في routeModifiers.vehicleInfo. استخدِم نوع المركبة هذا لتجنُّب الجسور المنخفضة والقيود المفروضة على الوزن والمخاطر.
المشي	WALK	احتسِب مسارًا سيرًا على الأقدام.

تحديد وضع السفر في طلب

لتحديد وسيلة نقل في طلب computeRoutes، اضبط حقل travelMode في نص طلب JSON لبروتوكول HTTP POST وأدرِج عنوان X-Goog-FieldMask المطلوب لاختيار حقول استجابة Route التي تحتاج إليها. في حال نقل البيانات من الإصدار القديم من Directions API، يحلّ الحقل travelMode في نص طلب JSON الخاص بـ POST محلّ مَعلمة طلب البحث mode في عنوان URL القديم. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة نقل البيانات إلى Routes API.

curl -X POST -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "travelMode": "BICYCLE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline' \
'https://routes.googleapis.com/directions/v2:computeRoutes'