مراجعة استجابة مصفوفة المسار

مطوّرو المنطقة الاقتصادية الأوروبية (EEA)

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

تحتوي استجابة واجهة برمجة التطبيقات على مصفوفة، حيث يتطابق كل عنصر في المصفوفة مع المسار من نقطة انطلاق على المسار إلى نقطة وصول على المسار. لذلك، إذا حدّدتم نقطتَي طريق للانطلاق ونقطتَي طريق للوصول، ستحتوي مصفوفة الاستجابة على أربعة عناصر، واحد لكل مسار محسوب.

باستخدام الاستجابة، يمكنكم تزويد عملائكم بخيارات مسارات مختلفة ثم السماح للمستخدم باختيار المسار المناسب لمتطلباته.

لمحة عن أقنعة الحقول

عند استدعاء طريقة لحساب مسار، يجب تحديد قناع حقل يحدّد الحقول التي تريدون عرضها في الاستجابة. لا توجد قائمة تلقائية بالحقول المعروضة. إذا لم يتم تضمين هذه القائمة، ستعرض الطرق خطأً.

تعرض الأمثلة الواردة في هذا المستند عنصر الاستجابة بالكامل بدون أخذ أقنعة الحقول في الاعتبار. في بيئة التشغيل الفعلي، لن تتضمّن الاستجابة إلا الحقول التي تحدّدونها بشكلٍ صريح في قناع الحقل.

لمزيد من المعلومات، يُرجى الاطّلاع على اختيار المعلومات المطلوب عرضها.

لمحة عن عرض حقوق الطبع والنشر

يجب تضمين بيان حقوق الطبع والنشر التالي عند عرض النتائج للمستخدمين:

Powered by Google, ©YEAR Google

على سبيل المثال:

Powered by Google, ©2023 Google

تحديد المسار في الاستجابة

استخدِموا سمتَي الاستجابة originIndex وdestinationIndex لتحديد كل مسار في الاستجابة. تحتوي هاتان السمتان على الفهرس المستند إلى الصفر لنقطتَي الطريق للانطلاق والوصول اللتين تم استخدامهما لحساب المسار. يعني ذلك أنّ نقطة الطريق الأولى للانطلاق ونقطة الطريق الأولى للوصول في الطلب تقعان عند الفهرس 0 في المصفوفة.

على سبيل المثال، يحتوي مسار في الاستجابة على ما يلي:

"originIndex": 1,
"destinationIndex": 0

تشير هاتان السمتان إلى أنّه تم حساب المسار من نقطة على المسار الانطلاق عند الفهرس 1 في مصفوفة الإدخال، ومن نقطة على المسار الوصول عند الفهرس 0.

بالنسبة إلى المسار التالي:

"originIndex": 4,
"destinationIndex": 1

تم حساب المسار من نقطة طريق الانطلاق عند الفهرس 4 في مصفوفة الإدخال، ومن نقطة طريق الوصول عند الفهرس 1 في مصفوفة الإدخال.

لمحة عن الاستجابة

يحتوي كائن JSON الذي يمثّل استجابة واجهة برمجة التطبيقات على مصفوفة، حيث يحدّد كل عنصر في المصفوفة المسار من نقطة طريق للانطلاق إلى نقطة طريق للوصول.

بالإضافة إلى سمتَي originIndex وdestinationIndex، يحتوي كل مسار على معلومات خاصة به، مثل distanceMeters وduration وtravelAdvisory.

تأخذ الاستجابة الشكل التالي:

[
  // One array element for each combination of origin and destination waypoints.
  {
    // The route for source waypoint 0 and destination waypoint 0.
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  {
    // The route for source waypoint 0 and destination waypoint 1.
    "originIndex": 0,
    "destinationIndex": 1,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  …
]