This endpoint evaluates the state of charge (SoC) history of a full electric or plug-in hybrid vehicle's traction battery.
The result provides an EV with the necessary information to set customized charging limits based on the usage history. Limiting the maximum charge is
a way to protect the traction battery from unnecessary degradation.
The response contains the historical dwell time distribution of the traction battery's charge level. In addition, it returns 4 KPIs that describe the result
at a glance:
- soc_below_20% : The percentage of time spent at very low SoC values.
- soc_above_85% : The percentage of time spent at very high SoC values.
- range_buffer : The SoC reserve that is not being accessed during at least 95% of the time.
- soc_score : A scoring that rates the quality of the SoC distribution in terms of optimizing battery life. Take values from 0 (worst case) to 10 (best case).
Finally, it contains two parameters that reflect the statistical quality of the evaluation: The number of samples and the representativity parameter. The representativity parameter
reflects how representative the result is with respect to the battery lifetime. It can assume values between 0 and 1.
If the full lifetime of the battery was evaluated, this parameter will be 1. On the other hand, if the evaluated data covers only a fraction of the actual battery life,
its value will be proportionally smaller.
The call must include the tracker_oid. By default, all the available data is used for calculation.
By providing the optional parameters start_date and/or end_date, only the data within the specified time range is evaluated.
This can be useful, for example, to track the SoC profile over time.