تعرض عمليات احتساب المسار (بما في ذلك إعادة التوجيه) المسار الذي يستغرق أقل وقت للتنقّل كـ أفضل مسار تلقائي. ومع ذلك، يمكنك تغيير استراتيجية التوجيه ليتم عرض المسار البديل الأقصر بدلاً من ذلك.
يشير المصطلح أقصر إلى المسار الأقصر بين المسارات المثلى استنادًا إلى نموذج التكلفة التلقائي لدينا. قد لا يكون المسار الأقصر هو المسار الأقصر على الإطلاق، لأنّ هذا الخيار قد يكون بديلاً سيئًا. على سبيل المثال، إذا كان أقصر مسار مطلق هو 10 كم ويستغرق التنقل فيه 50 دقيقة، وكان هناك مسار آخر يبلغ طوله 15 كم، ولكنه يستغرق 20 دقيقة فقط للتنقل فيه، فإن الخيار الثاني هو الأمثل، لأن قضاء 30 دقيقة لتقليل خمسة كيلومترات ليس مقايضة جيدة.
بعد ضبط استراتيجية المسار لرحلة معيّنة، لن تتغيّر حتى تكتمل الرحلة. لتغيير استراتيجية المسار لرحلة حالية، عليك محو الوجهات وإعادة ضبطها باستخدام استراتيجية المسار الجديدة.
ضبط استراتيجية التوجيه
يمكنك ضبط استراتيجية التوجيه من خلال ضبط
RoutingOptions.routingStrategy عند طلب setDestinations().
تأخذ السمة RoutingOptions.routingStrategy إحدى قيم تعداد الخيارات التالية:
| قيمة تعداد الخيارات | الوصف |
|---|---|
| RoutingStrategy.DEFAULT_BEST | يتم ترتيب المسارات حسب نموذج التكلفة التلقائي في حزمة Navigation SDK. هذه هي استراتيجية التوجيه التلقائية. |
| RoutingStrategy.SHORTER | يتم ترتيب المسارات حسب المسافة. المسار الأعلى ترتيبًا هو الأقصر من بين المسارات التي يتم عرضها. |
مثال
يوضّح مثال الرمز البرمجي التالي كيفية ضبط الإعدادات المفضّلة للمسار الأقصر.
RoutingOptions routingOptions = new RoutingOptions();
routingOptions.routingStrategy(RoutingStrategy.SHORTER);
navigator.setDestinations(destinations, routingOptions, displayOptions);
المسارات التي تشمل عبّارات
تستبعد حزمة NavSDK تلقائيًا المسارات التي تتضمّن عبّارات. إذا كنت تفضّل تضمين خيارات العبّارات كجزء من مساراتك، يمكنك تعديل هذا الخيار المفضّل للمسار لعرض الرحلة إلى أجزاء العبّارات من خلال ضبط avoidFerries على false.
مثال
RoutingOptions routingOptions = new RoutingOptions().avoidFerries(true);
// Add additional routing preferences
navigator.setDestination(destination, routingOptions);
تنسيق وسيلة الشرح للمسار
ضمن خيار المسار الأقصر، تعرض وسائل الشرح على طول المسار تفاصيل المسافة. ولكن يمكنك استخدام وسائل الشرح الخاصة بالوقت المقدّر للوصول بدلاً من ذلك.
ضبط تنسيق وسيلة الشرح للمسار
يمكنك تغيير تنسيق وسيلة الشرح للمسار من خلال استدعاء setRouteCalloutInfoFormat
في NavigationView (أو في NavigationFragment). setRouteCalloutInfoFormat
يأخذ إحدى قيم تعداد الخيارات التالية:
| قيمة تعداد الخيارات | الوصف |
|---|---|
| RouteCalloutInfoFormat.DEFAULT | يعرض الوقت المتبقي عند استخدام استراتيجية التوجيه التلقائية لأفضل مسار. تعرض هذه السمة المسافة المتبقية عند استخدام استراتيجية توجيه المسار الأقصر. |
| RouteCalloutInfoFormat.TIME | يعرض الوقت المتبقي. |
| RouteCalloutInfoFormat.DISTANCE | تعرض هذه البطاقة المسافة المتبقية. |
مثال
يوضّح مثال الرمز التالي كيفية ضبط تنسيق وسيلة الشرح للمسار.
mNavFragment.setRouteCalloutInfoFormat(RouteCalloutInfoFormat.TIME);