Truck Routing
The Truck Routing features of the API extends Waypoints, Routing Types, Transport Modes, and Time Aware Routing with truck-specific and time-dependent features.
Truck Routing Mode
Route calculations in Truck Routing Mode take into account any truck-related restrictions. These route calculations also use different Speed Profiles for light, medium, and heavy trucks. The resulting routes are optimized for the least amount of travel time. You can further optimize truck routing for traffic and also support penalizing roads with specific kinds of attributes. See Avoiding Certain Road Types for more information.
When calculating truck routes, we recommend to always use the fastest
Routing Mode Type. See Routing Mode Parameter Combinations for more information.
Truck Profile
- to identify the relevant speed profile for route computation
- to exclude roads and maneuvers with certain restrictions that are violated by a particular truck
truckType
trailersCount
axleCount
shippedHazardousGoods
limitedWeight
weightPerAxle
weightsPerAxleGroup
height
width
length
tunnelCategory
truckRestrictionPenalty
For more details on how to use these parameters, see Examples for Truck Routing Requests.
Weight Per Axle Group
- single axle group
- tandem axle group


weightsPerAxleGroup
with a group type single
or tandem
like in the examples below. // truck with 12 tonnes per single axle group
&weightsPerAxleGroup=single:12
// truck with 16 tonnes per tandem axle group
&weightsPerAxleGroup=tandem:16
// truck with 12 tonnes per single axle group and 16 tonnes per tandem axle group
&weightsPerAxleGroup=single:12;tandem:16

Truck Speed Profile
- light truck (default) – uses speeds that are lower than those for regular cars
- medium truck (
18 tons > limitedWeight > 7.5 tons
) – uses speeds that are lower than those for light trucks - heavy truck (
limitedWeight > 18 tons
) – uses speeds that are lower than those for medium trucks
Truck Restrictions
- Legal restrictions – applies to links and maneuvers prohibited for trucks
- Physical restrictions – applies to physical attributes of a vehicle, for example: weight, weight per axle, height, width, or length
- Hazardous materials restrictions – applies to cargos with hazardous materials. See Hazardous Materials.
- Tunnel categories – applies to a tunnel category for hazardous materials. See Tunnel Categories.
- Trailer restrictions – relates to vehicle trailers. See Trailer Restrictions.
- Axle restrictions – relates to a vehicle axle count. See also
Conditional Restrictions
. - Time dependent restrictions – applies to restrictions for a specific period of time. Routes using roads that violate a time dependent restriction are penalized if the vehicle reaches the road while the restriction is valid. However, this restriction is not taken into account if the road is reached outside of the restricted period or if the route is calculated in the planning mode. See Using Time Aware Routing.
- Conditional restrictions – applies to legal or physical restrictions dependent on time or Truck Profile, where the Truck Profile may include attributes such as
truckType
,trailersCount
,axleCount
,shippedHazardousGoods
, andtunnelCategory
. See Conditional Restrictions.
Hazardous Materials Restrictions
- when the truck contains hazardous materials, roads prohibited for shipment of dangerous materials are always excluded from route calculation
- when the request specifies
shippedHazardousGoods=harmfulToWater
, roads prohibited for shipment of water pollutants are excluded from route calculation - when the request specifies
shippedHazardousGoods=explosive,flammable
, roads prohibited for shipment of explosive and flammable materials are excluded from route calculation - when the request specifies a hazardous material that is in the truck, roads prohibited for shipment of that specific hazardous material are excluded from route calculation
Although some hazardous material categories overlap, the routing engine does not implicitly map the hazardous materials to restricted goods. For example, if the cargo specifies combustible
materials or gas
(which could be flammable), roads prohibited for flammable materials are not excluded from route calculations. Similarly, if the cargo specifies poison
or gas
(which could be toxic), roads prohibited for materials that are poisonous upon inhalation are not excluded from route calculations.
Tunnel Categories
Tunnel Categories (tunnelCategory
) specify which dangerous goods are not allowed to enter the regulated tunnel. The categories range from B to E with B being the least restrictive. The tunnel categories provided in a Truck Profile excludes tunnels that are equally or more restrictive from the route calculation.
Because tunnel categories include restrictions for dangerous goods, you might expect the routing engine to automatically select the most appropriate tunnel category based on the shippedHazardousGoods
parameter. However, this is not the case. If you have set the shippedHazardousGoods
parameter, you must still set the tunnelCategory
parameter as well. The routing engine cannot calculate the value for tunnelCategory
based on the shippedHazardousGoods
alone.
Trailer Restrictions
- if
trailersCount > 0
– roads prohibited for trucks with trailers are excluded from route calculation - if
truckType = tractorTruck
andtrailersCount > 0
– roads prohibited for tractors with semi-trailers are excluded from route calculation
Conditional Restrictions
Conditional restrictions are the restrictions that apply only to trucks with a particular type of trailer, with a particular number of axles or a cargo with a specific material. If a truck violates a conditional restriction, it is implied that the truck violates all of the conditions specified.
Typically, a conditional restriction is a physical attribute limit dependent on a trailer type where the restriction applies only to trucks of that trailer type. For example, suppose a road prohibits trucks with trailers that weigh over 20 tons (trailersCount >= 1
and limitedWeight > 20 tons
). This restriction applies to trucks of any type with at least one trailer and a total weight exceeding 20 tons. However, this restriction does not apply to trucks without trailers even if they exceed 20 tons. Similarly, this restriction also does not apply to trucks with trailers that weigh less than 20 tons.