Vehicle Signals

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

Filter Field	Type
tokenId	Int!
from	Time!
to	Time!
interval	String!
filter	SignalFilter

When using signals, be sure to also include the relevant aggregation type.

{
  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

Filter Field	Type
tokenId	Int!
filter	SignalFilter

When using signalsLatest, be sure to include a value and optionally a timestamp

{
  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.

Vehicle Info & Status

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

Location

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

Battery & Charging

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.

Devices

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.

Diagnostics

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.

Engine

Signal	Common Name	Agg. Type	Units	Description
powertrainType	Powertrain Type	StringAggregation!	N/A	Defines the powertrain type of the vehicle.
powertrainRange	Range (remaining)	FloatAggregation!	meters	Remaining range in meters 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.

Environment

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

Fuel

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.

Tire Pressure

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.

Doors

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.

Windows

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.