Get EV Awareness Charging Events Streaming API
This API delivers real-time EV charging data stream to a customer's business system (such as ADMS).
Example use cases:
-
Distribution system planning. A list of charging events including kW peak, time, and kWh will help distribution system planners create better models and proactively upgrade or defer upgrades down to the secondary of distribution transformers, as required.
-
EV programs. Knowledge of EV charging loads will help EV program groups target appropriate customers and design better rates for EV programs, optimizing marketing O&M and participation in programs.
-
Data scientists. Forecasting loads and creating models of EV charging behavior may be performed by data scientists in utilities for distribution system planning and EV program impacts.
-
Controls. Use of the real-time EV charging events to inform transformer protection, VVO, DERMS, or other applications.
The MeterKey is stored in the table, which maps to MeterID.
The 'event time' is standardized to be the start date and time of a given charging session.
UTC offset should be available as part of the date time input (parameters).
There are two types of messages. One message is sent by the agent upon the start of a charge session and contains the start time (ChargeStartTime) and power of charging (ChargeW). The other message is sent by the agent when the charge session ends and contains the end time (ChargeEndTime), charge duration (ChargeDuration), and charge session energy (ChargeEnergy). The other data values will be null or blank.
Data product ID: 161f7421-3f8a-43f4-ba2f-1ee5816ca858
Payload example
{
"EVChargingEvents": [
{
"ServicePointID": "xxxxxxxxxx",
"MeterID": "xxxxxxxxxx",
"MeterNumber": "xxxxxxxxxx",
"ESN": "x.xx.xxx.x.xxxxxx.xx.xx.xxxxxxxxxx",
"TransformerID": "xxxxxxxxxx-xxxxxxxx",
"PremiseID": "Pxxxxxxxxxx",
"ReceivedTime": "2023-09-13T00:29:55.55Z",
"ChargeStartTime": "2023-09-13T00:29:55.55Z",
"ChargeEndTime": "2023-09-13T00:29:55.55Z",
"ChargeW": "1237.375166",
"ChargeDuration": "22",
"ChargeEnergy": "56.24432574",
}
]
}
Parameters
|
Name |
Description |
Operators |
Required |
Origination |
|---|---|---|---|---|
|
EntityType |
|
equals |
No |
CIS MDMS GIS |
|
EntityId |
Dependent on GroupType |
in list |
No |
CIS MDMS GIS |
|
GroupId |
Future TBD. Dependent on GroupType. |
equals |
No |
DIS |
|
GroupType |
Future TBD |
equals |
No |
DIS |
Data values
|
Name |
Description |
Type |
Units |
Range |
Nullable |
Origination |
|---|---|---|---|---|---|---|
|
ServicePointID |
Service point as of the event date |
string |
|
|
|
CIS MDMS |
|
MeterID |
Meter identifier |
string |
|
|
|
CIS MDMS |
|
MeterNumber |
Meter number |
string |
|
|
yes |
CIS MDMS |
|
ESN |
Electronic serial number |
string |
|
|
|
CIS MDMS |
|
TransformerID |
Transformer as of the event date |
string |
|
|
yes |
GIS OMS ADMS |
|
PremiseID |
Premise ID as of the event date |
string |
|
|
yes |
CIS MDMS |
|
ReceivedTime |
When the data was received by the App Platform |
|
|
|
|
Electric Vehicle Awareness agent |
|
ChargeStartTime |
Start date and time of the electric vehicle charging event |
date time |
|
|
yes |
Electric Vehicle Awareness agent |
|
ChargeEndTime |
End date and time of the electric vehicle charging event |
date time |
|
|
yes |
Electric Vehicle Awareness agent |
|
ChargeW |
Watts of the electric vehicle charging event |
real |
watts |
>0 |
yes |
|
|
ChargeDuratjion |
Duration of the charge in hours |
integer |
hours |
>0 |
yes |
|
|
ChargeEnergy |
Wh of the electric vehicle charging events |
real |
watt hours |
>0 |
yes |
|