Package com.here.sdk.routing

Class EmpiricalConsumptionModel

  • java.lang.Object
    • com.here.sdk.routing.EmpiricalConsumptionModel
  • public final class EmpiricalConsumptionModel
extends java.lang.Object

    This model defines the empirical consumption mode used in electric vehicles.

    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. Note: This is a beta release of this feature, so there could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.

    • Field Summary

      Fields 
      Modifier and Type Field Description
      double ascentConsumptionInWattHoursPerMeter
      Rate of energy consumed per meter rise in elevation (in Wh/m, i.e., Watt-hours per meter).
      double auxiliaryConsumptionInWattHoursPerSecond
      Rate of energy (in Wh/s) consumed by the vehicle's auxiliary systems (e.g., air conditioning, lights) per second of travel.
      double descentRecoveryInWattHoursPerMeter
      Rate of energy recovered per meter fall in elevation (in Wh/m, i.e., Watt-hours per meter).
      java.util.Map<java.lang.Integer,​java.lang.Double> freeFlowSpeedTable
      Free flow speed table describes energy consumption when traveling at constant speed.
      java.util.Map<java.lang.Integer,​java.lang.Double> trafficSpeedTable
      Traffic speed table describes energy consumption when traveling under heavy traffic conditions, i.e.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean equals​(java.lang.Object obj)  
      int hashCode()  

      • Methods inherited from class java.lang.Object

        clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

    • Field Detail

      • 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 java.util.Map<java.lang.Integer,​java.lang.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 java.util.Map<java.lang.Integer,​java.lang.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 Detail

      • EmpiricalConsumptionModel

        public EmpiricalConsumptionModel()

        Creates a new instance.

    • Method Detail

      • equals

        public boolean equals​(java.lang.Object obj)
        Overrides:
        equals in class java.lang.Object

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object