Get Synchronous EV Events
-
Example use cases.
-
Distribution system planning. A list of charging events including kW peak, time, and kWh 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 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.
-
-
Data latency. 1-5 seconds.
-
Maximum result size. 1,000 rows.
-
Data availability. Last 13 months.
Request
GET /v1/{tenantid}/di/apps/ev/chargeevents
{
"StartRecievedDatetime": "2023-1-1",
"EndRecievedDatetime": "2023-1-31",
"EntityType": "Transformer",
"EntityId": "X1-01-A"
}Parameters
|
Name |
Description |
Operators |
Required |
Type |
Format |
Default |
Range |
Origination |
|---|---|---|---|---|---|---|---|---|
|
StartEventDate |
Start date being queried as Min(EventDate) |
Greater than or equal to |
No |
Datetime |
YYYY-MM-DDTHH:MM:SSZ |
2020-01-01T00:00:00.0Z |
(Current UTC Date) to (Current UTC Date - 13 months) |
Edge app |
|
EndEventDate |
End date being queried as Max(EventDate) |
Less than or equal to |
No |
Datetime |
YYYY-MM-DDTHH:MM:SSZ |
9999-12-31T00:00:00.0Z |
(Current UTC Date) to (Current UTC Date - 13 months) |
Edge app |
|
StartReceivedDatetime |
Min ReceivedTime data |
Greater than or equal to |
No |
Datetime |
YYYY-MM-DDTHH:MM:SSZ |
2020-01-01T00:00:00.0Z |
(Current UTC Date) to (Current UTC Date - 13 months) |
App Platform |
|
EndReceivedDatetime |
Max ReceivedTime data |
Less than or equal to |
No |
Datetime |
YYYY-MM-DDTHH:MM:SSZ |
9999-12-31T00:00:00.0Z |
(Current UTC Date) to (Current UTC Date - 13 months) |
App Platform |
|
EntityType |
Servicepoint, Meter, ESN, Transformer, premises, None |
Equals |
No |
String |
N/A |
N/A |
N/A |
CIS MDMS GIS |
|
EntityId |
Dependent on EntityType |
In list |
No |
String |
N/A |
N/A |
N/A |
CIS MDMS GIS |
Response
[
{
"ServicePointID": 9000372474,
"MeterId": 1000634831,
"MeterNumber": 1000634831,
"ElectronicSerialNumber": "2.16.840.1.114416.15.80.1000634831",
"TransformerID": "4929542183-90777887",
"PremiseId": "",
"ChargeStartTime": "2023-09-13T00:29:55.55Z",
"ChargeEndTime": "2023-09-13T00:59:55.55Z",
"AvgLoad": 44.38334,
"AvgVoltage": 112.59,
"AvgVoltageBeforeCharge": 120.32,
"RecievedTime": "2023-09-13T00:29:55.55Z"
},
{
"ServicePointID": 9000502815,
"MeterId": 1000838385,
"MeterNumber": 1000838385,
"ElectronicSerialNumber": "2.16.840.1.114416.15.80.1000838385",
"TransformerID": "--",
"PremiseId": "",
"ChargeStartTime": "2023-09-13T00:29:55.55Z",
"ChargeEndTime": "2023-09-13T00:59:55.55Z",
"AvgLoad": 128.1167,
"AvgVoltage": 112.67,
"AvgVoltageBeforeCharge": 120.03,
"RecievedTime": "2023-09-13T00:29:55.55Z"
}]Data values
|
Name |
Description |
Type |
Units |
Range |
Format |
Nullable |
Origination |
|---|---|---|---|---|---|---|---|
|
ServicePointId |
Service Point ID as of EventDate |
String |
N/A |
N/A |
N/A |
No |
CIS MDMS GIS |
|
MeterId |
Meter ID as of EventDate |
String |
N/A |
N/A |
N/A |
No |
CIS MDMS GIS |
|
MeterNumber |
Meter Number as of EventDate |
String |
N/A |
N/A |
N/A |
Yes |
CIS MDMS GIS |
|
ElectronicSerialNumber |
Electronic Serial Number |
String |
N/A |
N/A |
N/A |
No |
CIS MDMS GIS |
|
TransformerId |
Transformer ID as of EventDate |
String |
N/A |
N/A |
N/A |
Yes |
CIS MDMS GIS |
|
PremiseId |
Premise ID as of EventDate |
String |
N/A |
N/A |
N/A |
Yes |
CIS MDMS GIS |
|
ChargeStartTime |
Start datetime of EV charging event |
Datetime |
N/A |
N/A |
YYYY-MM-DDTHH:MM:SSZ |
No |
Edge app |
|
ChargeEndTime |
End datetime of EV charging event |
Datetime |
N/A |
N/A |
YYYY-MM-DDTHH:MM:SSZ |
No |
Edge app |
|
AvgLoad |
kW of EV charging event |
Real |
kW |
0 to 655.35 |
N.NN |
No |
Edge app |
|
AvgVoltage |
Average voltage during charge |
Real |
Volts |
0 to 655.35 |
N.NN |
No |
Edge app |
|
AvgVoltageBeforeCharge |
Average voltage during the 15-minute time just before the charge began |
Real |
Volts |
0 to 655.35 |
N.NN |
No |
Edge app |
|
ReceivedTime |
When the data was received by the App Platform |
Datetime |
N/A |
N/A |
YYYY-MM-DDTHH:MM:SSZ |
No |
App Platform |