Regional settings

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:

Routing APIs

region parameter

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 parameter

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_EU
• PCM_OC
• PCM_SA
• PCM_ME
• PCM_AS
• PCM_AF
• PCM_WW (Worldwide)

Vehicle dimensions

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.

Hazardous materials routing

In addition to the HazMatType or HazMatTypes parameters, ADR hazmat tunnel restriction codes can be set for routing in Europe with the tunnelCategory or tunnelCategories parameters. Options are:

• 0 - None (Default)
• 1 - TunnelBCDE
• 2 - TunnelCDE
• 3 - TunnelDE
• 4 - TunnelE

Language settings

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.

Toll cost calculations

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

Greenhouse gas emissions

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)

Environmental zones

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:

• Allow the route to pass through the zone (Default).
• Avoid the zone and route around it.
• Warn that the route enters the zone.

Location APIs

The Single Search or Single Search Batch Geocoding APIs should be used for all geocoding calls.

region parameter

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

Language settings

The language used in results defaults to English, but it can be set to a wide range of languages using the lang parameter.