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