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

يمكنك الحصول على مصفوفة مسارات لأنواع مختلفة من المركبات. لضبط وضع السفر في طلب computeRouteMatrix HTTP POST، مرِّر حقل travelMode في نص طلب JSON باستخدام قيمة تعداد RouteTravelMode. إذا لم تحدّد قيمة travelMode، يستخدم Routes API القيمة التلقائية DRIVE.

يمكنك اختيار القيادة أو المركبات ذات العجلتين أو النقل العام أو الشاحنات أو المشي. لا يتوفّر خيار ركوب الدراجات (BICYCLE) في مصفوفات المسارات.

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

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

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

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    }
  ],
  "travelMode": "WALK"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'