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

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