EvDataProvider

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.

Defines how many kilometers can be traveled using 1 kWh of vehicle's charge.

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 the fallback strategy to apply when required EV data is missing or invalid.

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 charge of vehicle.

Optional parameter. Limits maximum charge when charging at stations. maxChargeAtChargingStation must be between 0 and ev_max_charge. The default value is 100% of maxCharge.

Optional parameter. Defines the minimum charge when arriving at the charging station. 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. 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.

Optional parameter. Defines the energy recuperation efficiency during descent (regenerative braking). Expressed as a fraction between 0.0 and 1.0. For example, 0.7 means 70% of potential energy during descent is converted back to battery energy.

Defines remaining time in seconds until the vehicle's battery is fully charged.

Defines the state of charge (SOC) curve of an electric vehicle's battery. The SoC curve describes the battery's charge level as a list of pairs:

Defines the current state of energy (SoE) of the vehicle's battery.

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.