Search for content

Vehicle Parameters

The Routing API offers a detailed parameterization in case the vehicle used does not correspond to one of the predefined profiles.

Engine type

The Routing API supports alternative drive train configuration, the user can select one of the available engine types: COMBUSTION, HYBRID or ELECTRIC. Depending on the chosen engine type, several other vehicle parameters must be defined to better match the vehicle specific configuration.

Engine type COMBUSTION

Engine type COMBUSTION requires fuelType and averageFuelConsumption to be specified.

Engine type ELECTRIC

Engine type ELECTRIC requires electricityType and averageElectricityConsumption to be specified.

Engine type HYBRID

Engine type HYBRID requires hybridRatio and all required parameters of COMBUSTION and ELECTRIC to be specified.

Whenever such a parameter is missing, a warning will be returned with the warning code ROUTING_MISSING_VEHICLE_PARAMETER. We recommend always to specify all relevant vehicle parameters, otherwise results like emissions, toll, or the monetary cost report may be incomplete or contain wrong results.

When specifying a parameter not supported by the engine type, a warning with the warning code GENERAL_PARAMETER_IGNORED will be returned. This warning has no effect on the response, but the parameter in question should be removed from the request.

Fuel type

The fuel types CNG_GASOLINE and LPG_GASOLINE require the dualFuelRatio to be specified, and these fuel types are only allowed for engineType COMBUSTION.

The bioFuelRatio is supported ony for the fuelTypes DIESEL, GASOLINE, CNG_GASOLINE or LPG_GASOLINE

Fuel Consumption

The engine's averageFuelConsumption denotes the effective fuel consumed by the vehicle per 100km. Depending on the fuelType, it should be expressed in the following units:

  • l/100km : for fuel types DIESEL, GASOLINE, LIQUEFIED_PETROLEUM_GAS, LPG_GASOLINE and ETHANOL.
  • kg/100km : for fuel types COMPRESSED_NATURAL_GAS, LIQUEFIED_NATURAL_GAS and CNG_GASOLINE.

Engines that can operate using a mixture of two different fuels are called dual fuel engines. The Routing API supports LPG_GASOLINE and CNG_GASOLINE along with the dualFuelRatio. This ratio denotes the consumption of CNG/LPG fuel type from the total amount of the vehicle consumption per 100km.

For LPG_GASOLINE, the fuel consumption should be given as l/100km and can be computed as following :

  • averageFuelConsumption LPG_GASOLINE [l/100km] = averageFuelConsumption LIQUEFIED_PETROLEUM_GAS [l/100km] + averageFuelConsumption GASOLINE [l/100km] 
  • dualFuelRatio = averageFuelConsumption LIQUEFIED_PETROLEUM_GAS [l/100km] / averageFuelConsumption LPG_GASOLINE [l/100km] 

For CNG_GASOLINE, the fuel consumption should be given as kg/100km and can be computed as following :

  • averageFuelConsumption CNG_GASOLINE [kg/100km] = averageFuelConsumption COMPRESSED_NATURAL_GAS [kg/100km] + density GASOLINE [kg/l] * averageFuelConsumption GASOLINE [l/100km] 
  • with density GASOLINE [kg/l] = 0.743
  • and dualFuelRatio = averageFuelConsumption COMPRESSED_NATURAL_GAS [kg/100km] / averageFuelConsumption CNG_GASOLINE [kg/100km].

Engine type related parameters

Engine Parameter/EngineTypeCOMBUSTIONHYBRIDELECTRIC
fuelTypeAll values except NONEAll fuel types except NONE, CNG_GASOLINE and LPG_GASOLINENONE
electricityTypeNONEAll values except NONEAll values except NONE
bioFuelRatioAny value comprised between 0, 100 (inclusive), only if fuelType is DIESEL, GASOLINE, CNG_GASOLINE or LPG_GASOLINEAny value comprised between 0, 100 (inclusive), only if fuelType is DIESEL or GASOLINE0
hybridRatio0Any value comprised between 0, 100 (exclusive)0
dualFuelRatioAny value comprised between 0, 100 (exclusive), only if fuelType is either CNG_GASOLINE or LPG_GASOLINE00
averageFuelConsumptionAny value greater than 0Any value greater than 00
averageElectricityConsumption0Any value greater than 0Any value greater than 0
particleReductionClassAll valuesAll valuesNONE
emissionStandardAll valuesAll valuesNONE
cylinderCapacityAny value greater than 0Any value greater than 00