sdk-routing / com.tomtom.online.sdk.routing.data.matrix / MatrixRoutingQueryBuilder / withDownhillEfficiency

withDownhillEfficiency

fun withDownhillEfficiency(downhillEfficiency: Double?): MatrixRoutingQueryBuilder

Specifies the efficiency of converting potential energy to saved (not consumed) fuel when the vehicle loses elevation (i.e. ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved is obtained by converting saved (not consumed) fuel to energy using fuelEnergyDensityInMJoulesPerLiter. Applicable only for combustion engines. If used at all, must be used in conjunction with MatrixRoutingQueryBuilder.withUphillEfficiency. If used, MatrixRoutingQueryBuilder.withVehicleWeightInKg has to be used as well.

Parameters

downhillEfficiency - valid values: 0.0,1/uphillEfficiency.