vehicleprofile

The vehicleprofile namespace defines the VehicleProfile type which is part of the main profile.

Types

Defines the number of axles of the vehicle and the axle load.

Field Name Type Required Default Since Description
axleLoad Kilograms (Double) no 11500.0 2.0 The axle load. (2,4)

Categories: highPerformanceRouting

numberOfAxles NonNegativeInteger (Integer) no 5 2.0 The number of axles the vehicle has. (2)
numberOfTires NonNegativeInteger (Integer) no 10 2.27 The number of tires the vehicle has. (2,3)
Usually twice the number of axles, but it can be used to model vehicles such as motorbikes, tricycles or vehicles with twin wheels.

Dimensions

used by VehicleProfile, VehicleParametersAtWaypoint
since 2.0

Defines the size parameters of the vehicle, e.g. height, length, etc.

Field Name Type Required Default Since Description
height Dimension (Double) no 400.0 2.0 The vehicle's height. (2,4)

Categories: highPerformanceRouting

heightAboveFrontAxle Dimension (Double) no 400.0 2.0 The vehicle's height above the front axle. (2)
length Dimension (Double) no 1650.0 2.0 The vehicle's length. (2,4)

Categories: highPerformanceRouting

width Dimension (Double) no 254.0 2.0 The vehicle's width. (2,4)

Categories: highPerformanceRouting

kingpinToRearAxle Dimension (Double) no 0.0 (2.30) The distance from the kingpin to the rear axle of a semi-trailer truck. (2,4)

Categories: highPerformanceRouting

This field is experimental. Before using it, make sure you understand the implications of Experimental features.

Engine

used by VehicleProfile
since 2.0

Defines the engine parameters of the vehicle. These parameters are only relevant if the driveType is MOTOR_VEHICLE. Several parameters depend on each other so that inconsistent and ignored parameters will be reported in ResultLimitations. See the technical concept for details.

Field Name Type Required Default Since Description
engineType EngineType no EngineType.COMBUS ... 2.16 The engine type. Depending on the engine type only a subset of the other engine parameters is relevant. When changing the engine type further parameters must be specified to define a valid vehicle and to obtain proper results. For a hybrid or an electric vehicle electricityType and electricityConsumption must be specified, for a hybrid vehicle additionally the hybridRatio. (1)
cylinderCapacity CylinderCapacity (Integer) no 12000 2.0 The cylinder capacity. Only relevant for COMBUSTION and HYBRID vehicles. (2,3)
fuelType FuelType no FuelType.DIESEL 2.0 The type of fuel (gasoline, diesel, etc.). The fuel types CNG_GASOLINE and LNG_GASOLINE are used for dual-fuel vehicles, therefore the dualFuelRatio has to be specified. These fuel types cannot be used with hybrid vehicles. Only relevant for COMBUSTION and HYBRID vehicles. (3)
electricityType ElectricityType no ElectricityType.NONE 2.27 The electricity type. Only relevant for ELECTRIC and HYBRID vehicles. (3)
bioFuelRatio Percent (Double) no 0.0 2.0 The ratio of biofuel to conventional fuel, only supported for the fuel types GASOLINE, DIESEL, CNG_GASOLINE and LNG_GASOLINE. (3)
hybridRatio Percent (Double) no 0.0 2.27 The ratio between ELECTRIC and COMBUSTION source for HYBRID vehicles. (3)
dualFuelRatio Percent (Double) no 0.0 2.27 The ratio between LPG/CNG and GASOLINE fuels for dual-fuel vehicles. (3)
fuelConsumption EnergyConsumption (Double) no 35.0 2.0 The fuel consumption for engine type COMBUSTION and HYBRID [l/100km or kg/100km]. See the technical concept for details on the units, in particlar for dual-fuel engines. (1,3)
electricityConsumption EnergyConsumption (Double) no 0.0 2.27 The electricity consumption for engine type ELECTRIC and HYBRID [kWh/100km]. (1,3)
consumptionFactorsPerSpeed ConsumptionFactorAtSpeed[] 0..* - 2.27 The consumption factors relative to Engine.fuelConsumption and Engine.electricityConsumption of the engine at different speeds (1).
It is used for monetary cost optimized routing to assign energy costs to road segments in the following way:
  1. Use linear interpolation to calculate the fuel/electricity consumption factor for the speed of the segment.
  2. Calculate the actual fuel/electricity consumption for the segment speed by multiplying the Engine.fuelConsumption/Engine.electricityConsumption, with the previously interpolated consumption factor.
  3. Calculate the amount of used fuel/electricity for the road segment with its distance.
  4. Calculate the fuel/electricity cost by multiplying the amount of used fuel/electricity with the MonetaryCostOptions.costPerFuelUnit and MonetaryCostOptions.costPerElectricityUnit.
