שינוי העדפות הניתוב

חישובי המסלולים (כולל שינוי מסלול) מחזירים את המסלול שבו זמן המסלול קצר ביותר בתור ברירת המחדל למסלול הטוב ביותר. עם זאת, אפשר לשנות את שיטת הניתוב כך שהמסלול הקצר מבין המסלולים החלופיים יוחזר במקום זאת.

המונח קצר יותר מתייחס למסלול הקצר ביותר מבין המסלולים האופטימליים, על סמך מודל העלות שמוגדר כברירת מחדל. יכול להיות שהמסלול הקצר יותר הוא לא המסלול הקצר ביותר, כי יכול להיות שהאפשרות הזו היא חלופה גרועה. לדוגמה, אם המסלול הקצר ביותר הוא 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);

הפורמט של נכס היתרונות המרכזיים של המסלול

אם בוחרים באפשרות 'מסלול קצר יותר', יוצגו פרטי המרחק בקטעי הטקסט לאורך המסלול. במקום זאת, אפשר להשתמש בתוספי היתרונות המרכזיים של מודעות ה-ETA.

הגדרת הפורמט של ההודעה על המסלול

אפשר לשנות את הפורמט של ההודעה על המסלול על ידי קריאה לפונקציה setRouteCalloutInfoFormat ב-NavigationView (או ב-NavigationFragment). הפונקציה setRouteCalloutInfoFormat מקבלת את אחד מערכי המנייה הבאים:

ערך ספירה	תיאור
RouteCalloutInfoFormat.DEFAULT	זמן הנסיעה שנותר כשמשתמשים בשיטת ברירת המחדל לניתוב לפי הנתיב הטוב ביותר. מוצגת המרחק שנותר כשמשתמשים בשיטת הניתוב למסלול הקצר יותר.
RouteCalloutInfoFormat.TIME	מוצג הזמן שנותר.
RouteCalloutInfoFormat.DISTANCE	הצגת המרחק שנותר.

דוגמה

בדוגמת הקוד הבאה מוסבר איך להגדיר את הפורמט של הקריאה לפעולה בנתיב.

mNavFragment.setRouteCalloutInfoFormat(RouteCalloutInfoFormat.TIME);