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

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

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

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

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

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

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

لمزيد من المعلومات، يمكنك الاطّلاع على اختيار المعلومات التي تريد إرجاعها.

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

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

Powered by Google, ©YEAR Google

مثلاً:

Powered by Google, ©2023 Google

تحديد المسار في الردّ

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