Vehicle Signals

Signals from DIMO-connected vehicles

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 signals query 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 signalsLatest query 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!Required

fromTime!Required

toTime!Required

intervalString!Required

filterSignalFilterOptional

When 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!Required

filterSignalFilterOptional

When 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
    }
  }
}

Fields by Category

Key:

• 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	Common Name	Agg. Type	Units	Description
lastSeen	Last Seen	Time!	UTC	The last time any signal was seen matching the filter. Only available on signalsLatest
availableSignals	Available Vehicle Signals	FloatAggregation!	N/A	Returns a list of queryable signal names that have stored data for a given tokenId.
powertrainTransmissionTravelledDistance	Odometer	FloatAggregation!	km	Odometer reading in kilometers, total distance travelled during the lifetime of the transmission.
vinVC	VIN #	FloatAggregation!	N/A	Returns the latest VINVC data for a given token
isIgnitionOn	Vehicle Ignition Status	FloatAggregation!	0 or 1	Vehicle ignition status. True (1) = Vehicle Ignition On False (0) = Vehicle Ignition Off
speed	Vehicle Speed	FloatAggregation!	km/hr	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	Common Name	Agg. Type	Units	Description
currentLocationLatitude	Latitude Location	FloatAggregation!	degrees	Current latitude of vehicle in WGS 84 geodetic coordinates, as measured at the position of GNSS receiver antenna.
currentLocationLongitude	Longitude Location	FloatAggregation!	degrees	Current longitude of vehicle in WGS 84 geodetic coordinates, as measured at the position of GNSS receiver antenna.
currentLocationAltitude	Altitude Level	FloatAggregation!	degrees	Current altitude relative to WGS 84 reference ellipsoid, as measured at the position of GNSS receiver antenna.
currentLocationApproximateLatitude	Approximate Latitude Location	FloatAggregation!	degrees	Approximation of current latitude of vehicle in WGS 84 geodetic coordinates, as measured at the position of GNSS receiver antenna.
currentLocationApproximateLongitude	Approximate Longitude Location	FloatAggregation!	degrees	Approximation of current longitude of vehicle in WGS 84 geodetic coordinates, as measured at the position of GNSS receiver antenna.
currentLocationIsRedacted	Location Privacy Zones	FloatAggregation!	0 or 1	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

Signal	Common Name	Agg. Type	Units	Description
powertrainTractionBatteryChargingChargeCurrentAC	AC Current Charge (Alternating Current)	FloatAggregation!	amps	Current AC charging current (rms) at inlet. Negative if returning energy to grid. Used when per-phase numbers are unavailable.
powertrainTractionBatteryChargingChargeLimit	Charge Limit	FloatAggregation!	percent	Target charge limit (state of charge) for battery.
powertrainTractionBatteryChargingChargeVoltageUnknownType	Charging Voltage	FloatAggregation!	volts	Current charging voltage at inlet. Used when the data source does not indicate the current type (AC or DC) in use.
powertrainTractionBatteryChargingIsCharging	Charging Status	StringAggregation!	0 or 1	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.
powertrainTractionBatteryCurrentPower	Battery Power	FloatAggregation!	watts	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.
powertrainTractionBatteryGrossCapacity	Total Battery Capacity	FloatAggregation!	kWh	Gross capacity of the battery.
powertrainTractionBatteryStateOfChargeCurrent	Current Charge Level	FloatAggregation!	percent	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.
powertrainTractionBatteryStateOfChargeCurrentEnergy	Remaining Energy	FloatAggregation!	kWh	Physical state of charge of the high voltage battery.
powertrainTractionBatteryChargingAddedEnergy	Session Energy	FloatAggregation!	kWh	The amount of charge added to the battery during the current charging session.
lowVoltageBatteryCurrentVoltage	Low Voltage Battery	FloatAggregation!	volts	Current Voltage of the low voltage battery.

Signal	Common Name	Agg. Type	Units	Description
dimoAftermarketWPAState	Wifi Protected Access (WPA)	StringAggregation!	N/A	Indicate the current WPA state for the devices Wi-Fi.
dimoAftermarketSSID	Service Set Identifier (SSID)	StringAggregation!	N/A	Service Set Identifier for the Wi-Fi.
dimoAftermarketNSAT	Number of Satellites (NSAT)	FloatAggregation!	N/A	Number of sync satellites for GPS.
dimoAftermarketHDOP	Horizontal Dilution of Precision (HDOP)	FloatAggregation!	N/A	Horizontal dilution of precision of GPS.

