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

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

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

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