Default as list of pairs {speed, consumption factor}: {10, 1.7}, {30, 1.5}, {50, 1.0}, {70, 0.8}, {80, 0.8}, {90, 1.0}, {100, 1.7}.
emissionTechnology EmissionTechnology no EmissionTechnolog ... 2.0 The emission technology (only relevant for some emission classes). Only relevant for COMBUSTION and HYBRID vehicles. (3)
particleFilterInstalled Boolean no false 2.0 Describes if a particle filter is installed. Only relevant for COMBUSTION and HYBRID vehicles. (2)
particleReductionClass ParticleReductionClass no ParticleReduction ... 2.0 The particle reduction class (Partikelminderungsklasse) according to "Anlage XIV zu § 48 StVZO" (German law). Only relevant for COMBUSTION and HYBRID vehicles. (2)
emissionStandardEU EmissionStandardEU no EmissionStandardE ... 2.0 The emission standard valid in the European Union. Only relevant for COMBUSTION and HYBRID vehicles. (2,3)
emissionStandardAustralia EmissionStandardAustralia no EmissionStandardA ... 2.0 The emission standard valid in Australia. Only relevant for COMBUSTION and HYBRID vehicles. (2,3)
lowEmissionZoneTypes CommaSeparatedList (String) no - 2.0 Describes the low emission zone sticker types on the windscreen of the vehicle as a comma-separated list. The available sticker types can be requested through the xRuntime service and are documented in the manual as layer-specific properties of the feature layer PTV_LowEmissionZones. Use the value NONE, if you have none of the available stickers on the vehicle's windscreen (means a blank windscreen). The treatment of road segments that are not allowed because of the low emission zone type is controlled by the penalty value forbiddenLowEmissionZonePenalty. (1)

Categories: highPerformanceRouting

lowEmissionZoneExemptions CommaSeparatedList (String) no NONE (2.30) The low-emission zone exemptions of the vehicle as a comma-separated list. The exemptions allow to enter a zone even if the criteria of the vehicle does not allow it. The available zones can be requested through the xRuntime service. (1)

Categories: highPerformanceRouting

This field is experimental. Before using it, make sure you understand the implications of Experimental features.

co2EmissionClassEU Co2EmissionClassEU (Integer) no 1 2.31 The CO₂ emission class valid in the European Union. See also the Directive 1999/62/EC of the European Parliament and of the Council on the charging of heavy goods vehicles for the use of certain infrastructures, article 7ga. (2)

LegalCondition

used by VehicleProfile
since 2.0

Defines a legal condition of the vehicle, e.g. whether the vehicle is delivering goods or is an emergency vehicle.

Field Name Type Required Default Since Description
isEmergency Boolean no false 2.0 True for emergency vehicles. If this condition is set to true, certain parts of the road network that are prohibited except that emergency vehicles are accessible for the routing algorithm, and these parts are then treated exactly the same way as normal parts of the road network that are not prohibited. This setting affects segments which have set RoadAttributes.allowedForEmergency. (1)

Categories: highPerformanceRouting

isDelivery Boolean no true 2.0 True for vehicles which are intended to deliver something. If this condition is set to true, certain parts of the road network that are prohibited except for delivery vehicles are accessible for the routing algorithm. The treatment of such parts can be configured in the routing profile using the parameters SpecialAreas.deliveryOnlyPenalty and SpecialAreas.deliveryOnlyGateCost. These settings affect segments which have set RoadAttributes.deliveryOnly. (1,4)

Categories: highPerformanceRouting

Defines the current load of the vehicle

Field Name Type Required Default Since Description
hazardousGoodsTypes CommaSeparatedList (String) no NONE 2.0 Specifies the hazardous goods types of the load as a comma-separated list (only if the feature layer PTV_TruckAttributes is enabled). The available types can be requested through the xRuntime service and are documented in the manual as layer-specific properties of the feature layer PTV_TruckAttributes. (4)

Categories: highPerformanceRouting

loadType LoadType no LoadType.GOODS 2.0 The load type of the vehicle, e.g. passengers or goods, etc. This parameter is important to derive the type of the vehicle. For example, if the vehicle's weight is about 10 tons, then the load type can help to determine whether the vehicle is a truck or a bus. (1,2,3,4)

Categories: highPerformanceRouting

tunnelRestrictionCode TunnelRestrictionCode no TunnelRestriction ... 2.0 The tunnel restriction code for dangerous load. (4)

