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

يأخذ طلب مصفوفة المسارات كمدخل مصفوفة من نقاط الالتفاف في نقطة الانطلاق والوجهة. بعد ذلك، تحتسب 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)
    }
  }
  …
]