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

مطوّرو التطبيقات المقيمون في المنطقة الاقتصادية الأوروبية (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)
    }
  }
  …
]