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

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

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

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

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

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

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

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

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

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

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

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

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