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

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

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

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

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

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

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

لمزيد من المعلومات، يمكنك الاطّلاع على اختيار المعلومات التي تريد إرجاعها.

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

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

Powered by Google, ©YEAR Google

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

Powered by Google, ©2023 Google

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

استخدِم سمتَي الاستجابة originIndex وdestinationIndex لتحديد كل مسار في الاستجابة. تحتوي هذه السمات على فهرس مستنِد إلى صفر نقاط طريقة الإدخال origin وdestination المستخدمة لاحتساب المسار. وهذا يعني أنّ نقطة الطريق الأولى للنقطة المرجعية للانطلاق ونقطة الطريق الأولى للنقطة المرجعية للوجهة في الطلب هما في فهرس المصفوفة 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)
    }
  }
  …
]