Routing Configuration - .routing.xml
This article is incomplete & needs to be reviewed. You can help by creating a pull request.
Routing.xml is a configuration file that stores multiple routing profiles. Each profile is independent and has only base OsmAnd profile as a reference that's why it's not possible to create a hierarchy of profiles and you will need to copy all rule sections. Each is fully configurable via routing.xml, it means there is no any constants in the code and all penalties are calculated using this configuration.
In the application you can use multiple custom routing.xml files and profiles you can select them in Settings -> Profile -> Navigation Settings -> Routing Settings.
Please check the documentation inside routing.xml:
- https://github.com/osmandapp/OsmAnd-resources/blob/master/routing/routing.xml#L24
- Other examples https://github.com/osmandapp/OsmAnd-resources/tree/master/routing
Penalties of Elevation data
Depending on the selected mode (Less hilly, Flat, Hilly) of Bicycle-based routing and the physical slope (%) of thse road, a penalty calculated from the height difference is added to each horizontal metre.
The 1:2 penalty assigns a cost factor of 2.0 to a 3% incline. Consequently, a 1 km uphill segment (cost 2.0) is weighed equally to a 2 km flat segment, but is preferred over any flat detour exceeding 2 km.
Tables and charts of penalties bicycle routing:
| Option | Incline: | <1% | <3% | <7% | <13% | <25% | >=25% |
|---|---|---|---|---|---|---|---|
| Disabled/Any (the shortest but hardest) | - | - | - | - | - | - | |
| Flat (the longest but easy) | 1:2 | 1:12 | 1:30 | 1:50 | 1:74 | ||
| Less hilly (default, balanced) | 1:2 | 1:8 | 1:16 | 1:32 | 1:48 | ||
| Hilly (more difficult) | 1:61 | 1:19.7 | 1:7.5 | 1:3 | 1:0.5 | 1:0.3 |
| Option | Decline: | <17% | <35% | <60% | >=60% |
|---|---|---|---|---|---|
| Disabled/Any (the shortest but hardest) | - | - | - | - | |
| Flat (the longest but easy) | 1:6.4 | 1:25 | 1:25 | impossible | |
| Less hilly (default, balanced) | 1:6.4 | 1:25 | 1:25 | impossible | |
| Hilly (more difficult) | 1:6.4 | 1:25 | 1:25 | impossible |
Depending on the selected mode (Less hilly, Flat, Hilly) of Pedestrian routing and the physical slope (%) of the road, a penalty calculated from the height difference is added to each horizontal metre.
Tables and charts of penalties pedestrian routing:
| Option | Incline: | <1% | <3% | <7% | <13% | <25% | >=25% |
|---|---|---|---|---|---|---|---|
| Disabled/Any (the shortest but hardest) | - | - | - | - | - | - | |
| Flat (the longest but easy) | 1:2 | 1:12 | 1:30 | 1:50 | 1:74 | ||
| Less hilly (default, balanced) | 1:1 | 1:4 | 1:8 | 1:10 | 1:15 | ||
| Hilly (more difficult) | 1:61 | 1:20 | 1:7 | 1: 3 | 1:0.5 | 1:0.3 |
| Option | Decline: | <9% | <17% | <35% | <60% | >=60% |
|---|---|---|---|---|---|---|
| Disabled/Any (the shortest but hardest) | - | - | - | - | - | |
| Flat (the longest but easy) | 1:5 | 1:10 | 1:17 | 1:25 | 1:40 | |
| Less hilly (default, balanced) | 1:5 | 1:10 | 1:17 | 1:25 | 1:40 | |
| Hilly (more difficult) | 1:5 | 1:10 | 1:17 | 1:25 | 1:40 |