Signal	Common Name	Agg. Type	Units	Description
obdDTCList	Diagnostic Trouble Codes	FloatAggregation!	OBD II Standard	List of currently active DTCs formatted according OBD II (SAE-J2012DA_201812) standard ([P|C|B|U]XXXXX )
obdRunTime	Engine runtime	FloatAggregation!	seconds	PID 1F - Engine run time.
obdIntakeTemp	Intake temperature	FloatAggregation!	degrees (ºC)	PID 0F - Intake temperature.
obdEngineLoad	Engine Load	FloatAggregation!	percentage	PID 04 - Engine load in percent - 0 = no load, 100 = full load.
obdBarometricPressure	Barometric Pressure	FloatAggregation!	kPa	PID 33 - Barometric pressure.

Signal	Common Name	Agg. Type	Units	Description
powertrainType	Powertrain Type	StringAggregation!	N/A	Defines the powertrain type of the vehicle.
powertrainRange	Range (remaining)	FloatAggregation!	kilometers	Remaining range in km using all energy sources available in the vehicle.
powertrainCombustionEngineTPS	Throttle Position	FloatAggregation!	percent	Current throttle position.
powertrainCombustionEngineSpeed	Engine RPM	FloatAggregation!	rpm	Engine speed measured as rotations per minute (rpm).
powertrainCombustionEngineMAF	Engine Air Intake	FloatAggregation!	grams/second	Grams of air drawn into engine per second.
powertrainCombustionEngineEngineOilLevel	Oil Level	StringAggregation!	liters	Engine oil level.
powertrainCombustionEngineECT	Coolant Temperature	FloatAggregation!	degrees (ºC)	Engine coolant temperature.

Signal	Common Name	Agg. Type	Units	Description
exteriorAirTemperature	Air Temperature	FloatAggregation!	degrees (ºC)	Air temperature outside the vehicle.

Signal	Common Name	Agg. Type	Units	Description
powertrainFuelSystemSupportedFuelTypes	Supported Fuel Types	StringAggregation!	N/A	High level information of fuel types supported.
powertrainFuelSystemRelativeLevel	Fuel Percentage	FloatAggregation!	percent	Current available fuel in the fuel tank in %, from 0 to 100.
powertrainFuelSystemAbsoluteLevel	Fuel Level	FloatAggregation!	liters	Current available fuel in the fuel tank expressed in liters.

Signal	Common Name	Agg. Type	Units	Description
chassisAxleRow1WheelLeftTirePressure	Front Left Wheel	FloatAggregation!	kPa	Tire pressure of the front left tire in kilo-Pascal.
chassisAxleRow1WheelRightTirePressure	Front Right Wheel	FloatAggregation!	kPa	Tire pressure of the front right tire in kilo-Pascal.
chassisAxleRow2WheelLeftTirePressure	Back Left Wheel	FloatAggregation!	kPa	Tire pressure of the rear left tire in kilo-Pascal.
chassisAxleRow2WheelRightTirePressure	Back Right Wheel	FloatAggregation!	kPa	Tire pressure of the rear right tire in kilo-Pascal.

Signal	Common Name	Agg. Type	Units	Description
cabinDoorRow1DriverSideIsOpen	Front Driver Side Door	FloatAggregation!	0 or 1	True (1) = Fully or partially open. False (0) = Fully closed.
cabinDoorRow1PassengerSideIsOpen	Front Passenger Side Door	FloatAggregation!	0 or 1	True (1) = Fully or partially open. False (0) = Fully closed.
cabinDoorRow2DriverSideIsOpen	Back Driver Side Door	FloatAggregation!	0 or 1	True (1) = Fully or partially open. False (0) = Fully closed.
cabinDoorRow2PassengerSideIsOpen	Back Passenger Side Door	FloatAggregation!	0 or 1	True (1) = Fully or partially open. False (0) = Fully closed.

Signal	Common Name	Agg. Type	Units	Description
cabinDoorRow1DriverSideWindowIsOpen	Front Driver Side Window	FloatAggregation!	0 or 1	True (1) = Fully or partially open. False (0) = Fully closed.
cabinDoorRow1PassengerSideWindowIsOpen	Front Passenger Side Window	FloatAggregation!	0 or 1	True (1) = Fully or partially open. False (0) = Fully closed.
cabinDoorRow2DriverSideWindowIsOpen	Back Driver Side Window	FloatAggregation!	0 or 1	True (1) = Fully or partially open. False (0) = Fully closed.
cabinDoorRow2PassengerSideWindowIsOpen	Back Passenger Side Window	FloatAggregation!	0 or 1	True (1) = Fully or partially open. False (0) = Fully closed.