Class EVConsumptionModel

java.lang.Object
com.here.sdk.routing.EVConsumptionModel

public final class EVConsumptionModel extends Object

Parameters specific for the electric vehicle, which are then used to calculate energy consumption on a given route. At minimum, you must provide ascentConsumptionInWattHoursPerMeter, descentRecoveryInWattHoursPerMeter and a freeFlowSpeedTable.

  • Field Details

    • ascentConsumptionInWattHoursPerMeter

      public double ascentConsumptionInWattHoursPerMeter

      Rate of energy consumed per meter rise in elevation (in Wh/m, i.e., Watt-hours per meter).

    • descentRecoveryInWattHoursPerMeter

      public double descentRecoveryInWattHoursPerMeter

      Rate of energy recovered per meter fall in elevation (in Wh/m, i.e., Watt-hours per meter).

    • freeFlowSpeedTable

      @NonNull public Map<Integer,Double> freeFlowSpeedTable

      Free flow speed table describes energy consumption when traveling at constant speed. It defines a function curve specifying consumption rate at a given free flow speed on a flat stretch of road. Map keys represent speed values that are non-negative integers in units of (km/h). Map values represent consumption values that are non-negative floating point values in units of (Wh/m). The function is linearly interpolated between each successive pair of data points: For values below the first list value, the first value is used. For values after the last list value, the last list value is used. At minimum, one key/value pair must be set. In this case the consumption value is used for all possible speed keys.

    • trafficSpeedTable

      @NonNull public Map<Integer,Double> trafficSpeedTable

      Traffic speed table describes energy consumption when traveling under heavy traffic conditions, i.e. when the vehicle is expected to often change the travel speed. It defines a function curve specifying consumption rate at a given speed under traffic conditions on a flat stretch of road. Map keys represent traffic speed values that are non-negative integers in units of (km/h). Map values represent consumption values that are non-negative floating point values in units of (Wh/m). The function is linearly interpolated between each successive pair of data points: For values below the first list value, the first value is used. For values after the last list value, the last list value is used. If only one key/value pair is set, the consumption value is used for all possible traffic speed keys. If trafficSpeedTable is empty then only freeFlowSpeedTable is used for calculating speed-related energy consumption.

    • auxiliaryConsumptionInWattHoursPerSecond

      public double auxiliaryConsumptionInWattHoursPerSecond

      Rate of energy (in Wh/s) consumed by the vehicle's auxiliary systems (e.g., air conditioning, lights) per second of travel.

  • Constructor Details

    • EVConsumptionModel

      public EVConsumptionModel()

      Creates a new instance.

  • Method Details