Generates a SoC evaluation report for a traction battery.

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:

  1. soc_below_20% : The percentage of time spent at very low SoC values.
  2. soc_above_85% : The percentage of time spent at very high SoC values.
  3. range_buffer : The SoC reserve that is not being accessed during at least 95% of the time.
  4. 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.

Battery SoC Evaluation
Open Recipe
Click Try It! to start a request and see the response here!