Real-time Tracking
Track your passengers' transportation in real-time. See exactly where the vehicle is and when it will arrive at their stop.
Starting a Tracking Session
Tracking is launched directly from a passenger's card on the Passengers screen.
Each route row on a passenger card shows:
- Route name and shift details (shift name, start time – end time)
- A Track button on the right
The Track button behaves based on the current time:
- Active shift: Button is highlighted (primary color). Tap it to open the live tracking map
- Outside shift hours: Button is grayed out and shows a countdown timer (e.g.
01:45:22) until the shift begins. It cannot be tapped until the shift starts
The Tracking Map
The tracking map opens full-screen and shows:
Vehicle Marker
The vehicle is shown as an icon matching its type (bus, van, car, etc.). As the vehicle moves, the marker updates automatically via a live WebSocket connection.
Stop Markers
Stops assigned to the passenger are shown as numbered map markers in route order. Tap any stop marker to see its details in a bottom drawer (stop name, address, assigned passenger stops).
Route Polyline
A blue line connects the stops in order, showing the planned route path. The polyline is drawn using actual road directions when available.
Connection Status
A status indicator shows whether the live connection is active:
- Connecting: Displayed while establishing the WebSocket connection
- Connected: Vehicle position updates are live
- Error: If the connection fails, an error message is shown
Live Updates
Once connected, the map updates automatically:
- Vehicle position refreshes in real time as the vehicle moves
- The map pans to follow the vehicle when it moves significantly
- Stop arrivals are reflected in real time
Vehicle Has No GPS Device
If the route's vehicle does not have a tracking device assigned, tapping the Track button shows a warning: "No device assigned to this vehicle." Contact your transportation coordinator if you believe this is an error.
Privacy and Security
- Only you can view tracking for your own registered passengers
- All location data is transmitted over an encrypted connection
- You cannot view tracking for vehicles or passengers not linked to your account