Live GPS Tracking
When GPS tracking is active, passengers with a confirmed booking on your trip can see the bus moving on a live map. This feature builds passenger confidence and reduces calls asking "where is the bus?".
Starting tracking
- Select your trip in the Driver Dashboard.
- Tap Start Tracking (▶ button).
- Allow location permission if prompted.
- The status indicator turns green — Tracking active.
Location updates are sent to the server automatically at a regular interval (every 5 minutes by default, configurable by admin).
On the Android app, GPS tracking continues in the background even when the screen locks. This is important for long journeys — the driver does not need to keep the app open on screen.
Pausing tracking
Tap Pause (⏸) to temporarily stop sending location updates — for example during a long meal break. Tap Resume to continue.
Pausing is better than stopping entirely because passengers still see the last known position on the map.
Stopping tracking
Tap Stop Tracking (⏹) at the end of the journey. This removes the "Live" badge from the schedule in search results.
Always stop tracking when the journey is complete.
Location status indicators
| Status | Meaning |
|---|---|
| 🟢 Sending | Location sent successfully |
| 🟡 Paused | Tracking paused |
| 🔴 Error | Could not send location — check internet connection |
| ⚫ Idle | Tracking not started |
The timestamp of the last successful location update is shown next to the status.
What passengers see
Passengers tracking a live trip see:
- A map with the bus icon at the current GPS position
- The last-updated timestamp
- The route source and destination
The passenger tracking page is accessible from their ticket in My Bookings → Track Live.
Troubleshooting
Location not updating?
- Check that mobile data or WiFi is connected.
- Make sure location permission is set to Always (not just "While in use") in the phone settings for the Android app.
- Tap Refresh to force a manual location send.
Tracking stops after screen lock?
- On the Android app, enable the background location permission.
- On the web browser, the tab must stay open and the screen must not be locked for long periods.