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

المطوّرون في المنطقة الاقتصادية الأوروبية

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

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

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

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على اختيار المعلومات التي سيتم عرضها.

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

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

Powered by Google, ©YEAR 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)
    }
  }
  …
]