Categories: highPerformanceRouting

SpeedRangesByNetworkClass

used by Speeds
since 2.0

Defines the speed intervals for each network class. The road segments of a network class are classified into subtypes which are automatically assigned a speed value from the interval. If speed information from a feature layer such as PTV_SpeedPatterns or PTV_TrafficIncidents is available for a segment it overrides the speed defined here. (1)

Field Name Type Required Default Since Description
maximumSpeeds Speed[] (Double[]) 8..8 - 2.0 The maximum speeds for each network class. Default: 80,65,55,45,40,30,30,30.

Categories: highPerformanceRouting

minimumSpeeds Speed[] (Double[]) 8..8 - 2.0 The minimum speeds for each network class. Default: 55,30,23,20,18,15,15,15.

Categories: highPerformanceRouting

Speeds

used by VehicleProfile
since 2.0

Defines the speed values used by the routing algorithm to calculate the travel time of a road segment. All speed values given here are internally rounded to km/h.

Field Name Type Required Default Since Description
speedRangesByNetworkClass SpeedRangesByNetworkClass no - 2.0 Defines the speed intervals for each network class. The road segments of a network class are classified into subtypes which are automatically assigned a speed value from the interval. If speed information from a feature layer such as PTV_SpeedPatterns or PTV_TrafficIncidents is available for a segment it overrides the speed defined here. (1)
speedForLinkDistance Speed (Double) no 15.0 2.0 The notional speed for the distance from a waypoint to its link point on the road network. (1)
maximumSpeed Speed (Double) no 255.0 2.0 The absolute maximum speed for all road segments. The speeds calculated from the interval [minimumSpeed, maximumSpeed] for each network class, will be limited to this speed value. Note: an interval [70,135] for network class 0 with a maximum speed of 120 km/h is not equal to the interval [70,120]. A maximum speed of 0 is ignored. (1)

Categories: highPerformanceRouting

VehicleProfile

used by RequestProfile, ProfileResponse
since 2.0

Defines the vehicle to be used which activates rules of different algorithms. Please note that all values apply to the complete vehicle including trailers. Note that the results may be incorrect because the legal definition of a vehicle type may differ from country to country and it may also differ from the technical definition. As an example, a truck with a weight of 7.5 tons is a truck by legal definition in Germany but is not a truck by definition of toll. Most parameters are used for several use cases. They are denoted with (1) for routing, (2) for toll, (3) for emission calculation, (4) for truck attributes, and (5) for preferred routes. Give as many details on the vehicle as possible in order to obtain the best result.

Field Name Type Required Default Since Description
engine Engine no - 2.0 Defines the engine parameters of the vehicle. These parameters are only relevant if the driveType is MOTOR_VEHICLE.
weight Weight no - 2.0 Defines the weight parameters of the vehicle. The actual weight of the vehicle is the sum of the empty weight and the load weight.
dimensions Dimensions no - 2.0 Defines the size parameters of the vehicle, e.g. height, length, etc.
axle Axle no - 2.0 Defines the number of axles of the vehicle and the axle load.
legalCondition LegalCondition no - 2.0 Defines a legal condition of the vehicle, e.g. whether the vehicle is delivering goods or is an emergency vehicle.
load Load no - 2.0 Defines the current load of the vehicle
speeds Speeds no - 2.0 Defines the speed values used by the routing algorithm to calculate the travel time of a road segment. All speed values given here are internally rounded to km/h.
driveType DriveType no DriveType.MOTOR_V ... 2.0 The type of the vehicle, e.g. motorized, pedestrian, etc. (1,2,3,4)

Categories: highPerformanceRouting

yearOfManufacture PositiveInteger (Integer) no 2015 2.0 The vehicle's construction year. (3)
numberOfPassengers PositiveInteger (Integer) no 1 2.0 The actual number of passengers including the driver. (2)
numberOfTrailers NonNegativeInteger (Integer) no 0 2.0 The number of trailers. (2,3,4)

Categories: highPerformanceRouting

preferredRouteTypes CommaSeparatedList (String) no NONE 2.0 The road networks to be preferred by the routing algorithm as a comma-separated list (only if the feature layer PTV_PreferredRoutes is enabled). The available types can be requested through the xRuntime service and are documented in the manual as layer-specific properties of the feature layer PTV_PreferredRoutes. (5)

Categories: highPerformanceRouting

