Vehicle Signals
Signals from DIMO-connected vehicles.
Overview
There are two types of query fields that you can use to retrieve vehicle signals from the Telemetry API, depending on if you’re looking for the latest signal data, or if you need to look up historical signal data from the past:
-
The
signalsquery allows you to retrieve signal data from a vehicle for a given time period. It is commonly used to perform look backs with a set interval within a time period for a vehicle. -
The
signalsLatestquery allows you to retrieve the most recent signal data from a vehicle. It returns the latest signals received from the respective data sources.
signals
The signals resource is an aggregation of detailed signal fields, used to retrieve vehicle signal data between a specified time period in the past.Arguments
tokenIdInt!RequiredfromTime!RequiredtoTime!RequiredintervalString!RequiredfilterSignalFilterOptionalWhen using
signals, be sure to also include the relevant aggregation type.# Sample Telemetry Query
query GetHistoricalSignals{
signals(
tokenId: 12345
from: "2024-05-07T09:21:19Z"
to: "2024-05-10T09:21:19Z"
interval: "24h"
) {
timestamp
speed(agg: MAX)
}
}
signalsLatest
The signalsLatest resource is a SignalCollection that returns data for any signal that was most recently seen matching the filter.Arguments
tokenIdInt!RequiredfilterSignalFilterOptionalWhen using
signalsLatest, be sure to include a value and optionally a timestamp.# Sample Telemetry Query
query GetLatestSignals{
signalsLatest(tokenId: 12345) {
powertrainTransmissionTravelledDistance {
value
}
powertrainFuelSystemRelativeLevel {
value
timestamp
}
}
}
Categories of Data
Keys
- Signal: The field name that can be queried for signals or signalsLatest.
- Common Name: A simplified, consumer-friendly naming convention for the signal.
- Aggregation (Agg.) Type: The Aggregation Type as specified for the signals resource.
- Units: The unit returned for the specific signal quieried, if relevant.
- Description: A longer description for the specific signal.
Signal Name
lastSeenCommon NameLast Seen
The last time any signal was seen matching the filter. Only available on
signalsLatestSignal Name
availableSignalsCommon NameAvailable Vehicle Signals
Returns a list of queryable signal names that have stored data for a given
tokenId.Signal Name
powertrainTransmissionTravelledDistanceCommon NameOdometer
Odometer reading in kilometers, total distance travelled during the lifetime of the transmission.
Signal Name
vinVCCommon NameVIN #
Returns the latest VINVC data for a given token. Note: This is a standalone query field, not a sub-field of
signals or signalsLatest. Query example: query { vinVCLatest(tokenId: 12345) { vin } }Signal Name
isIgnitionOnCommon NameVehicle Ignition Status
Vehicle ignition status.
True (1) = Vehicle Ignition On
False (0) = Vehicle Ignition Off
Signal Name
speedCommon NameVehicle Speed
The vehicle speed in km/hr
Note that these signals require a user to have shared the relevant location privileges with your Developer License.
Signal Name
currentLocationCoordinatesCommon NameCoordinates
Current location of the vehicle in WGS 84 coordinates, as measured at the position of GNSS receiver antenna.
Signal Name
currentLocationLatitudeCommon NameLatitude Location
Current latitude of vehicle in WGS 84 geodetic coordinates, as measured at the position of GNSS receiver antenna.
Signal Name
currentLocationLongitudeCommon NameLongitude Location
Current longitude of vehicle in WGS 84 geodetic coordinates, as measured at the position of GNSS receiver antenna.
Signal Name
currentLocationAltitudeCommon NameAltitude Level
Current altitude relative to WGS 84 reference ellipsoid, as measured at the position of GNSS receiver antenna.
Signal Name
currentLocationApproximateLatitudeCommon NameApproximate Latitude Location
Approximation of current latitude of vehicle in WGS 84 geodetic coordinates, as measured at the position of GNSS receiver antenna.
Signal Name
currentLocationApproximateLongitudeCommon NameApproximate Longitude Location
Approximation of current longitude of vehicle in WGS 84 geodetic coordinates, as measured at the position of GNSS receiver antenna.
Signal Name
currentLocationIsRedactedCommon NameLocation Privacy Zones
Indicates if the latitude and longitude signals at the current timestamp have been redacted using a privacy zone.
True (1) = Current Location Redacted
False (0) = Current Location not Redacted
True (1) = Current Location Redacted
False (0) = Current Location not Redacted
Signal Name
powertrainTractionBatteryChargingChargeCurrentACCommon NameAC Current Charge (Alternating Current)
Current AC charging current (rms) at inlet. Negative if returning energy to grid. Used when per-phase numbers are unavailable.
Signal Name
powertrainTractionBatteryChargingChargeLimitCommon NameCharge Limit
Target charge limit (state of charge) for battery.
Signal Name
powertrainTractionBatteryChargingChargeVoltageUnknownTypeCommon NameCharging Voltage
Current charging voltage at inlet. Used when the data source does not indicate the current type (AC or DC) in use.
Signal Name
powertrainTractionBatteryChargingIsChargingCommon NameCharging Status
True if charging is ongoing. Charging is considered to be ongoing if energy is flowing from charger to vehicle.
True (1) - Vehicle is charging.
False (0) - Vehicle is not charging.
True (1) - Vehicle is charging.
False (0) - Vehicle is not charging.
Signal Name
powertrainTractionBatteryCurrentPowerCommon NameBattery Power
Current electrical energy flowing in/out of battery. Positive = Energy flowing in to battery, e.g. during charging. Negative = Energy flowing out of battery, e.g. during driving.
Signal Name
powertrainTractionBatteryGrossCapacityCommon NameTotal Battery Capacity
Gross capacity of the battery.
Signal Name
powertrainTractionBatteryStateOfChargeCurrentCommon NameCurrent Charge Level
Physical state of charge of the high voltage battery, relative to net capacity. This is not necessarily the state of charge being displayed to the customer.
Signal Name
powertrainTractionBatteryStateOfChargeCurrentEnergyCommon NameRemaining Energy
Physical state of charge of the high voltage battery.
Signal Name
powertrainTractionBatteryChargingAddedEnergyCommon NameSession Energy
The amount of charge added to the battery during the current charging session.
Signal Name
lowVoltageBatteryCurrentVoltageCommon NameLow Voltage Battery
Current Voltage of the low voltage battery.
Signal Name
dimoAftermarketWPAStateCommon NameWifi Protected Access (WPA)
Indicate the current WPA state for the devices Wi-Fi.
Signal Name
dimoAftermarketSSIDCommon NameService Set Identifier (SSID)
Service Set Identifier for the Wi-Fi.
Signal Name
dimoAftermarketNSATCommon NameNumber of Satellites (NSAT)
Number of sync satellites for GPS.
Signal Name
dimoAftermarketHDOPCommon NameHorizontal Dilution of Precision (HDOP)
Horizontal dilution of precision of GPS.
Signal Name
obdDTCListCommon NameDiagnostic Trouble Codes
List of currently active DTCs formatted according OBD II (SAE-J2012DA_201812) standard ([P|C|B|U]XXXXX )
Signal Name
obdRunTimeCommon NameEngine runtime
PID 1F - Engine run time.
Signal Name
obdIntakeTempCommon NameIntake temperature
PID 0F - Intake temperature.
Signal Name
obdEngineLoadCommon NameEngine Load
PID 04 - Engine load in percent - 0 = no load, 100 = full load.
Signal Name
obdBarometricPressureCommon NameBarometric Pressure
PID 33 - Barometric pressure.
Signal Name
powertrainTypeCommon NamePowertrain Type
Defines the powertrain type of the vehicle.
Signal Name
powertrainRangeCommon NameRange (remaining)
Remaining range in km using all energy sources available in the vehicle.
Signal Name
powertrainCombustionEngineTPSCommon NameThrottle Position
Current throttle position.
Signal Name
powertrainCombustionEngineSpeedCommon NameEngine RPM
Engine speed measured as rotations per minute (rpm).
Signal Name
powertrainCombustionEngineMAFCommon NameEngine Air Intake
Grams of air drawn into engine per second.
Signal Name
powertrainCombustionEngineEngineOilLevelCommon NameOil Level
Engine oil level.
Signal Name
powertrainCombustionEngineECTCommon NameCoolant Temperature
Engine coolant temperature.
Signal Name
exteriorAirTemperatureCommon NameAir Temperature
Air temperature outside the vehicle.
Signal Name
powertrainFuelSystemSupportedFuelTypesCommon NameSupported Fuel Types
High level information of fuel types supported.
Signal Name
powertrainFuelSystemRelativeLevelCommon NameFuel Percentage
Current available fuel in the fuel tank in %, from 0 to 100.
Signal Name
powertrainFuelSystemAbsoluteLevelCommon NameFuel Level
Current available fuel in the fuel tank expressed in liters.
Signal Name
chassisAxleRow1WheelLeftTirePressureCommon NameFront Left Wheel
Tire pressure of the front left tire in kilo-Pascal.
Signal Name
chassisAxleRow1WheelRightTirePressureCommon NameFront Right Wheel
Tire pressure of the front right tire in kilo-Pascal.
Signal Name
chassisAxleRow2WheelLeftTirePressureCommon NameBack Left Wheel
Tire pressure of the rear left tire in kilo-Pascal.
Signal Name
chassisAxleRow2WheelRightTirePressureCommon NameBack Right Wheel
Tire pressure of the rear right tire in kilo-Pascal.
Signal Name
cabinDoorRow1DriverSideIsOpenCommon NameFront Driver Side Door
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow1PassengerSideIsOpenCommon NameFront Passenger Side Door
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow2DriverSideIsOpenCommon NameBack Driver Side Door
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow2PassengerSideIsOpenCommon NameBack Passenger Side Door
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow1DriverSideWindowIsOpenCommon NameFront Driver Side Window
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow1PassengerSideWindowIsOpenCommon NameFront Passenger Side Window
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow2DriverSideWindowIsOpenCommon NameBack Driver Side Window
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow2PassengerSideWindowIsOpenCommon NameBack Passenger Side Window
True (1) = Fully or partially open.
False (0) = Fully closed.
Advanced Filtering
currentLocationCoordinates Filters
This is an advanced filter that you can apply on the currentLocationCoordinates field under signals.
It is used to filter by a user-defined geofence that can be set using circles or polygons:
In Circle Filtering
Loading map components...
Map will load on client-side...