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

Copy
{
    "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

Table 18 

Name

Description

Operators

Required

Origination

EntityType

  • Service point

  • Meter

  • ESN

  • Transformer

  • Premise

  • None

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

Table 19 

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