Live tracker

Path: /dashboard/live-tracker

Purpose

See all vehicles with recent telemetry on a map, filter by movement and device connection state, search by text, and open a per-vehicle detail view with speed, location, and links into fleet management.

Prerequisites

• Permission: view_vehicle.
• Data loads from Vehicles.all (full vehicle list for tracking).

Layout

• Large screens: Left column (vehicle list or selected vehicle detail) and right column (map).
• Small screens: Full-screen map with a bottom sheet for the list and detail; use the floating chip to open the sheet and expand heights as needed.

Step-by-step: browse and filter

1. Open Live tracker from the sidebar.
2. Wait for the list to load; counts reflect filtered vehicles.
3. Optional: open Filters (filter button next to the list title).
   • Movement status and Device / connection status come from data lookups (live_tracking movement and connection lookup kinds).
   • Apply to update URL search params: movementStatus, deviceStatus.
4. Optional: use Reset in the filter popover to clear movement and device filters (search text is kept).
5. Use the Search field (URL param search).
   • The list hint mentions plate, make, model, or company name; the client filter matches plate number, make, and model (case-insensitive substring).

Map legend (movement)

You can toggle legend items to require vehicles to match driving, idle, or parked movement buckets (client-side filter on top of API data).

Select a vehicle

1. Click a vehicle in the list or its marker on the map.
2. The detail view shows movement badge, plate, telemetry-based speed, last update time, address (reverse geocode when coordinates are valid), and a link to open the full vehicle in Fleet management.
3. Use Back to return to the list (desktop) or collapse the sheet flow on mobile.

URL parameters (bookmarkable)

Legacy alias: vehicleStatus is read as movementStatus if movementStatus is absent.

Troubleshooting

• Empty map or list: No vehicles returned for your scope, or filters/search exclude everything. Reset filters and clear search.
• Markers at (0,0): Telemetry missing or invalid coordinates; check device assignment and live data pipeline.
• Access denied / redirect home: Missing view_vehicle; ask an admin to adjust your role.