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

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