Map View
Monitor live driver positions, manage last-minute assignments geographically, and respond to the "Signal Lost" alert (FR393).
Overview
The Map View (screen G-03) provides a geographic overview of all active missions and driver positions. It is powered by server-sent events (SSE) that push GPS coordinates from the driver mobile app in real time, so driver markers move as the driver moves — no refresh required.
When to use it: the Map View is most useful for last-minute mission management, handling incidents, and visually identifying the nearest available driver for an urgent request.
Screenshot note: live map tiles and driver position markers are masked in the Playwright harness screenshots to ensure pixel-deterministic testing (FR414). The actual interface shows a full interactive map.
Driver markers
Each online driver appears as a pin on the map. The pin color indicates their current state:
| Color | State |
|---|---|
| Green | Available — no active mission |
| Blue | On a mission |
| Amber | Mission ending soon (within 30 minutes) |
| Grey | Offline / not transmitting |
Click a driver marker to open a driver detail popover showing:
- Driver name and photo
- Current vehicle plate and category
- Active mission reference (if any) with ETA at destination
- Available slots — the next window the driver would be free
FR393 — Signal Lost badge
FR393 — Driver Silent Alert applies to drivers who are currently on a mission but whose GPS signal has not been received for a configurable interval (default: 5 minutes).
When the threshold is exceeded:
- The driver's marker changes to an amber "Signal Lost" badge on the map.
- A notification appears in the operator's alert feed.
- The operator can click the badge to open a panel with the last known position, the time since the last signal, and the mission in progress.
- From that panel, the operator can tap Alert driver to send an in-app push notification prompting the driver to check their connection.
Signal Lost does not automatically reassign the mission — that decision remains with the operator. If the driver does not recover signal within the secondary threshold (default: 15 minutes), the system escalates the alert to an incident status.
Mission pins
Pickup and drop-off points for active and upcoming missions appear as distinct pin types:
- Green flag — pickup point
- Checkered flag — drop-off point
- Clock pin — upcoming mission (more than 2 hours away)
Click a mission pin to see the mission summary. If the mission is unassigned, an Assign from here button lets you open the assignment wizard pre-filtered to nearby available drivers.
Geographic assignment
The map view integrates directly with the assignment workflow:
- Click an unassigned mission pin.
- Click Assign from here in the mission popover.
- The Direct Assignment wizard opens (screen G-06), with drivers pre-sorted by proximity to the pickup point.
- Select a driver and confirm. RSE compliance checks run as usual.
The map also supports a drag-to-assign gesture: drag a mission pin onto a driver marker to initiate the assignment confirmation modal. This is a fast-path for operators comfortable with the geographic view.
Filtering the map
Use the layer controls (top-right) to toggle visibility of:
- Active missions — show/hide mission pins
- Available drivers — show/hide green driver markers
- Offline drivers — show/hide grey markers
- Signal Lost — highlight only drivers with the Signal Lost badge
The search bar (top-left) accepts driver names or mission references to pan the map to a specific point of interest.
Related pages
- Gantt View — timeline view for temporal planning
- List View — tabular view for bulk processing
- Direct Assignment — step-by-step driver selection wizard
- RSE Compliance — compliance checks applied at assignment
List View
Process missions efficiently in the dispatch list — table columns, filters, per-mission actions, sorting, and bulk assignment.
Broadcast Pipeline
Send a mission offer to multiple eligible drivers simultaneously — dispatch mode choice, broadcast tracking, driver proposals, and the anti-duplicate safeguard (FR395).