Readings
The Reading object
A Reading represents a single snapshot of the state of an Entity.
Entities of the same type, produce similarly structured Readings. This allows you to process them uniformly, regardless of type of device or vehicle your working with.
Each Reading may contain several independent metrics. Depending on the type of Entity or it’s manufacturer, some metrics may be omitted because they are irrelevant, temporarly not available, or due to manufacturer limitations.
Metrics
Related to electricity use & production
amperage
The current flowing through the device at a specific moment, measured in amperes (A).
voltage
The voltage level of the device at a specific moment, measured in volts (V).
observed injection
The total amount of energy sent back to the grid, measured in kilowatt-hours (kWh).
observed injection
Breakdown of returned energy by phase, for multi-phase systems.
real-time injection
The real-time power being sent back to the grid, measured in watts (W).
observed consumption
The total amount of energy consumed by the device, measured in kilowatt-hours (kWh).
observed consumption
Breakdown of consumed energy by phase, for multi-phase systems.
real-time consumption
The real-time power being consumed by the device, measured in watts (W).
reactive consumption
The reactive energy consumed by the device, typically measured in kilovolt-amperes reactive hours (kVA).
Related to gas use & offset
volume
The total volume of gas consumed, measured in cubic meters (m³).
volume
The volume of gas returned or offset, measured in cubic meters (m³).
Related to EVs
boolean
Indicates whether the device is currently charging (true/false).
boolean
Shows whether the device is physically connected to a power source (true/false).
coordinates
The current geographic location of the device in latitude and longitude coordinates.
locations
An array of Entity-Locations that we’ve matched to this Reading.
distance
The total distance the device has traveled, typically measured in kilometers (km) or miles.
distance
The estimated distance the device can travel or operate before recharging (or refuelling, in case of PHEV).
charge
The current charge level of the device’s battery, expressed relative to the maximum charge level.
The full object
A reading.
The data of a reading.
The id of the Entity
The id of the reading.
The timestamp of the reading.
The timestamp the reading was processed.
The timestamp the reading was received.