Toll Cost Extension API Developer's Guide

Input parameter [vspec or alternative format]

Format

Truck specification as parameters or as list of semi-column ";" separated values (deprecated, no defaults allowed) The format is either: [vspec] or [tollVehicleType, trailerType, trailersCount, vehicleNumberAxles, trailerNumberAxles, hybrid, emissionType, height, trailerHeight, vehicleWeight, limitedWeight, disabledEquipped, minimalPollution, hov, passengersCount, tiresCount, commercial, shippedHazardousGoods, heightAbove1stAxle]

Description

Position in vspec string Parameter Name Description Default value
1 tollVehicleType Integer, Enum [1,2,3,4,5,6,7,8,9,10,11,12,13,14]
  • WORLD : [1=Motorcycle, 2=Auto, 3=Truck, 4=Motor home, 5=Minibus, 6=Bus, 13=Taxi]
  • EU ONLY : [7=Motorcycle Sidecar, 8=Tricycle]
  • EU/India ONLY : [9=Delivery Truck]
  • US ONLY : [10=Snowmobile]
  • US/India ONLY : [11=Pick-up, 12=Tractor]
  • India ONLY : [14=HCM/EME]
2=Auto
2 trailerType Integer, Enum [0,1,2]
  • [0=None, 1=Caravan, 2=Trailer]
0=None
3 trailersCount Integer, Enum [0,1,2,3]
  • if trailer type (param number 2) is 0 : must be 0
  • else : must be in [1=Truck with one more trailers, 2= Truck with two or more trailers, 3=Truck with three or more trailers]
0
4 vehicleNumberAxles Integer, must be > 0
  • number of vehicle's axles (not including trailer axles).
2
5 trailerNumberAxles Integer, 0 or more
  • if trailer type (param number 2) is 0 : must be 0
  • else : must be > 0
0
6 hybrid Integer, Enum [0,1]
  • set to 1 if the vehicle is partly running on electricity
  • set to 0 otherwise
0
7 emissionType Integer, Enum [1,2,3,4,5,6,7,8]
  • [1=EURO I, 2=EURO II, 3=EURO III, 4=EURO IV, 5=EURO V, 6=EURO VI, 7=EURO EEV, 8=Electric Vehicles]
0
8 height Number with unit, must be > 0
  • 350cm or 3.5m or 138in
0
9 trailerHeight Number, 0 or more
  • if trailer type (param number 2) is 0 : must be 0
  • else : must be > 0
  • 350cm or 3.5m or 138in
0
10 vehicleWeight Number, must be > 0
  • 7.5t or 7500kg or 16500lbs
0
11 limitedWeight Number, total weight of the vehicle including trailer(s) or caravan. Must be > 0
  • 7.5t or 7500kg or 16500lbs
0
12 disabledEquipped Integer, Enum [0,1]
  • set to 1 if the vehicle is specially equipped for transporting disabled people
  • set to 0 otherwise
0
13 minimalPollution Deprecated - parameter value must be specified (if using vpsec) but will be ignored. "Emission type" will be used instead to determine if the vehicle has minimal pollution in the context.  
14 hov Deprecated - parameter value must be specified (if using vspec) but will be ignored. "Number of passengers" is used instead to determine if the vehicle is a HOV in the context.  
15 passengersCount Integer, must be > 0 1
16 tiresCount Integer, must be > 0 4
17 commercial Integer, Enum [0,1]
  • set to 1 if the vehicle is designed for commercial use
  • set to 0 otherwise
0
18 shippedHazardousGoods Integer, Enum [0,1,2]
  • [0=None, 1=Explosives, 2=Any hazardous material]
0
- heightAbove1stAxle Number, must be > 0
  • 350cm or 3.5m or 138in
0

Example vspec vectors (deprecated)

Passenger car: vspec=2;0;0;2;0;0;5;167;0;1739;1739;0;0;0;2;4;0;0

7.5 ton truck: vspec=3;0;0;2;0;0;5;340;0;7500;7500;0;0;0;1;4;1;0

38 ton truck with trailer: vspec=3;2;1;2;3;0;5;400;400;24000;38000;0;0;0;1;6;1;0