ضبط الإعدادات المفضّلة للتوجيه

تعرض عمليات احتساب المسار (بما في ذلك إعادة التوجيه) المسار الذي يستغرق أقل وقت للتنقّل باعتباره أفضل مسار تلقائي. ومع ذلك، يمكنك تغيير استراتيجية التوجيه لعرض أقصر الطرق البديلة.

يشير مصطلح أقصر إلى المسار الأقصر بين المسارات المثالية استنادًا إلى نموذج التكلفة التلقائي. قد لا يكون المسار الأقصر هو المسار الأقصر على الإطلاق، لأنّ هذا الخيار قد يكون بديلاً غير مناسب. على سبيل المثال، إذا كان أقصر مسار على الإطلاق يبلغ 10 كيلومترات ويستغرق 50 دقيقة، وكان هناك مسار آخر يبلغ 15 كيلومترًا ويستغرق 20 دقيقة فقط، سيكون الخيار الثاني هو الأفضل لأنّ توفير 30 دقيقة مقابل قطع 5 كيلومترات إضافية هو خيار منطقي.

بعد ضبط استراتيجية التوجيه لرحلة، لن تتغيّر إلى أن تكتمل الرحلة. لتغيير استراتيجية التوجيه لرحلة حالية، عليك محو الوجهات وإعادة ضبطها باستخدام استراتيجية التوجيه الجديدة.

ملاحظة: هذه الميزة مخصّصة لموفّري خدمات مشاركة الرحلات الذين يعملون في أسواق منظَّمة (مثل أوروبا)، حيث يفرض القانون عليهم غالبًا تسعير خدماتهم وفقًا للمبادئ نفسها التي تتّبعها سيارات الأجرة التقليدية، والتي تفرض رسومًا استنادًا بشكل أساسي إلى المسافة المقطوعة.

جارٍ الحصول على تفاصيل المسار

لتحديد استراتيجية المسار الأنسب لنقطة طريق معيّنة، يمكنك طلب getRouteInfo() للحصول على تفاصيل المسار لكلّ من أفضل مسار تلقائي وأقصر مسار على الإطلاق. وتشمل التفاصيل المدة والمسافة إلى نقطة طريق الوجهة.

تأتي هذه التفاصيل من RouteInfo، ويتم عرضها في ListenableResultFuture.

مثال

يوضّح مثال الرمز البرمجي التالي كيفية الحصول على تفاصيل المسار لكلّ من استراتيجيتَي التوجيه.

ListenableResultFuture<RouteInfo> routeInfoFuture =
        navigator.getRouteInfo(waypoint, routingOptions);

ضبط استراتيجية التوجيه

يمكنك ضبط استراتيجية التوجيه من خلال ضبط 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);