Documentation

Live Tracking

The Tracking page displays all your vehicles on an interactive map with live position updates. Vehicle icons, status indicators, and sensor readings refresh automatically as new data arrives from your GPS devices — no page refresh needed.

Layout

The page is divided into two areas:

• Vehicle List — on the left sidebar (desktop) or via the list button (mobile)
• Map — the main area showing all vehicle positions

Vehicle List

The vehicle list lets you search, filter, and select vehicles. All vehicles are shown in a flat list — no grouping.

Toolbar

The toolbar sits above the vehicle list and contains three controls in a single row:

• Toggle button (left) — show or hide the vehicle list
• Search box (center) — type to filter vehicles instantly
• Filter button (right, funnel icon) — open the filter popover

An orange dot appears on the filter button whenever any filter is active.

Searching

Type in the search box to filter vehicles by name, device name, or license plate. Results update instantly.

Filters

Click the filter button to open a popover with the following options:

• Device Status — filter by Online, Offline, or Unknown. Each option shows a live count in parentheses.
• Vehicle Status — filter by the vehicle's operational status (Active, Standby, Reserve, In Repair, In Accident, Under Inspection, Sold, Rented Out, Impounded, Out of Service, Decommissioned). Only appears when your fleet has at least one vehicle in a non-Active status.
• Group — filter by device group. Only appears when your fleet has groups assigned.
• Sort by — sort the list by name or last update time. Default order is the order your vehicles are registered.
• Filter on map — when checked, vehicles that don't match the active filters are also hidden from the map, not just from the list.
• Clear Filters — appears at the bottom of the popover when any filter is active. Resets all filters at once.

Vehicle Rows

Each row shows:

• Icon — a category-specific icon (car, bus, truck, motorcycle, etc.) in a circular badge, colored to reflect the vehicle's current movement status
• Vehicle name — primary label
• Sub-label — a secondary line showing the license plate (or another configured field such as device name) and the online/last-seen status
• Status indicators (right side) — sensor and device status icons

Online Status Text

The sub-label line includes a colored status text:

Movement Status

The vehicle icon's circular badge is colored to reflect its current movement state, based on GPS speed, ignition, and how fresh the last position is. Hover the icon for the exact label.

The same status is also reflected in the vehicle's marker color on the map, and as a small badge next to its name in the Status Card (see below). On the map, Stopped is shown in gray instead of white, since white would be invisible against the marker's white background.

Status Indicators

Each vehicle row can show additional icons on the right side, depending on what the GPS device reports:

• Ignition (engine icon): Green when ignition is ON and the vehicle is moving, amber when ON but idling, gray when OFF. Also shown in gray labeled "Stopped" (hover to tell them apart) when the position is too old to trust the ignition reading, as long as the device isn't confirmed offline. Hidden entirely if the device doesn't report ignition, or once confirmed offline / stale for a long time.
• Battery icon: Shows current battery level with a matching icon. Charging is indicated separately. Color changes from green → amber → red as the level drops.
• Fuel icon (droplet): Shown when fuel sensors with calibration data are configured. Displays the combined fuel reading in liters across all calibrated fuel sensors.
• Eco Score (steering wheel icon): Shown when driving score sensors are configured. Color reflects the score range: green (≥ 8 excellent), gray (≥ 6 good), amber (≥ 4 fair), blue (≥ 2 poor), red (< 2 very poor).
• Vehicle Status icon: Shown only when the vehicle's status (set on the Vehicles page) is not Active — e.g. In Repair, In Accident, Sold. Hover for a tooltip with the status label.
• Lock icon: Shown on vehicles not available on your current plan. These vehicles cannot be selected.

Selecting a Vehicle

Click a vehicle row to center the map on it and open its status card. On mobile, the vehicle list closes automatically after selection.

Map

The map is powered by MapLibre GL with support for multiple tile layers.

Markers

Each vehicle appears as a circular marker with a category-specific icon (car, bus, truck, motorcycle, etc.) inside, colored to match the vehicle's Movement Status (see Vehicle List above) — green for Moving, amber for Idling, gray for Parked, and so on. A direction indicator shows the vehicle's current heading (course). Markers can optionally display a label below them — the label type (name, license plate, speed, etc.) is configured in map preferences.