unrestrictedRouteTypes CommaSeparatedList (String) no NONE 2.20 The road networks without restrictions as a comma-separated list (only if the feature layer PTV_PreferredRoutes is enabled). The available types can be requested through the xRuntime service and are documented in the manual as layer-specific properties of the feature layer PTV_PreferredRoutes. (5)

Categories: highPerformanceRouting

restrictedRouteTypes CommaSeparatedList (String) no NONE 2.2 The road networks that should be avoided as far as possible, e.g. for convenience reasons, as a comma-separated list (only if the feature layer PTV_PreferredRoutes is enabled). The available types can be requested through the xRuntime service and are documented in the manual as layer-specific properties of the feature layer PTV_PreferredRoutes. (5)

Categories: highPerformanceRouting

highlyRestrictedRouteTypes CommaSeparatedList (String) no NONE 2.2 The road networks that must be avoided, e.g. due to legal limitations, as a comma-separated list (only if the feature layer PTV_PreferredRoutes is enabled). The available types can be requested through the xRuntime service and are documented in the manual as layer-specific properties of the feature layer PTV_PreferredRoutes. (5)

Categories: highPerformanceRouting

prohibitedRouteTypes CommaSeparatedList (String) no NONE 2.0 The road networks that are prohibited for the vehicle as a comma-separated list (only if the feature layer PTV_PreferredRoutes is enabled). The available types can be requested through the xRuntime service and are documented in the manual as layer-specific properties of the feature layer PTV_PreferredRoutes. (5)

Categories: highPerformanceRouting

electronicTollCollectionSubscriptions CommaSeparatedList (String) no NONE 2.16 The subscriptions for electronic toll collection systems the vehicle can use as a comma-separated list (only if toll is enabled). The available types can be requested through the xRuntime service and are returned in TollFeatures.electronicTollCollectionSubscriptions for the map and in TollFeatures.electronicTollCollectionSubscriptions for a country or subdivision. (2)

Weight

used by VehicleProfile, VehicleParametersAtWaypoint
since 2.0

Defines the weight parameters of the vehicle. The actual weight of the vehicle is the sum of the empty weight and the load weight.

Field Name Type Required Default Since Description
emptyWeight Kilograms (Double) no 15000.0 2.0 The empty weight. (3,4)

Categories: highPerformanceRouting

loadWeight Kilograms (Double) no 25000.0 2.0 The weight of the vehicle's load. Note that emptyWeight + loadWeight <= totalPermittedWeight, otherwise a ParameterInconsistencyLimitation is returned with the response. (3,4)

Categories: highPerformanceRouting

totalPermittedWeight Kilograms (Double) no 40000.0 2.0 The total permitted weight. (1,2,3,4)

Categories: highPerformanceRouting

Enumeration

DriveType

used by VehicleProfile
since 2.0

Defines the type of drive.

Enumeration Value Since Description
MOTOR_VEHICLE 2.0 All common motor vehicles, e.g. cars, trucks, motorcycles etc.
BICYCLE 2.0 Bicycles and other vehicles with very limited engines such as e-bikes or mopeds.
PEDESTRIAN 2.0 Pedestrians.
Enumeration

ElectricityType

used by Engine
since 2.27

Defines the electricity type for electric or hybrid vehicles.

Enumeration Value Since Description
BATTERY 2.27 Battery.
HYDROGEN_FUEL_CELL 2.27 Hydrogen Fuel Cell.
NONE 2.27 No electricity type. For non-motorized and non-electric vehicles.
Enumeration

EmissionStandardAustralia

used by Engine
since 2.0

Defines the emission standard of the vehicle valid in Australia.

Enumeration Value Since Description
NONE 2.0 The vehicle is not assigned an emission standard for Australia.
ADR_30 2.0 Australian design rule 30.
ADR_70_00 2.0 Australian design rule 70/00.
ADR_80_00 2.0 Australian design rule 80/00.
ADR_80_02 2.0 Australian design rule 80/02.
ADR_80_03 2.0 Australian design rule 80/03.
ADR_80_04 2.0 Australian design rule 80/04.
ADR_80_05 2.0 Australian design rule 80/05.
Enumeration

EmissionStandardEU

used by Engine
since 2.0

Defines the emission standard of the vehicle valid in the European Union.

