Trackunit Developer Hub

Developer Hub

Welcome to our Developer hub.

Here You'll find comprehensive documentation to help you start working with the API's as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started

Trackunit Data Model

Trackunit's data model is semantically defined datapoints called machine insights, each of them capturing some insight into a machine or asset. This means that no matter the connectivity of the machine (be it directly through Trackunit or e.g. an ISO feed) the data model is the same, whereas the datapoints available for each machine may vary.

Each machine insight has a distinct definition, such that machine insights can be used across an entire fleet. Each machine insight is always normalised to a specific unit of measurement, typically an SI-unit.

Machine Insights

CumulativeOperatingHours

The cumulative operating hours of the asset. For machines this corresponds to the engine hour meter.
Unit of measurement: hours.

EngineFuelRate

Fuel rate of engine fuel consumption.
Unit of measurement: litres per hour.

EngineSpeed

Engine speed as measured in revolutions per minute of the engine crankshaft.
Unit of measurement: revolutions per minute.

EngineOilPressure

The pressure of the oil inside the engine.
Unit of measurement: kilopascal.

EngineOilTemperature

The temperature of the oil inside the engine.
Unit of measurement: degrees Celsius.

EngineCoolantTemperature

The temperature of the coolant fluid inside the engine.
Unit of measurement: degrees Celsius.

EngineCoolantLevel

The relative fill level of the coolant fluid used in the engine.
Unit of measurement: percent.

EngineExhaustTemperature

The temperature of the exhaust as measured inside the engine.
Unit of measurement: degrees Celsius.

FuelLevel

The relative fill level of the fuel tank of the machine.
Unit of measurement: percent.

WaterInFuelIndicator

Whether water is present in the fuel or not.
Unit of measurement: Boolean.

HydraulicTemperature

The temperature of the hydraulic system.
Unit of measurement: degrees Celsius.

HydraulicOilLevel

The relative fill level of the oil used in the hydraulic system.
Unit of measurement: percent.

BatteryPotential

The electric potential available in the machine's battery, typically the starter battery.
Unit of measurement: volt.

SeatBeltSwitch

Whether the seat belt is buckled in or not.
Unit of measurement: Boolean.

EnginepercentLoadAtCurrentSpeed

The relative load of the engine at the current engine speed.
Unit of measurement: percent.

PitchAngle

The pitch angle of the asset, typically as measured from front to back of the asset. Perpendicular to the roll angle.
Unit of measurement: degrees.

RollAngle

The roll angle of the asset, typically as measured from side to side of the asset. Perpendicular to the pitch angle.
Unit of measurement: degrees.

EngineTotalFuelUsed

The total amount of fuel used by the machine's engine in its lifetime.
Unit of measurement: litres.

AfterTreatmentDieselParticulateFilterSootLoadpercent

The relative load of soot in the machine's diesel particulate filter.
Unit of measurement: percent.

AfterTreatmentDieselParticulateFilterAshLoadpercent

The relative load of ash in the machine's diesel particulate filter.
Unit of measurement: percent.

AfterTreatmentDieselParticulateFilterTimeSinceLastActiveRegeneration

The time since the last active regeneration of the machine's diesel particulate filter.
Unit of measurement: seconds.

AfterTreatmentDieselParticulateFilterPassiveRegenerationStatus

Whether passive regeneration of the machine's diesel particulate filter is happening, or not.
Unit of measurement: Boolean.

AfterTreatmentDieselParticulateFilterActiveRegenerationStatus

Whether active regeneration of the machine's diesel particulate filter is happening (or possibly inhibited), or not.
Unit of measurement: Boolean.

AfterTreatmentDieselParticulateFilterStatus

Whether regeneration of the machine's diesel particulate filter is needed, or not.
Unit of measurement: Boolean.

AfterTreatmentDieselExhaustFluidTankLevel

The relative fill level of the machine's diesel exhaust fluid tank.
Unit of measurement: percent.

AfterTreatmentDieselExhaustFluidTankTemperature

The temperature of the machine's diesel exhaust fluid tank.
Unit of measurement: degrees Celsius.

AfterTreatmentDieselExhaustFluidConcentration

The relative concentration of the fluid in the machine's diesel exhaust fluid tank.
Unit of measurement: percent.

DieselParticulateFilterActiveRegenerationInhibitedDueToInhibitSwitch

Whether regeneration of the machine's diesel particulate filter is being inhibited by an operator switch.
Unit of measurement: Boolean.

Payloadpercentage

The relative payload of the machine, relative to the rated limit.
Unit of measurement: percent.

GeneratorTotalKwHoursExport

Cumulative exported energy of a generator.
Unit of measurement: kilowatt-hours.

HydraulicOilFilterRestrictionSwitch

Whether the flow of oil in the hydraulic system is restricted by a clogged oil filter.
Unit of measurement: Boolean.

TotalVehicleDistance

The total distance travelled by the machine.
Unit of measurement: Kilometre.

TotalPowerTakeOffHours

