The vehicleprofile namespace defines the VehicleProfile type which is part of the main profile.
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.26) | 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. This field is experimental. Before using it, make sure you understand the implications of Experimental features. |
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 |
Defines the engine parameters of the vehicle. These parameters are only relevant if the driveType is MOTOR_VEHICLE.
| Field Name | Type | Required | Default | Since | Description |
|---|---|---|---|---|---|
| electricitySource | ElectricitySource | no | ElectricitySource ... | (2.26) | The electricity source. Only relevant for ELECTRIC or HYBRID vehicles. This field is experimental. Before using it, make sure you understand the implications of Experimental features. |
| engineType | EngineType | no | EngineType.COMBUS ... | 2.16 | The engine type. Depending on the engine type only a subset of the other engine parameters are relevant. (1) |
| cylinderCapacity | CylinderCapacity (Integer) | no | 12000 | 2.0 | The cylinder capacity. (2,3) |
| fuelType | FuelType | no | FuelType.DIESEL | 2.0 | The type of fuel (gasoline, diesel, etc.). (3) |
| bioFuelRatio | Percent (Double) | no | 0.0 | 2.0 | The ratio of biofuel to conventional fuel. (3) |
| hybridRatio | Percent (Double) | no | 0.0 | (2.26) | The ratio between ELECTRIC and COMBUSTION source for HYBRID vehicles. (3) This field is experimental. Before using it, make sure you understand the implications of Experimental features. |
| fuelConsumption | EnergyConsumption (Double) | no | 35.0 | 2.0 | The fuel consumption for engine type COMBUSTION and HYBRID [l/100km or kg/100km]. (1,3) |
| energyConsumption | EnergyConsumption (Double) | no | 0.0 | (2.26) | The electric energy consumption for engine type ELECTRIC and HYBRID [kWh/100km]. (1,3) This field is experimental. Before using it, make sure you understand the implications of Experimental features. |
| consumptionFactorsPerSpeed | ConsumptionFactorAtSpeed[] | 0..* | - | (2.23) | The consumption factors relative to Engine.fuelConsumption and Engine.energyConsumption 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:
This field is experimental. Before using it, make sure you understand the implications of Experimental features. |
| emissionTechnology | EmissionTechnology | no | EmissionTechnolog ... | 2.0 | The emission technology (only relevant for some emission classes). (3) |
| particleFilterInstalled | Boolean | no | false | 2.0 | Describes if a particle filter is installed. (2) |
| particleReductionClass | ParticleReductionClass | no | ParticleReduction ... | 2.0 | The particle reduction class (Partikelminderungsklasse) according to "Anlage XIV zu § 48 StVZO" (German law). (2) |
| emissionStandardEU | EmissionStandardEU | no | EmissionStandardE ... | 2.0 | The emission standard valid in the European Union. (2,3) |
| emissionStandardAustralia | EmissionStandardAustralia | no | EmissionStandardA ... | 2.0 | The emission standard valid in Australia. (2,3) |
| lowEmissionZoneTypes | CommaSeparatedList (String) | no | DE_GREEN | 2.0 | The low-emission zone types of the vehicle as a comma-separated list. The treatment of road segments that are not allowed because of the low-emission zone type is controlled by the penalty value forbiddenLowEmissionZonePenalty. Available types are DE_GREEN, DE_YELLOW, DE_RED for Germany. (1) Categories: highPerformanceRouting |
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 |
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 |
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 |
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) |
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 |
Defines the electricity source for electric or hybrid vehicle.
This enumeration is experimental. Before using it, make sure you understand the implications of Experimental features.
| Enumeration Value | Since | Description |
|---|---|---|
| BATTERY | (2.26) | Battery. This enumeration value is experimental. Before using it, make sure you understand the implications of Experimental features. |
| HYDROGEN_FUEL_CELL | (2.26) | Hydrogen Fuel Cell. This enumeration value is experimental. Before using it, make sure you understand the implications of Experimental features. |
| NONE | (2.26) | No electricity source. For combustion based vehicles. This enumeration value is experimental. Before using it, make sure you understand the implications of Experimental features. |
Defines the emission standard of the vehicle valid in Australia.
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.26) | Euro 6d-temp standards (2017): for passenger cars and light trucks. This enumeration value is experimental. Before using it, make sure you understand the implications of Experimental features. |
| EURO_6d | (2.26) | Euro 6d standards (2020): for passenger cars and light trucks. This enumeration value is experimental. Before using it, make sure you understand the implications of Experimental features. |
| EURO_6e | (2.26) | Euro 6e standards (2022): for bus and trucks. This enumeration value is experimental. Before using it, make sure you understand the implications of Experimental features. |
| EURO_7 | 2.0 | Euro 7 standards (to appear 2025). |
Defines the engine type of the vehicle.
| Enumeration Value | Since | Description |
|---|---|---|
| COMBUSTION | 2.16 | Combustion. Further distinction by FuelType. |
| ELECTRIC | 2.16 | Electric. Includes energy sources like battery or hydrogen fuel cell. |
| HYBRID | (2.26) | Vehicles with more than one type. This enumeration value is experimental. Before using it, make sure you understand the implications of Experimental features. |
| NONE | (2.26) | No engine. For non-motorised vehicle, e.g bicycle. This enumeration value is experimental. Before using it, make sure you understand the implications of Experimental features. |
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.26) | Liquefied natural gas. This enumeration value is experimental. Before using it, make sure you understand the implications of Experimental features. |
| CNG_GASOLINE | (2.26) | Compressed natural gas with gasoline. This enumeration value is experimental. Before using it, make sure you understand the implications of Experimental features. |
| LPG_GASOLINE | (2.26) | Liquefied petroleum gas with gasoline. This enumeration value is experimental. Before using it, make sure you understand the implications of Experimental features. |
| ETHANOL | (2.26) | Ethanol. This enumeration value is experimental. Before using it, make sure you understand the implications of Experimental features. |
| NONE | (2.26) | No conventional fuel. For non-motorised and electric vehicles. This enumeration value is experimental. Before using it, make sure you understand the implications of Experimental features. |
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.
Defines the particle reduction class (Partikelminderungsklasse) according to "Anlage XIV zu § 48 StVZO" (German law).
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.