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

يمكنك الحصول على مصفوفة مسارات لأنواع مختلفة من المركبات. لضبط وضع السفر في طلب 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 محلّ مَعلمة طلب البحث القديمة في عنوان URL mode. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة نقل البيانات إلى 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'