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

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

لضبط وسيلة النقل في طلب computeRoutes HTTP 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 في نص طلب POST بتنسيق JSON محلّ مَعلمة طلب البحث 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'