Routing settings - devemux86/cruiser GitHub Wiki

The routing settings of Cruiser can be accessed via [ Main ] > "Settings" > "Routing".

The routing settings contain all of the "rules" Cruiser uses to calculate a route. To do so, a bunch of different routing engines are supported:

• BRouter (offline)
• CycleStreets
• GraphHopper
• OpenRouteService
• OSRM
• Valhalla

With the BRouter (offline) routing engine, a powerful set of options is available to tailor your routing preferences. For now, only the options for this routing engine are explained here. Others may follow...

The BRouter (offline) routing engine offers several routing profiles for different riding preferences:

• Fastest route
• Fast and curvy route
• Curvy route
• Extra curvy route

The notion of "curvy" vs. "fast" can be explained by a simple A-to-B route that might be taken on a motorway under normal circumstances but happens to have a selection of primary/secondary roads running almost parallel to it. These roads may not be as straight (or "boring") as the motorway and offer a more thrilling ride.

Here is an example of a route calculated with different profiles. The 1st, shown in green, has a motorway/toll avoidance and thus routes via the slower roads. The 2nd, shown in orange, takes motorways into account. As a result, the same route has a different length and requires a different time to ride.

The default routing options for each profile may work for you right out of the box - but if not, you can easily change them. For example, if you want to avoid motorways, tolls, ferries or even cities, you can do so. The type of roads allowed (or avoided) will determine how Cruiser calculates your route, so a little experimentation with the values may be required.

All routing profiles can be renamed, so if you wanted to change "fastest" to "no motorways/tolls", you can do so (and set the avoidances accordingly).

It is furthermore possible to configure separate routing profiles for each type of riding, e.g. commuting, weekend twisty roads, toll-free touring etc. Each routing profile may also have its own route colour, e.g. blue for "fastest" (motorways), purple for curvy/twisty and perhaps brown (dirt) for a routing profile that favors off-road/tracks.

During navigation, you'll see the information panels depending on the used routing profile. So if you prefer a different layout/scheme for each type of travel, you can configure a profile adapted precisely for each environment.

Here in this Wiki we're dealing with the "Curvy route" profile as an example, which was - as you can see in the screenshots above - setup with a strong avoidance of motorways and trunk roads, with other roads having varying degrees of "avoid" level.

Depending on the type of avoidance they can

• either be "Off", or set to a value from 1-100 % (bigger percentage == stronger avoidance)
• just be toggled "Off" / "On"

Setting a lot of avoidances at the same time means that BRouter is quite restricted when calculating your route. You should therefore set as few avoidances as possible, as otherwise strange routes or long detours may be calculated!

The following settings can be applied for each profile:

• "Avoid toll roads" - possible range: Off; 1-100 %
• "Avoid ferries" - possible range: Off; 1-100 %
• "Avoid motorways" - possible range: Off; 1-100 %
• "Avoid trunk roads" - possible range: Off; 1-100 %
• "Avoid primary roads" - possible range: Off; 1-100 %
• "Avoid secondary roads" - possible range: Off; 1-100 %
• "Avoid tertiary roads" - possible range: Off; 1-100 %
• "Avoid unclassified roads" - possible range: Off; 1-100 %
• "Avoid residential roads" - possible range: Off; 1-100 %
• "Avoid unpaved roads" - possible range: Off; On
• "Off-road tracks" - possible range: Off; On
• "Ignore closed roads" - Allows to route also via roads which are closed. This can be useful, for example, if you want to plan routes over closed mountain passes in winter that you would like to ride in the warmer season; possible range: Off; On
• "Avoid cities" - possible range: Off; On
• "Prefer forests and green areas" - possible range: Off; On
• "Avoid high speed roads" - possible range: 10-250 km/h
• "Edit" - Allows to rename the profile.
• "Reset" - Resets the profile to its defaults.

The advanced settings for BRouter (offline) allow to fine-tune the routing behaviour of the routing engine.

• Activated - BRouter (offline) avoids unnecessary u-turns when generating a route. This can prevent having to drive a route section to a waypoint and then immediately back again, resulting in a more straightforward routing.
• Deactivated - U-turns might occur during route generation.

With this setting you can advise BRouter (offline) to correct (or "ignore") misplaced waypoints of a route.

• Activated - Inaccurately placed waypoints are corrected by "ignoring" and routing around them [1]. The route diagram in the screenshot below shows just the direct route without the short detour [2]; possible range: 0 m - 1 km
• Deactivated - BRouter (offline) includes all waypoints exactly as set [3]. In this case, the route diagram clearly shows the short detour, including the different ascents and descents [4].

This setting allows to include waypoints in a route where routing via streets or paths would usually not be possible.

• Activated - The routing profile is automatically switched to "straight line routing" from/to these distant waypoints.
• Deactivated - Distant waypoints might cause an error while trying to calculate a route.

With this setting you can ask the routing engine to calculate different routes to your destination. This might come in handy when there are more than one nice route options and you can't decide which one you want to take.

Here you can define the BRouter (offline) profile which should be used by the routing engine to calculate the routes. You can either

• use the predefined "internal driving profile" or
• open an external profile, which can be adopted to your personal routing preferences; see How to use BRouter profiles and website for reference

• Activated - A diagram of the currently loaded route is displayed on the map. In addition to the route's elevation chart, the start and end points are displayed, as well as all potentially set via points. The route's details are displayed below the chart.
• Deactivated - There is no route diagram displayed, the map is shown over the whole screen of your device.

When you tap a point on the route, the very same point is indicated in the route diagram showing its details (distance from start/to end, elevation etc.) - see the vertical line in the diagram in [1].

This also works in the opposite direction - which means if you tap on any point in the route diagram, the map is centered on that very point on the route. When you swipe left or right in the diagram, the map is moved accordingly.

With the route diagram disabled, the map is shown over the full height of the display [2].

If you want to see the details of a certain point of the route with the route diagram disabled, long-press the point on the route. Its details are then displayed in the on-screen-menu [3].

With these settings you can fully customize the colors of your routes and/or route sections. In addition to predefined colors from a dropdown, you can freely define your own custom colors in RGB style.

You can set separate colors for:

• "Route color" - This color is used to display the route during navigation.
• "Off road tracks" - Used for paths, hiking trails or non-paved sections of a route.
• "Straight line" - The color for straight line or beeline route sections.
• "Fastest route"
• "Fast and curvy route"
• "Curvy route"
• "Extra curvy route"