📖 Afaqy Knowledge Base / Smart Taxi / Driver App / Troubleshooting
Overview
The Troubleshooting section helps drivers identify, understand, and resolve common operational issues encountered while using the Smart Taxi Driver App.
Most operational issues are related to:
- Internet connectivity
- Authentication failures
- Device synchronization
- Passenger tablet communication
- GPS connectivity
- Trip synchronization
- Compliance integration
This guide provides recommended actions for restoring normal operation.
Authentication Issues
Unable to Log In
Symptoms
- Login fails
- Invalid credentials message appears
- Authentication screen remains inaccessible
Possible Causes
- Incorrect username or password
- Internet connectivity issues
- Driver account restrictions
- Backend service interruption
Resolution
- Verify internet connectivity.
- Confirm username and password are entered correctly.
- Ensure the driver account is active.
- Restart the application.
- Attempt authentication again.
- Contact the system administrator if the issue persists.
Session Expired
Symptoms
- Driver is unexpectedly logged out.
- Application requests re-authentication.
- Operational functions become unavailable.
Possible Causes
- Session timeout
- Security policy enforcement
- Connectivity interruption
Resolution
- Log in again.
- Verify internet connectivity.
- Confirm backend services are reachable.
Connectivity Issues
No Internet Connection
Symptoms
- Real-time updates stop.
- Synchronization delays occur.
- Trip updates are not reflected in the system.
Possible Causes
- Mobile network outage
- SIM connectivity failure
- Weak signal coverage
Resolution
- Verify mobile data connectivity.
- Move to an area with stronger signal coverage.
- Restart mobile data services.
- Restart the application if necessary.
Backend Synchronization Delays
Symptoms
- Trip information updates slowly.
- Operational status changes are delayed.
- Dashboard information does not refresh immediately.
Possible Causes
- Temporary network congestion
- Backend processing delays
- Intermittent connectivity
Resolution
- Maintain internet connectivity.
- Allow synchronization to complete.
- Avoid repeatedly restarting the trip workflow.
- Report persistent synchronization issues.
GPS Issues
GPS Location Not Updating
Symptoms
- Vehicle position remains unchanged.
- Distance calculations appear inaccurate.
- Trip tracking becomes inconsistent.
Possible Causes
- GPS signal obstruction
- GPS device malfunction
- Device synchronization failure
Resolution
- Move the vehicle to an open area.
- Verify GPS hardware operation.
- Restart the application.
- Confirm device synchronization status.
Incorrect Distance Calculations
Symptoms
- Distance traveled appears inaccurate.
- Fare calculations seem inconsistent.
Possible Causes
- GPS interruptions
- Delayed location updates
- Device synchronization issues
Resolution
- Verify GPS signal availability.
- Check connectivity status.
- Confirm device synchronization is active.
- Report recurring discrepancies to system administrators.
Passenger Tablet Issues
Passenger Tablet Not Responding
Symptoms
- Tablet screen remains inactive.
- Passenger information does not update.
- Trip status is not reflected on the tablet.
Possible Causes
- Tablet connectivity issue
- Device synchronization failure
- Tablet application malfunction
Resolution
- Verify tablet power status.
- Confirm tablet connectivity.
- Verify pairing between the Driver App and tablet.
- Restart the tablet application if required.
Fare Information Not Updating on Tablet
Symptoms
- Passenger tablet displays outdated fare information.
- Distance and trip duration do not change.
Possible Causes
- Synchronization interruption
- Connectivity instability
- Backend communication delays
Resolution
- Verify internet connectivity.
- Confirm active trip synchronization.
- Allow synchronization to complete.
- Report persistent issues to support teams.
Trip Lifecycle Issues
Unable to Start a Trip
Symptoms
- Trip Start action fails.
- Driver remains in Available status.
- Passenger tablet does not enter trip mode.
Possible Causes
- Incomplete authentication
- Vehicle validation failure
- Connectivity issues
- Compliance validation failure
Resolution
- Verify authentication status.
- Confirm assigned vehicle information.
- Verify connectivity.
- Retry trip initiation.
Trip Does Not End Successfully
Symptoms
- Trip remains active after completion.
- Passenger feedback screen does not appear.
- Final fare is not generated.
Possible Causes
- Synchronization interruption
- Backend communication failure
- Device validation issues
Resolution
- Verify internet connectivity.
- Confirm trip synchronization status.
- Retry trip completion.
- Contact support if the issue persists.
Compliance Issues
Compliance Synchronization Failure
Symptoms
- Trip dispatch confirmation is missing.
- Regulatory status appears incomplete.
- Compliance-related warnings appear.
Possible Causes
- Connectivity interruption
- Regulatory service outage
- Synchronization delays
Resolution
- Verify internet connectivity.
- Allow synchronization to complete.
- Review compliance status after synchronization.
- Escalate unresolved issues to support teams.
Emergency & SOS Issues
SOS Button Does Not Respond
Symptoms
- SOS action cannot be triggered.
- Emergency confirmation does not appear.
Possible Causes
- Connectivity interruption
- Device malfunction
- Application issue
Resolution
- Verify application responsiveness.
- Confirm internet connectivity.
- Restart the application if necessary.
- Report the issue immediately to operational support.
When To Contact Support
Drivers should contact support if:
- Authentication repeatedly fails.
- GPS data remains unavailable.
- Passenger tablet synchronization cannot be restored.
- Trips cannot be started or completed.
- Compliance workflows remain unresolved.
- Emergency functions do not operate correctly.
Best Practices
- Maintain stable internet connectivity throughout operations.
- Verify successful login before beginning trips.
- Monitor synchronization indicators regularly.
- Ensure GPS and passenger tablet devices remain operational.
- Report recurring issues immediately.
- Avoid force-closing the application during active trips.
