Vehicle Restrictions

Vehicle restrictions are used commonly for trucks, delivery vans, and scooter drivers. Climate/pollution regulations are also introducing more rules for cars, such as electric vehicles (EVs) and cars that fail to meet various low-emission vehicle requirements.

The SDK provides the ability to apply those restrictions based on the user-defined vehicle profile.

The Vehicle Restrictions API is available under the TomTomMap object. To enable vehicle restrictions in your app, load the pre-defined StandardStyles.VEHICLE_RESTRICTIONS.

1tomTomMap.loadStyle(
2    StandardStyles.VEHICLE_RESTRICTIONS,
3    onStyleLoadedCallback
4)

The next step is to define your vehicle. This can be done using the Vehicle model

1val truck = Vehicle.Truck(
2    dimensions = VehicleDimensions(
3        weight = Weight.kilograms(6420),
4        axleWeight = Weight.kilograms(2200),
5        length = Distance.centimeters(805),
6        width = Distance.centimeters(260),
7        height = Distance.centimeters(330)
8    ),
9    // You can define characteristics of your vehicle's load like Hazmat and ADR
10    hazmatClasses = setOf(
11        HazmatClass.IntlExplosive,
12        HazmatClass.UnClass1Explosive,
13        HazmatClass.UnClass2Gas,
14        HazmatClass.UnClass3FlammableLiquid
15    ),
16    adrTunnelRestrictionCode = AdrTunnelRestrictionCode.B
17)

To show restrictions:

tomTomMap.showVehicleRestrictions(truck)

To hide restrictions:

tomTomMap.hideVehicleRestrictions()

To apply changes after updating the vehicle parameters:

val newDimension = truck.dimensions?.copy(weight = Weight.kilograms(8000))
tomTomMap.updateVehicle(truck.copy(dimensions = newDimension))

Low-emission zone

A low-emission zone is an area that restricts access to vehicles based on the level of pollutants they emit. By default, you can enable a low-emission zone using the pre-defined style StandardStyles.VEHICLE_RESTRICTIONS.

Supported vehicle restriction types

The following table shows the supported vehicle restriction types:

UN dangerous goods class

The UN dangerous goods class describes the categories of dangerous cargo as follows:

You can find those categories defined here HazmatClass.

Next steps

Since you have learned how to work with vehicle restrictions, here are recommendations for next steps:

• Route planning
• Map overlays
• Show traffic on the map