Skip to main content

Vehicle dimensions

Contents

The Routing APIs take into account a truck’s size, weight, and physical and legal road restrictions in order to generate safe and legal routes—from avoiding low bridges and sharp turns to following roads designated as truck routes. There are a few different ways to select your vehicle’s dimensions in the Routing APIs, depending on where in the world you are routing.

Vehicle Dimensions
The Routing APIs use vehicle dimensions to generate safe and legal routes for the type of vehicle being driven.

How to set vehicle dimensions

Choice 1: Do nothing and use the defaults

By default, the APIs are set up to select truck routes based on the following vehicle dimensions. (That is, the route should not take any roads that are unfit for a vehicle of the default size.)

RegionHeightLength*WidthWeightAxlesMax Weight per Axle
North America13 feet, 6 inches48 feet96 inches80,000 pounds534,000 pounds
Europe4 meters16.5 meters2.55 meters40 tonnes511.5 tonnes
Oceania4.3 meters19 meters2.44 meters42.5 tonnes611.5 tonnes
South America4 meters18.6 meters2.6 meters45 tonnes611.5 tonnes

*Trailer only for articulated or tractor/trailers

Choice 2: Select a vehicle routing profile

A Vehicle Routing Profile is a preset collection of vehicle dimensions and other routing options that ensure the routing algorithm knows the type of vehicle being driven so it can generate a safe, efficient, and legal route.

The best way to select a routing profile is by setting the profileName parameter when making a call to one of our routing APIs. Read more about how to select a profile.

Choice 3: Set your own dimensions

Custom vehicle dimensions can be set in the Routing APIs using the parameters in the tables below.

The Routing APIs also include a vehDimUnits (POST: Units) parameter, which allows you to decide whether to pass vehicle dimensions in your API requests in English/US Customary units or in metric units. It defaults to English for ALL worldwide regions.

We recommend setting vehDimUnits to Metric for regions outside of North America. Each parameter has an acceptable range of values. In North America, those ranges use English/US Customary units. In every other region, the ranges are in metric units.

North America

Use vehDimUnits default of English

ParametervehWeight
(POST: Weight)
vehHeight
(POST: Height)
vehLength
(POST: Length)
vehWidth
(POST: Width)
axles
(POST: Axles)
trkMaxWeightPerAxleGroup
(POST: MaxWeightPerAxleGroup)
North America Range26,000 to 156,700 pounds60 to 180 inches96 to 840 inches60 to 102 inches2 to 12800 to 45,000 pounds
Example (Data type and sample JSON value for POST requests)String
"132000"
String
decimal inches
"162"
String
decimal inches
"638.5"
String
decimal inches
"96"
Integer
8
Double
34000.00

Europe

Set vehDimUnits to Metric

ParametervehWeight
(POST: Weight)
vehHeight
(POST: Height)
vehLength
(POST: Length)
vehWidth
(POST: Width)
axles
(POST: Axles)
trkMaxWeightPerAxleGroup
(POST: MaxWeightPerAxleGroup)
Europe Range20 to 60 tonnes2 to 5 meters5 to 25 meters2 to 3 meters2 to 141 to 20 tonnes
Example (Data type and sample JSON value for POST requests)String
kilograms
“25000”
String
decimal meters
“4.11”
String
decimal meters
“16.15”
String
decimal meters
“2.5”
Integer
5
Double
11.5
Settings in the UK

While the UK officially uses the metric system, a truck’s height, length and width are still usually measured in English/Imperial units. To set dimensions in the UK:

  • Leave vehDimUnits set to the default of English.
  • Enter dimensions in English units. The available range of values is calculated by converting the metric values in Europe to English units.
ParametervehHeight
(POST: Height)
vehLength
(POST: Length)
vehWidth
(POST: Width)
Converted Range79 to 197 inches197 to 984 inches79 to 118 inches

South America

Set vehDimUnits to Metric

ParametervehWeight
(POST: Weight)
vehHeight
(POST: Height)
vehLength
(POST: Length)
vehWidth
(POST: Width)
axles
(POST: Axles)
trkMaxWeightPerAxleGroup
(POST: MaxWeightPerAxleGroup)
South America Range20 to 60 tonnes2 to 5 meters5 to 30 meters2 to 3 meters2 to 121 to 20 tonnes
Example (Data type and sample JSON value for POST requests)String
kilograms
“25000”
String
decimal meters
“4.11”
String
decimal meters
“16.15”
String
decimal meters
“2.5”
Integer
5
Double
11.5

Oceania

Set vehDimUnits to Metric

ParametervehWeight
(POST: Weight)
vehHeight
(POST: Height)
vehLength
(POST: Length)
vehWidth
(POST: Width)
axles
(POST: Axles)
trkMaxWeightPerAxleGroup
(POST: MaxWeightPerAxleGroup)
Oceania Range20 to 68 tonnes2 to 5 meters5 to 26 meters2 and 3 meters2 and 181 and 20 tonnes
Example (Data type and sample JSON value for POST requests)String
kilograms
“25000”
String
decimal meters
“4.11”
String
decimal meters
“16.15”
String
decimal meters
“2.5”
Integer
5
Double
11.5

Not routing a truck?

The ranges above are based on the default vehicle type, Truck. Smaller dimensions can be entered if you set vehType (POST: VehicleType) to LightTruck or Auto. If you are only ever routing trucks, you never need to set the vehicle type.

Things to keep in mind

  • If the vehicle is transporting hazardous materials, separate hazmat settings are required to ensure safe and legal routes.

  • While setting vehicle dimensions ensures a safe and legal route, there are many other route options available that allow you to customize how a vehicle is routed.

Last updated April 18, 2022.
Contents