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
• 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:

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, muted gray when OFF. Hidden if the attribute is not reported by the device.
• 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. 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
• 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 (ellipsis icon, left) — opens a dropdown listing reports for the selected vehicle. 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.

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