When multiple vehicles are close together, they are grouped into a cluster badge showing the count. Clusters break apart automatically when you zoom in.

Status Card

When you select a vehicle — either from the list or by clicking a marker on the map — a status card appears at the bottom-center of the map. It shows:

• Vehicle name — with a small badge next to it showing its Movement Status (Moving, Idling, Parked, Stopped, Offline, or Unknown)
• Speed — current speed in km/h
• Device name
• Fuel — total fuel level in liters (shown only if calibrated fuel sensors are configured)
• Eco Score — driving performance score (shown only if score sensors are configured)
• Last seen — relative time of the last GPS update

Report Shortcuts

Below the readings, the status card shows a row with two controls side by side:

• Reports menu (left) — opens a dropdown listing reports for the selected vehicle, in the same order as the Reports menu in the sidebar. Choosing one jumps straight to that report, pre-filled for today and generated automatically — no need to pick a vehicle or date range again. Each entry only appears if you have the matching report permission:

• See Details button (right) — opens the full Vehicle Details drawer (only visible with the tracking:details permission).

The reports menu only appears if at least one report permission is granted.

Close the status card with the × button. The card disappears automatically when the Vehicle Details drawer is opened.

Live Video

For dashcams and other GPS devices connected via the JT/T 808 protocol with JT/T 1078 video support, a camera icon button appears in the status card's action row, next to the Reports menu.

Click it to open the Live Video player:

• Channel — choose which camera channel to view (1–4) from the dropdown in the modal header.
• The stream starts automatically when you open the modal and stops automatically when you close it.
• Only one channel streams at a time — switching channels stops the previous one and starts the new one.
• If the device doesn't respond within a few seconds (e.g. it's powered off or has no signal), a "Connection error" message appears in place of the video.

This button only appears for devices reporting the jt808 protocol — regular GPS trackers without video hardware won't show it.

Travel Paths

A colored trail shows each vehicle's recent path. The trail is kept at up to the last ~0.5 km of travel. Older points are trimmed automatically as the vehicle moves.

Map Controls

• Zoom: Zoom controls on the map, or pinch/scroll
• Fullscreen: Fullscreen button on the map
• Layer switcher: Switch between map tile layers (OpenStreetMap, Google, Yandex, Carto, MapTiler, and more — depending on which API keys are configured)
• Auto-fit: On page load, the map automatically zooms to fit all vehicles with known locations

Filter on Map

When the Filter on map option is enabled in the filter popover, only vehicles matching the current search and filter criteria are shown as markers on the map. All other markers are hidden.

Auto-Follow

When you select a vehicle, the map automatically pans to follow it as it moves. This continues as long as the vehicle remains selected.

Vehicle Details

Clicking See Details in the status card opens a searchable details drawer. On desktop it slides in from the right; on mobile it slides up from the bottom. The data is organized into four sections:

Device Info

GPS device details: name, identifier (IMEI), phone, contact, category, model, status, group, and expiration date.

Sensors

Readings from configured sensors, organized by type:

• Fuel Sensors: Individual readings per sensor, calibrated values where calibration is set up. If multiple fuel sensors exist, a combined total is shown.
• Eco Score Sensors: Individual and average driving scores across multiple sensors.

Vehicle Info

Vehicle registration details: name, status (and status reason, if set), make, model, year, license plate, VIN, type, capacity, and notes.

Attributes

All other raw data reported by the GPS device — altitude, temperature, ignition state, motion, satellites, HDOP, RPM, voltage, power, and any other custom attributes.

Use the search box at the top of the drawer to quickly find any field by name.

Real-Time Updates

The tracking page uses WebSocket connections (one per device) to receive live updates:

• Vehicle positions update instantly as new GPS data arrives
• Online status text updates immediately in each vehicle row
• Status card refreshes automatically when the selected vehicle reports a new position
• Travel paths extend in real-time as vehicles move
• Auto-follow pans the map to keep the selected vehicle in view

WebSocket connections are opened when you enter the page and closed when you leave — there is no background polling.

Mobile

On mobile devices:

• The vehicle list fills the full screen when open — tap the toggle button (top-left of the map) to show or hide it
• Selecting a vehicle from the list closes the list automatically and returns to the map view
• The Vehicle Details drawer slides up from the bottom
• All real-time features work the same as on desktop