Package com.here.sdk.routing

Class PhysicalConsumptionModel

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

    Defines the physical consumption model for electric vehicles, using vehicle-specific parameters to calculate energy consumption along a route. Note: [sdk.transport.VehicleSpecification.current_weight_in_kilograms] must be set. 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 airDragCoefficient
      The drag coefficient of an vehicle defines the way the vehicle is expected to pass through the surrounding air.
      double auxiliaryPowerConsumptionInWatts
      Power (in W) consumed by the vehicle's auxiliary systems (for example, air conditioning, lights).
      double driveTrainEfficiency
      The proportion of the energy drawn from the battery that is used to move the vehicle.
      double frontalAreaInSquareMeters
      Frontal area represents the total cross section area of the vehicle as viewed from the front, specified in square meters.
      double recuperationEfficiency
      The proportion of the energy gained when braking or going downhill that can be recuperated and restored as battery charge.
      double rollingResistanceCoefficient
      Rolling resistance refers to the resistance experienced by your vehicle tire as it rolls over a surface.

    • 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

      • driveTrainEfficiency

        public double driveTrainEfficiency

        The proportion of the energy drawn from the battery that is used to move the vehicle. (This is to factor in energy losses through heat in the motors, for example.) Supported range from 0 to 1

      • recuperationEfficiency

        public double recuperationEfficiency

        The proportion of the energy gained when braking or going downhill that can be recuperated and restored as battery charge.

        Supported range from 0 to 1

      • auxiliaryPowerConsumptionInWatts

        public double auxiliaryPowerConsumptionInWatts

        Power (in W) consumed by the vehicle's auxiliary systems (for example, air conditioning, lights).

        The provided value must be greater than or equal to 0.

      • frontalAreaInSquareMeters

        public double frontalAreaInSquareMeters

        Frontal area represents the total cross section area of the vehicle as viewed from the front, specified in square meters. Physical consumption model is using this value in combination with airDragCoefficient to calculate the consumption caused by air resistance. As fallback VehicleSpecification.widthInCentimeters and VehicleSpecification.heightInCentimeters are used.

        This parameter is used to provide a more accurate consumption prediction for electric vehicles.

        In the range from 0.5 to 50

      • rollingResistanceCoefficient

        public double rollingResistanceCoefficient

        Rolling resistance refers to the resistance experienced by your vehicle tire as it rolls over a surface. The main causes of this resistance are tire deformation, wing drag, and friction with the ground. The coefficient of rolling resistance is a numerical value indicating the severity of this factor.

        This parameter is used to provide a more accurate consumption prediction for electric vehicles.

        Supported range from 0 to 1

      • airDragCoefficient

        public double airDragCoefficient

        The drag coefficient of an vehicle defines the way the vehicle is expected to pass through the surrounding air. More streamlined vehicles are more aerodynamic and therefore have smaller drag coefficient.

        This parameter is used to provide a more accurate consumption prediction for electric vehicles.

        Supported range from 0 to 1

    • Constructor Detail

      • PhysicalConsumptionModel

        public PhysicalConsumptionModel()

        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