Enumeration Value Since Description
NONE 2.0 The vehicle is not assigned an emission standard for the European Union.
EURO_0 2.0 Euro 0 standards (old standards 1988-1992).
EURO_1 2.0 Euro 1 standards (also known as EC 93): Directives 91/441/EEC (passenger cars only) or 93/59/EEC (passenger cars and light trucks).
EURO_2 2.0 Euro 2 standards (EC 96): Directives 94/12/EC and 96/69/EC for passenger cars, 2002/51/EC(row A)-2006/120/EC for motorcycle.
EURO_3 2.0 Euro 3 standards (2000): Directives 98/69/EC for any vehicle, 2002/51/EC(row A)-2006/120/EC for motorcycle.
EURO_4 2.0 Euro 4 standards (2005): Directives 98/69/EC and 2002/80/EC for any vehicle.
EURO_5 2.0 Euro 5 standards (2008/9): Directive 715/2007/EC for any vehicle.
EURO_EEV 2.0 Standards for enhanced environmentally friendly vehicles. The standard lies between the levels of Euro V and Euro VI.
EURO_6 2.0 Euro 6 standards (2014): Directive 715/2007/EC for any vehicle. Includes 6a and 6b.
EURO_6c 2.0 Euro 6c standards (2017): for passenger cars and light trucks.
EURO_6d_TEMP 2.27 Euro 6d-temp standards (2017): for passenger cars and light trucks.
EURO_6d 2.27 Euro 6d standards (2020): for passenger cars and light trucks.
EURO_6e 2.27 Euro 6e standards (2022): for bus and trucks.
EURO_7 2.0 Euro 7 standards (to appear 2025).
Enumeration

EmissionTechnology

used by Engine
since 2.0

Defines the emission reduction technology of the vehicle (from HBEFA).

Enumeration Value Since Description
NONE 2.0 No emission reduction technology.
EXHAUST_GAS_RECIRCULATION 2.0 Exhaust gas recirculation technology.
SELECTIVE_CATALYTIC_REDUCTION 2.0 Selective catalytic reduction.
Enumeration

EngineType

used by Engine
since 2.16

Defines the engine type of the vehicle.

Enumeration Value Since Description
COMBUSTION 2.16 Combustion. Further distinction by FuelType.
ELECTRIC 2.16 Electric. Further distinction by ElectricityType.
HYBRID 2.27 Vehicles with more than one type.
NONE 2.27 No engine. For non-motorized vehicles, e.g bicycle.
Enumeration

FuelType

used by Engine
since 2.0

Defines the fuel type of the vehicle.

Enumeration Value Since Description
GASOLINE 2.0 Gasoline (also known as petrol or benzine).
DIESEL 2.0 Diesel.
COMPRESSED_NATURAL_GAS 2.0 Compressed natural gas.
LIQUEFIED_PETROLEUM_GAS 2.0 Liquefied petroleum gas.
LIQUEFIED_NATURAL_GAS 2.27 Liquefied natural gas.
CNG_GASOLINE 2.27 Compressed natural gas with gasoline. Not for hybrid vehicles.
LPG_GASOLINE 2.27 Liquefied petroleum gas with gasoline. Not for hybrid vehicles.
ETHANOL 2.27 Ethanol.
NONE 2.27 No conventional fuel. For non-motorized and non-combustion vehicles.
Enumeration

LoadType

used by Load
since 2.0

Defines the type of load and is mainly used to differentiate between cars and trucks. This setting controls the road blocks in the road network and the calculation of other mostly vehicle-dependent values such as toll and emissions.

Enumeration Value Since Description
PASSENGER 2.0 The vehicle transports passengers.
GOODS 2.0 The vehicle transports goods.
Enumeration

ParticleReductionClass

used by Engine
since 2.0

Defines the particle reduction class (Partikelminderungsklasse) according to "Anlage XIV zu § 48 StVZO" (German law).

Enumeration Value Since Description
NONE 2.27 No Particle reduction class.
PMK_0 2.0 Particle reduction class PMK 0.
PMK_1 2.0 Particle reduction class PMK 1.
PMK_2 2.0 Particle reduction class PMK 2.
PMK_3 2.0 Particle reduction class PMK 3.
PMK_4 2.0 Particle reduction class PMK 4.
Enumeration

TunnelRestrictionCode

used by Load
since 2.0

Defines the main tunnel restriction codes according to ADR ("European Agreement Concerning the International Carriage of Dangerous Goods by Road"). There are some more restriction codes that are a combination of the main codes where the actual restriction code depends on other parameters of the vehicle and its load. For example, the restriction code B/D is B for tank carriage and D for other carriage.

Enumeration Value Since Description
NONE 2.0 No restrictions for the transport of dangerous goods.
B 2.0 Passage forbidden through tunnels of category B, C, D and E.
C 2.0 Passage forbidden through tunnels of category C, D and E.
D 2.0 Passage forbidden through tunnels of category D and E.
E 2.0 Passage forbidden through tunnels of category E.

Diagrams

Vehicle Profile