Telematics
Telematics is the source of truth for where your fleet is and what it's doing right now: vehicle positions on the map, geographic zones with breach alerts, and trips derived automatically from raw device readings. Telematics data also feeds other modules — vehicle mileage, fault codes and safety-event verification.
Who it's for
The dispatcher uses the live map and trip playback day to day. The fleet manager and organization administrator register devices, link them to vehicles and define geofence zones. Visibility of positions and trips follows the same site scope as the rest of the console.
Key concepts
A geofence is a circle (center and radius) on the map that the system reacts to with three kinds of events: entering, exiting, and dwelling past a configurable minute threshold — optional, for catching a vehicle that lingers too long in a zone. A stale device is a device linked to a vehicle that has stopped sending data for longer than the tolerance window.
Devices
You register a device with its vendor, an external identifier and a protocol; the system generates a one-time-visible signing secret the device uses to authenticate every data push. A newly registered device doesn't yet feed data to a specific vehicle — only linking it to a vehicle turns on reading attribution. A device can also be disabled, which blocks its data from being accepted.
Live map and trips
The fleet map shows current vehicle positions (refreshed on a cycle, at an adjustable rate), a geofence overlay, and a side panel listing vehicles. From the map you can also replay a specific trip's path as a route line on the map background. The system stitches raw position readings into trips on its own — it opens a new trip when driving starts and closes it once ignition goes off, tallying distance and top speed along the way.
In the background
Device readings arrive through an anonymous ingest endpoint (the tenant is resolved from the device, not from an organization header) and land in the time-series store; every accepted batch triggers trip derivation for that vehicle. Every few minutes, the system evaluates each vehicle's latest position against the active geofence zones and records any breaches. Every fifteen minutes the system closes trips left open (when no ignition-off signal arrived) and checks whether linked devices have stopped reporting — a stale device raises an alert for the fleet management roles.