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