Skip to main content

Vehicle Telemetry

Vehicle telematics data is available for both construction equipment and agriculture machinery. These endpoints are based upon the ISO 15143-3 Specification.

Metrics​

The Metrics endpoints support several parameters when retrieving data.

The table below contains a list of parameters that can be found in returned data from GET requests.

Parameter NameDescription
AREATotal area covered or processed by the machinery.
AREA_REMAINRemaining area that the machine is expected to cover or process.
BALE_DROP_DETECTEDIndicates whether a bale has been dropped during baling operations.
BALE_LENGTH_SETPOINTThe target length for the bales being produced.
BATTERY_VOLTAGEVoltage of the vehicle’s battery, monitoring electrical system health.
CHARGEBattery charge level, typically for electric or hybrid systems.
CROP_TYPEType of crop being processed, which influences operation settings.
DEF_LEVELDiesel Exhaust Fluid (DEF) level for emission control systems.
ENG_COOLANT_TEMPTemperature of the engine's coolant, critical for preventing overheating.
ENG_FUEL_RATEFuel consumption rate.
ENG_HOURSTotal engine run time, used to track usage and maintenance scheduling.
ENG_LOADPercentage of engine capacity currently in use.
ENG_OIL_PRESSOil pressure, essential for proper engine lubrication.
ENG_OIL_TEMPTemperature of the engine oil, important for performance and overheating prevention.
ENG_SPEEDEngine speed.
FLYWHEEL_SHEARBOLT_ACTIVEIndicates whether the flywheel shear bolt has activated, protecting the machine during blockages.
FUEL_LEVELRemaining fuel in the tank, used for monitoring refuelling needs.
GPS_ALTGPS-based altitude showing the current elevation of the machine.
GPS_DIRGPS-based direction of movement, used for precision farming.
GPS_SPEEDGPS-based speed of the machine.
GROUND_SPEEDSpeed relative to the ground, used for adjusting operations based on field conditions.
GSS_FIELDGeographic field ID or name for tracking specific field operations.
HYDRAULIC_PRESSURE_SLICEHydraulic pressure for a specific section of the machine's operation.
INCHAMBER_BALE_LENGTHCurrent length of the bale in the chamber, tracked in real time.
KNOTTER_TOTAL_BALECOUNTTotal number of bales tied by the knotter mechanism.
KNOTTER_TOTAL_BALRCOUNTAlternative metric tracking the total number of bales tied by the knotter system.
LAST_BALE_CAPACITYCapacity or density of the last bale produced, used for quality control.
LAST_BALE_DENSITYDensity of the last bale, showing how tightly material is packed.
LAST_BALE_MOISTUREMoisture content of the last bale, important for quality and storage.
LAST_BALE_NMB_KNIVESNumber of knives used to cut the last bale, affecting its size and composition.
LAST_BALE_SIZESize of the last bale produced.
LAST_BALE_SLICESNumber of slices or sections within the last bale, tracking the baling process.
LAST_BALE_WEIGHTWeight of the last bale produced, important for tracking yield.
LAST_BALE_WEIGHT_DRYDry weight of the last bale, accounting for moisture.
LIFETIME_BALE_COUNTTotal number of bales produced by the machine over its lifetime.
LIFTTIME_BALE_COUNTDuplicate or alternative metric for lifetime bale count.
LOAD_SETPOINTTarget load or pressure set for the machinery’s operations.
MOISTURE_SLICEMoisture content in a specific slice of the bale, used for monitoring distribution.
NEEDLE_YOKE_SHEARBOLT_ACTIVEIndicates if the needle yoke shear bolt has activated, a safety feature in balers.
OVERLOAD_DETECTEDFlag indicating that an overload condition has been detected.
PICKUP_SLIP_ACTIVEIndicates that the pickup mechanism is slipping, possibly due to blockage or excessive material.
PRESERVATIVE_ACTUAL_APPL_RATEActual rate of preservative being applied during baling.
PRESERVATIVE_TARGET_APPL_RATETarget rate for preservative application, based on crop and conditions.
RAT_LOADCurrent load on the Rate Application Technology (RAT) system, used for variable-rate applications.
ROTOR_CUT_OUT_FLAGIndicates if the rotor has cut out, possibly due to overload or blockage.
STATUS_DUTYOperational status of the machine, indicating whether it's active, idle, or in maintenance mode.
STUFFER_SHEARBOLT_ACTIVEIndicates if the stuffer shear bolt has activated, another safety feature on baling machinery.
THICKNESS_SLICEThickness of slices within the bale, important for ensuring uniformity.
WORKING_MODECurrent working mode of the machine, such as working, transport, or idle mode.

Error Tags​

This table describes the error tags that can be returned when fetching metrics, alerts and faults.

Error tags will be returned as a comma separated list labelled errorTags in the telemetry object. An empty string indicates no errors were present.

Error TagDescription
ALARM_NOT_ENRICHEDInternal processing error. This one event might be missing some metadata.
COUNTRY_NOT_ENRICHEDEquipment did not have GPS fix at the time. This one metric has unreliable position related metadata.
ECU_NOT_ENRICHEDNot applicable. This error tag is not expected to occur.
FAULT_NOT_ENRICHEDInternal processing error. This one event might be missing some metadata.
GPS_TIMESTAMP_MISSINGEquipment did not report a GPS timestamp at the time. This one metric has unreliable time and position related metadata.
METRIC_OUT_OF_BOUNDEquipment reported unrealistic value for this one metric.
NONE_VALUEEquipment reported a missing value or null value for this one metric.
POSITION_MISSINGEquipment did not have GPS fix at the time. This one metric has unreliable position related metadata.
SV_ECU_NOT_ENRICHEDNot applicable. This error tag is not expected to occur.
TIME_ZONE_NOT_ENRICHEDEquipment did not have GPS fix at the time. This one metric has unreliable position related metadata.
SOURCESYSTEMDATETIME_UNKNOWNThis Error Tag is expected When Activation TimeStamp is not available from the Alerts or Faults Collocated endpoint responses