Vehicles
This section covers the vehicle list, the detailed card for a single vehicle and the movement simulation mode.
The vehicle list
Open it from Manage → Vehicle or at /vehicles.
The table columns:
| Column | Contents |
|---|---|
| Plate | Registration plate |
| Status | Moving, Idle, Stopped, Loading |
| Speed | Current speed, km/h |
| Device | The bound GPS tracker |
| Trip | Active if the vehicle is currently on a trip |
Below the table sit the "25 shown · 348 total" counter and paging controls. The search field filters by plate and name.
Double-click a row to open the vehicle page.
On this page the sidebar gains a Fleet list with search ("Search vehicles..."), sorting (Default, Name, Status) and grouping (None, Status). The Device online and Device offline icons show tracker state.
The vehicle page
Reached by double-clicking a list row, from the map card, or at /vehicles/:id.
Header card
The card at the top of the page holds:
- A photo of the vehicle. Replace it by dropping a file onto the "Drop front photo" area; Uploading… appears while it transfers. The angle is labelled Front 3/4.
- Live telemetry: speed, course, coordinates, satellite count ("12 satellites"), data lag.
- Current location — address or coordinates.
- Inside zones — the geofences the vehicle is inside right now.
- Map marker — the marker colour for this vehicle; change it to make the vehicle stand out among the others.
- The Today · trips and Today · distance figures.
Action buttons: Track on map, Simulation, Edit, Back.
Choosing a period
The range switch at the top of the page offers Today, Last 7 days, Last 30 days, Last 90 days. It drives the Statistics, Trips and Recent events blocks.
Statistics
Aggregates for the selected period: distance, trip count, maximum speed, time moving. With no data: "No statistics for this period."
Trips
The trips in the period, subtitled "Select trips to draw their route & speed".
- Selecting one or several trips draws their tracks in the Trip route block; each trip gets its own colour.
- Below, the Speed profile opens with max and avg markers and the sample count ("428 samples").
- Hovering the chart highlights the matching position on the map.
- Events that occurred during the trip are marked on the chart and can be opened from there.
With no trips: "No trips recorded for Last 7 days."
Recent events
The vehicle's latest activity: geofence entries and exits, started moving, stops, overspeed, alarms. The full filterable log is on the Events page.
Destinations
Every assigned arrival point ("12 total · all statuses"). Each row shows:
- its status — On the way, Arrived, Canceled;
- ETA HH:MM or No forecast;
- Forecast built … — when the forecast was computed;
- Time on route … — how long the vehicle has been heading there.
Add destination switches the system into map point-picking mode ("Click map…").
Cargo
A block with two tabs:
- Current — what is loaded right now. Empty: "No cargo currently loaded."
- History — what was carried before. Empty: "No cargo history."
Each entry links to its cargo page.
Devices
The GPS trackers bound to the vehicle ("GPS trackers · current & past").
To bind a tracker:
- Press Add device.
- Enter the tracker's unique identifier in the Device ID field (for example
7501045940). - Press Add.
Without a bound tracker the vehicle reports no telemetry: "No GPS trackers bound to this vehicle."
Routes
This tab lists the public-transport routes assigned to this vehicle, with a Show route line toggle. With no assignments: "No routes assigned to this vehicle." See Public transport for details.
Below it, Next stops (forecast) shows the predicted arrival times at the upcoming stops of the assigned route.
Notifications
The Alert me about this vehicle block holds subscription toggles for this particular vehicle:
| Event | When it fires |
|---|---|
| Geozone enter | Vehicle enters any zone |
| Geozone exit | Vehicle leaves any zone |
| Came online | Tracker reconnected |
| Went offline | Tracker stopped reporting |
| Stopped | Vehicle came to a stop |
| Started moving | A new trip started |
| Overspeed | Exceeded the speed limit |
| Alarm | Panic / SOS signal |
| Destination reached | Arrived at a set destination |
| New destination set | A destination was assigned to the vehicle |
| Running late | Forecast to reach a transit stop behind schedule |
Delivery channels (email, Telegram, in-app, webhook) are configured separately — see Notifications.
Documents
The attachments block: upload with Add, then download or delete per entry. The counter reads "3 attached".
Movement simulation
The /vehicles/:id/simulation page drives a virtual vehicle along a route you
draw. Use it to train operators, verify geofences and tune alert rules without
sending anyone out.
Creating a simulation route
- Open the vehicle page and press Simulation.
- Press New route.
- Click on the map to add waypoints: "Click the map to add waypoints…". At least two are required, otherwise you get "Draw at least two waypoints for the route."
- Drag a waypoint to move it, click one to remove it.
- Fill in the parameters:
- Name — the route name;
- Amplitude (km/h) — how much the speed swings;
- Period (s) — the period of those swings;
- Stop (s) — how long stops last.
- Press Create route.
Running the simulation
- In Simulation routes select one and press Drive this route — it becomes the Active route.
- Press Enable. The heading changes to Simulation on.
- The system spins up a virtual device and streams telemetry along the route — the vehicle drives across the map like a real one, producing events and geofence triggers.
- Disable stops the simulation.
Routes can be reordered with Move up and Move down, changed with Edit route and emptied with Clear.
Simulation produces real events and notifications. If subscriptions exist for this vehicle, recipients will see triggers from the virtual device.
Typical workflows
Bring a new vehicle online. Create the vehicle (on the map via the plus on the Vehicles layer, or by import) → open its page → Devices block → Add device → enter the tracker ID.
Investigate a speeding complaint. Vehicle page → period Last 7 days → Trips → pick the trip → Speed profile → find the spike and match it to the point on the map.
Verify a geofence works. Create a simulation route that passes through the zone, enable the simulation and confirm that entry and exit appear in Recent events.