RoutingModeType
The RoutingMode specifies how the route is calculated. Parameter representation:
RoutingMode = Type + [TransportModes] + [TrafficMode] + [Feature]
Parameter component | Structure |
---|---|
Type | RoutingType relevant to calculation. See also RoutingTypeType. Enum [ |
[TransportModes] | Specify which mode of transport to calculate the route for. See alsoTransportModeType. Enum [car | pedestrian | carHOV | truck | bicycle |
[TrafficMode] | Specify whether to optimize a route for traffic. See also TrafficModeType. traffic: Enum [enabled | disabled | default ] |
[Feature] | Route feature weightings to be applied when calculating the route. As many as required. See also RouteFeatureType and RouteFeatureWeightType. RouteFeatureType: RouteFeatureWeightType |
&mode=fastest;car;traffic:disabled;motorway:-2
RoutingTypeType
RoutingType
provides identifiers for different optimizations which can be applied during the route calculation. Selecting the routing type affects which constraints, speed attributes and weights are taken into account during route calculation.
Enumeration | Description |
---|---|
fastest | Route calculation from start to destination optimized by travel time. Depending on the traffic mode provided by the request, travel time is determined with or without traffic information. In some cases, the route returned by the fastest mode may not be the route with the shortest possible travel time. For example, the routing service may favor a route that remains on a highway, even if a shorter travel time can be achieved by taking a detour or shortcut through a side road. |
shortest | Route calculation from start to destination disregarding any speed information. In this mode, the distance of the route is minimized, while keeping the route sensible. This includes, for example, penalizing turns. Because of that, the resulting route will not necessarily be the one with minimal distance. |
balanced | Route calculation from start to destination optimizing based on combination of travel time and distance. |
TrafficModeType
Enumeration | Description |
---|---|
enabled | No departure time provided: This behavior is deprecated and will return error in the future.
Departure time provided:
|
disabled | No departure time provided:
Departure time provided:
|
default | Let the service automatically apply traffic related constraints that are suitable for the selected routing type, transport mode, and departure time. Also user entitlements will be taken into consideration. |
TransportModeType
limitedweight
greater than 18 tons. The medium truck profile is only used if you specify a value for the parameter limitedweight
greater than 7.5 tons and less than or equal to 18 tons. The light truck profile is only used if you specify a value for the parameter limitedweight
less than or equal to 7.5 tons. The car speed profile is used if truck is not specified in the routing mode. Enumeration | Description |
---|---|
car | Route calculation for cars. |
carHOV | Route calculation for HOV (high-occupancy vehicle) cars. |
pedestrian | Route calculation for a pedestrian. As one effect, maneuvers will be optimized for walking, that is segments will consider actions relevant for pedestrians and maneuver instructions will contain texts suitable for a walking person. This mode disregards any traffic information. |
truck | Route calculation for trucks. This mode considers truck limitations on links and uses different speed assumptions when calculating the route. |
bicycle | Route calculation for bicycles. This mode uses the pedestrian road network, but uses different speeds based on each road's suitability for cycling. Pedestrian roads that are also open for cars in the travel direction are considered open for cycling, as are pedestrian roads located in parks. These roads use full bicycle speed for routing. Other pedestrian roads, including travelling the wrong way down one-way streets, are considered at the pedestrian walking speed, as it is assumed the bicycle must be pushed. |
RouteFeatureType
The routing features can be used to define special conditions on the calculated route. The user can weight each feature with non-positive weights, see type RouteFeatureWeightType.
Parameter | Description |
---|---|
tollroad | Identifier for toll roads |
motorway | Identifier for motorways |
boatFerry | Identifier for boat ferries |
railFerry | Identifier for rail ferries |
tunnel | Identifier for tunnels |
dirtRoad | Identifier for dirt roads |
park | Identifier for links through parks. This route feature is only applicable for pedestrian and bicycle routing. |
RouteFeatureWeightType
Route feature weights are used to define weighted conditions on special route features like tollroad, motorways, etc.
Enumeration | Description |
---|---|
-3 | strictExclude The routing engine guarantees that the route does not contain strictly excluded features. If the condition cannot be fulfilled no route is returned. |
-2 | softExclude The routing engine will assign very large penalties to links with the corresponding feature. |
-1 | avoid The routing engine assigns penalties for links containing the corresponding feature. |
0 | normal The routing engine does not alter the ranking of links containing the corresponding feature. |