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

يستقبل طلب مصفوفة المسارات مصفوفة من نقاط الطريق الخاصة بنقطة الانطلاق والوجهة. تحسب واجهة 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 في مصفوفة الإدخال.

لمحة عن معلومات المسار في الردّ

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

بالإضافة إلى السمتَين originIndex وdestinationIndex، يحتوي كل عنصر على معلومات أساسية فقط خاصة بهذا المسار، مثل distanceMeters وduration وtravelAdvisory. للحصول على معلومات أكثر تفصيلاً حول مسار معيّن، مثل خط متعدد الأضلاع، استخدِم computeRoutes.

يكون الردّ على النحو التالي:

[
  // 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)
    }
  }
  …
]