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

withUphillEfficiency

fun withUphillEfficiency(uphillEfficiency: Double): MatrixRoutingQueryBuilder

Specifies the efficiency of converting chemical energy stored in fuel to potential energy when the vehicle gains elevation (i.e. PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed is obtained by converting consumed fuel to chemical energy using fuelEnergyDensityInMJoulesPerLiter. Applicable only for combustion engines. If used at all, must be used in conjunction with MatrixRoutingQueryBuilder.withDownhillEfficiency. If used, .withVehicleWeightInKg has to be used as well.

Parameters

uphillEfficiency - valid values: 0.0,1/downhillEfficiency.