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

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

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

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

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

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

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

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

ولمزيد من المعلومات، اطّلِع على اختيار المعلومات المطلوب عرضها.

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

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

Powered by Google, ©YEAR Google

مثال:

Powered by Google, ©2023 Google

تحديد المسار في الإجابة

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