EvDataProvider
Properties
Optional parameter that defines the amount of energy an electric vehicle consumes from increasing elevation (watt-hours per meter). Max value is currently 1000.0 Wh/m and min value is currently 0.0 Wh/m. This is used in conjunction with the descent parameter, as a result both must be supplied when using either optional field. If only one of these parameters is supplied, this is considered an invalid query and will be rejected.
Optional parameter that defines latest auxiliary consumption of the EV which is the energy in watts consumed by the vehicle's auxiliary systems (e.g., air conditioning, lights). Note if auxiliary_consumption is NOT specified, API fallbacks to using corresponding value from ev directions request, if available, for this refresh session.
Specifies the maximum battery charging rate (W) at a given charge level (Wh) in a list of pairs. Example value of 0,100000; 40000,70000; 60000,30000; 80000,10000 defines for instance 70 kW charging when the battery has 40 kWh charge. The charging curve's charging levels should span from 0 to maximum charge. The first element's charging rate is assumed to be constant between the 0 and the first element's charging level. The last element's charging rate is assumed to be constant between the last element's charging level and maxCharge.
Defines the compatible connector-types for the vehicle. The router will select the charging stations compatible with connector-types. Following connector-types are supported:
Optional parameter that defines the amount of energy an electric vehicle gains from decreasing elevation (watt-hours per meter). Max value is currently 1000.0 Wh/m and min value is currently 0.0 Wh/m. This is used in conjunction with the ascent parameter, as a result both must be supplied when using either optional field. If only one of these parameters is supplied, this is considered an invalid query and will be rejected.
Specifies in pairs the energy consumption in watt-hours per kilometer at a certain speed in kph. Example value of 0,300;20,160;80,140;120,180 defines for instance 160 watt-hours per kilometer at 20 km/h.
Defines whether charger is plugged in or not.
Optional parameter. Specify maximum AC charging power(W) that can be delivered by the onboard vehicle charger. This parameter along with the chargingCurve dictates the battery charging rate. For example, when charging at a 16kW AC power outlet, with a vehicle onboard AC converter of 10kW (maxAcChargingPower), router will use max charging power of 10kW. The default value is 14400W.
Defines the maximum possible range of the vehicle in kilometers based on the current SoC.
Optional parameter. Limits maximum charge when charging at stations (Wh). Example value of 20000 denotes that the vehicle will not charge past 20 kWh charge at a charging station. maxChargeAtChargingStation must be between 0 and ev_max_charge. The default value is 100% of maxCharge.
Defines the minimum possible range of the vehicle in kilometers based on the current SoC.
Optional parameter. Defines the minimum charge when arriving at the charging station (Wh). Example value of 20000 denotes that the vehicle will reach each charging stop with at least 20 kWh charge. minChargeAtChargingStation must be between 0 and ev_max_charge. The default value is 10% of maxCharge.
Optional parameter. Defines the minimum battery charge required at the final route destination (Wh). Example value of 20000 denotes that vehicle will reach destination with at least 20 kWh charge. minChargeAtDestination must be between 0 and ev_max_charge. The default value is 10% of maxCharge.
Optional parameter. Defines the time in minutes it would take for the vehicle's battery to condition. This is used in conjunction with the unconditionedChargingCurve parameter, as a result both must be supplied when using either optional field. If only one of these parameters is supplied, they both will be ignored.
Defines remaining time in seconds until the vehicle's battery is fully charged.
Optional parameter. Average speed used for fast State Of Charge estimation. This value is used to query the energyConsumptionCurve to get the energy consumption in watt-hours per kilometer — the returned value is then multiplied by the distance traveled to get the total energy used.
Defines the current state of charge (SoC) of the vehicle's battery in percent. Example value of 50 denote 50% charge compared to the maxCharge.
Optional parameter. Specifies the maximum battery charging rate (W) at a specified charge level (Wh) in a list of pairs when the battery is in an unconditioned state (eg: cold). This is used in conjunction with the preConditioningTime parameter, as a result both must be supplied when using either optional field. If only one of these parameters is supplied, they both will be ignored.