The cumulative time the machine has been driving an implement through a power take-off.
Unit of measurement: seconds.

Altitude

The altitude of the asset above mean sea level.
Unit of measurement: metres.

EngineFuelDeliveryPressure

The pressure with which fuel is being delivered to the engine.
Unit of measurement: kilopascal.

EngineCoolantPressure

The pressure of coolant fluid inside the engine.
Unit of measurement: kilopascal.

WheelBasedVehicleSpeed

The speed of the machine as calculated at the wheels.
Unit of measurement: kilometres per hour.

BarometricPressure

The pressure of the ambient atmosphere.
Unit of measurement: kilopascal.

AmbientAirTemperature

The temperature of the ambient atmosphere.
Unit of measurement: degrees Celsius.

EngineIntakeAirTemperature

The temperature of the air as measured at the engine intake.
Unit of measurement: degrees Celsius.

RoadSurfaceTemperature

The temperature of the road surface.
Unit of measurement: degrees Celsius.

EngineIntakeManifoldTemperature

The temperature of the air as measured at the engine intake manifold.
Unit of measurement: degrees Celsius.

EngineAirFilterDifferentialPressure

The difference in air pressure as measured across the engine air filter.
Unit of measurement: kilopascal.

CumulativeIdleHours

The cumulative hours hours the machine has been idle.
Unit of measurement: hours.

BatteryChargerState

Whether the battery charger is charging the machine's battery or not.
Unit of measurement: Boolean.

BatteryChargerPowerLineState

Whether the battery charger is connected to a powerline or not.
Unit of measurement: Boolean.

BatteryChargerOutputvoltage

The output voltage of the battery charger.
Unit of measurement: volt.

BatteryChargerOutputCurrent

The output current of the battery charger.
Unit of measurement: ampere.

EngineTripFuel

Fuel consumed by the engine since last trip reset.
Unit of measurement: litres.

AfterTreatmentDieselParticulateFilterDifferentialPressure

The difference in air pressure as measured across the machine's diesel particulate filter.
Unit of measurement: kilopascal.

AfterTreatmentDieselParticulateFilterIntakeTemperature

The temperature of the air as measured at the intake of the machine's diesel particulate filter.
Unit of measurement: degrees Celsius.

AfterTreatmentExhaustTemperature

The temperature of the exhaust air of the machine's diesel particulate filter.
Unit of measurement: degrees Celsius.

EngineFuelTemperature

The temperature of the fuel inside the engine.
Unit of measurement: degrees Celsius.

EngineIntakeAirPressure

The pressure of the air as measured at the engine intake.
Unit of measurement: kilopascal.

EngineIntakeManifoldPressure

The pressure of the air as measured at the engine intake manifold.
Unit of measurement: kilopascal.

EngineIntercoolerTemperature

The temperature of the engine intercooler.
Unit of measurement: degrees Celsius.

EngineOilLevel

The relative fill level of the oil used in the engine.
Unit of measurement: percent.

EngineTotalIdleFuelUsed

The total amount of fuel used by the machine while idling.
Unit of measurement: litres.

ExhaustSystemHighTemperatureLampCommand

Whether the exhaust temperature is too high.
Unit of measurement: Boolean.

HydraulicPressure

The pressure delivered by the hydraulic system.
Unit of measurement: kilopascal.

TransmissionOilTemperature

The temperature of the oil inside the transmission.
Unit of measurement: degrees Celsius.

AverageLoadFactorLast_24Hours

The average load factor of the asset over the last 24 hours, compared to the rated output.
Unit of measurement: percent.

CumulativeActiveRegenerationHours

The cumulative hours the machine has spent actively regenerating the machine's diesel particulate filter from soot particles.
Unit of measurement: hours.

CumulativeIdleNonOperatingHours

The cumulative hours the machine has spent with the engine running, but without any operator inputs.
Unit of measurement: hours.

CumulativeLoadCount

The cumulative number of loads the machine has performed.
Unit of measurement: count.

CumulativePayloadTotals

The cumulative total of all payloads the machine has performed.
Unit of measurement: kilogram.

EngineStatus

Whether the engine is running, or not.
Unit of measurement: Boolean.

FuelUsedLast_24Hours

The total amount of fuel used by the machine in the last 24 hours.
Unit of measurement: litres.

MaximumSpeedLast_24Hours

The maximum speed the machine attained in the last 24 hours.
Unit of measurement: kilometres per hour.

FuelTankCapacity

The total capacity of the machine's fuel tank.
Unit of measurement: litres.

CumulativeProductiveHours

Cumulative number of hours the Machine has been productive.
Unit of measurement: hours.

CumulativeMovingHours

Cumulative number of hours where the Equipment has been moving/driving, e.g. as registered by the Gps unit.
Unit of measurement: hours.

Speed

Speed of the machine (car/vehicle,equipment,boat,etc) regardless of moving by its own power or something else is moving it.
Unit of measurement: kilometres per hour.

Updated 9 days ago

Trackunit Data Model


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.