The Trimble Maps APIs provide maps, location data and routing for commercial vehicles in locations around the world. If you are working in regions outside of North America, regional settings are sometimes required to ensure the best results. These settings include:
The data region where you are calculating routes must be specified for locations outside of North America. Options are:
- 0 - Unknown
- 1 - AF
- 2 - AS
- 3 - EU
- 4 - NA (Default)
- 5 - OC
- 6 - SA
- 7 - ME
DataVersion instructs the routing algorithm to use the data for which your API key is licensed. For example, if you are routing in Europe, it should be set to
PCM_EU. Options are:
- PCM_WW (Worldwide)
The default vehicle dimensions used in route calculations are different in different parts of the world, in order to reflect the regional specific rules and industry standards. Read more about setting vehicle dimensions.
In addition to the
HazMatTypes parameters, ADR hazmat tunnel restriction codes can be set for routing in Europe with the
tunnelCategories parameters. Options are:
- 0 - None (Default)
- 1 - TunnelBCDE
- 2 - TunnelCDE
- 3 - TunnelDE
- 4 - TunnelE
The language used in reports defaults to English in all regions but can be changed using the
lang (GET requests) or
Language (POST requests) parameter.
See a list of languages available.
For truck toll calculation in Europe, the vehicle profile needs to be set up accurately in order to get a precise result as toll rates are usually based on vehicle specific parameters of the truck and trailer.
Read more about settings for tolls in Europe. The currency in which toll costs are reported can also be set using the
tollCurrency parameter. Options are:
- 2- ALL - Albanian lek
- 3 -AMD - Armenian dram
- 4 - AZN - Azerbaijani manat
- 5 - BAM - Bosnia and Herzegovina convertible mark
- 6 - BGN - Bulgarian lev
- 7 - BYR - Belarusian ruble
- 8 - CHF - Swiss franc
- 9 - CZK - Czech koruna
- 10 - DKK - Danish krone
- 11 - EUR - Euros
- 12 - GBP - Pound sterling
- 13 - GEL - Georgian lari
- 14 - HRK - Croatian kuna
- 15 - HUF - Hungarian forint
- 16 - ISK - Icelandic króna: second króna
- 17 - MDL - Moldovan leu
- 18 - MKD - Second Macedonian denar
- 19 - NOK - Norwegian krone
- 20 - PLN - Polish złoty
- 21 - RON - Fourth Romanian leu
- 22 - RSD - Serbian dinar
- 23 - RUB - Russian ruble
- 24 - SEK - Swedish krona
- 25 - TRY - Turkish lira
- 26 - UAH - Ukrainian hryvnia
Three additional parameters must be set to calculate estimated greenhouse gas emissions for routes in Europe. The calculation is using the tank-to-wheel part of the European Norm 16258. The parameters are:
FuelConsumption, which is the amount of fuel a vehicle consumes in liters per 100 km. If set to
0, a default fuel consumption value is used, fitting the vehicle type and weight class as defined by the vehicle profile options. This default value represents an assumed average fuel consumption specific for the vehicle class, defined by the UK DEFRA 2018.
Refrigerated, which indicates whether the truck trailer is refrigerated. Default is ’no’. This parameter is only relevant when the default fuel consumption is being used (see above), in order to reflect the higher fuel consumption of refrigerated vehicles as defined by the UK DEFRA 2018.
FuelType, which is the type of fuel used. Options are:
- 0 - FuelType_Petrol
- 1 - FuelType_Petrol_E5 (5% ethanol by vol)
- 2 - FuelType_Petrol_E10 (10% ethanol by vol)
- 3 - FuelType_Ethanol
- 4 - FuelType_Diesel (Default)
- 5 - FuelType_Biodiesel
- 6 - FuelType_Diesel_D5 (5% biodiesel by vol)
- 7 - FuelType_Diesel_D7 (7% biodiesel by vol)
In the UK, routes can take into consideration a CongestionZone, a LowEmissionZone, or an UltraLowEmissionZone. The routing algorithm can be set to handles these zones one of three ways:
Allowthe route to pass through the zone (Default).
Avoidthe zone and route around it.
Warnthat the route enters the zone.
The data region where you are routing must be specified for locations outside of North America. Options are: NA, WW, EU, AS, AF, SA, OC
The language used in results defaults to English, but it can be set to a
wide range of languages using the