Accepting Rides

How to receive and accept trip requests from passengers

Receiving Trip Requests

When you’re online and available, Viax automatically searches for nearby trip requests and notifies you with sound alerts.

Trip requests are prioritized based on distance, ConfianzaScore, and whether passengers have marked you as a favorite driver.

Sound Notification System

Viax uses an audio notification system similar to Uber and DiDi to alert you of new ride requests:

How It Works

1. New Request Detected

   System finds a matching trip request near your location

2. Sound Alert Plays

   request_notification.mp3 plays at maximum volume to get your attention

3. Visual Panel Appears

   Trip details slide up from the bottom of the screen

4. 30-Second Timer

   You have 30 seconds to accept or reject the request

Sound Service Implementation

Sound Notification Service

import 'package:audioplayers/audioplayers.dart';

class SoundService {
  static final AudioPlayer _audioPlayer = AudioPlayer();
  
  /// Play notification sound for new trip request
  static Future<void> playRequestNotification() async {
    try {
      await _audioPlayer.setVolume(1.0); // Maximum volume
      await _audioPlayer.play(
        AssetSource('sounds/request_notification.mp3'),
        mode: PlayerMode.mediaPlayer,
      );
    } catch (e) {
      debugPrint('Error playing notification sound: $e');
    }
  }
  
  /// Play confirmation sound when accepting
  static Future<void> playAcceptSound() async {
    try {
      await _audioPlayer.play(
        AssetSource('sounds/accept.mp3'),
        mode: PlayerMode.mediaPlayer,
      );
    } catch (e) {
      debugPrint('Error playing accept sound: $e');
    }
  }
  
  /// Stop any currently playing sound
  static Future<void> stopSound() async {
    try {
      await _audioPlayer.stop();
    } catch (e) {
      debugPrint('Error stopping sound: $e');
    }
  }
}

Make sure your phone volume is turned up and not in silent mode, or you might miss ride requests!

Trip Request Information

Each request displays comprehensive information to help you decide:

Request Data Model

Trip Request View Model

class TripRequestView {
  final int id;                    // Request ID
  final int clienteId;             // Passenger user ID
  final String clienteNombre;      // Passenger name
  final String? clienteFoto;       // Passenger profile photo
  final double? clienteCalificacion; // Passenger rating
  
  // Origin details
  final double latitudOrigen;
  final double longitudOrigen;
  final String direccionOrigen;
  
  // Destination details
  final double latitudDestino;
  final double longitudDestino;
  final String direccionDestino;
  
  // Trip metrics
  final double? distanciaKm;       // Distance in kilometers
  final double? precioEstimado;    // Estimated price
  final DateTime fechaSolicitud;   // Request timestamp
  
  // Trust information
  final ConfianzaInfo? confianza;  // Trust score if available
  
  LatLng get origen => LatLng(latitudOrigen, longitudOrigen);
  LatLng get destino => LatLng(latitudDestino, longitudDestino);
}

Visual Request Panel

The request panel shows:

Passenger Info

• Name and photo
• Rating (if available)
• Favorite badge (if you’re their favorite)

Trip Details

• Pickup address
• Destination address
• Distance and duration

Earnings

• Estimated fare
• Your potential earnings
• Commission breakdown

Route Preview

• Map with route highlighted
• Distance to pickup
• Traffic conditions

Accepting a Request

Accept Flow

1. Review Details

   Examine the trip information displayed on the request panel

   Request Panel

   RequestActionPanel(
     request: selectedRequest,
     routeToClient: routeToClient,
     currentLocation: currentLocation,
     onAccept: _acceptRequest,
     onReject: _rejectRequest,
     onTimeout: _rejectRequest,
     isDark: isDark,
   )
   
2. Tap Accept Button

   Click the green “Accept” button to accept the trip

   Accept Request

   Future<void> _acceptRequest() async {
     if (_selectedRequest == null || _requestProcessed) return;
     _requestProcessed = true;
     
     // Stop notification sound
     SoundService.stopSound();
     
     // Show loading indicator
     showDialog(
       context: context,
       barrierDismissible: false,
       builder: (context) => Center(
         child: CircularProgressIndicator(color: AppColors.primary),
       ),
     );
     
     // Call API to accept request
     final result = await TripRequestSearchService.acceptRequest(
       solicitudId: solicitudData.id,
       conductorId: widget.conductorId,
     );
     
     Navigator.pop(context); // Close loading
     
     if (result['success'] == true) {
       // Navigate to active trip screen
       final viajeId = int.tryParse(result['viaje_id']?.toString() ?? '0');
       
       Navigator.pushAndRemoveUntil(
         context,
         MaterialPageRoute(
           builder: (context) => ConductorActiveTripScreen(
             conductorId: conductorId,
             solicitudId: solicitudData.id,
             viajeId: viajeId,
             clienteId: solicitudData.clienteId,
             origenLat: solicitudData.latitudOrigen,
             origenLng: solicitudData.longitudOrigen,
             destinoLat: solicitudData.latitudDestino,
             destinoLng: solicitudData.longitudDestino,
             direccionOrigen: solicitudData.direccionOrigen,
             direccionDestino: solicitudData.direccionDestino,
             clienteNombre: solicitudData.clienteNombre,
           ),
         ),
         (route) => false,
       );
     } else {
       // Show error - request already taken
       ScaffoldMessenger.of(context).showSnackBar(
         SnackBar(content: Text(result['message'] ?? 'Request unavailable')),
       );
     }
   }
   
3. Confirmation

   System assigns the trip to you and notifies the passenger

   • Trip status changes to “accepted”
   • Passenger receives notification
   • You’re navigated to active trip screen

Accept Request API

Trip Request Search Service

class TripRequestSearchService {
  static Future<Map<String, dynamic>> acceptRequest({
    required int solicitudId,
    required int conductorId,
  }) async {
    try {
      final response = await http.post(
        Uri.parse('$baseUrl/conductor/accept_request.php'),
        headers: {'Content-Type': 'application/json'},
        body: json.encode({
          'solicitud_id': solicitudId,
          'conductor_id': conductorId,
        }),
      );
      
      if (response.statusCode == 200) {
        return json.decode(response.body);
      } else {
        return {'success': false, 'message': 'Server error'};
      }
    } catch (e) {
      return {'success': false, 'message': 'Network error: $e'};
    }
  }
}

Rejecting a Request

Reject Flow

1. Tap Reject Button

   Click the red “Reject” button or let the timer expire

   Reject Request

   Future<void> _rejectRequest() async {
     if (_selectedRequest == null || _requestProcessed) return;
     _requestProcessed = true;
     
     // Stop notification sound
     SoundService.stopSound();
     
     final solicitudData = _selectedRequest!;
     setState(() {
       _selectedRequest = null;
       _routeToClient = null;
     });
     
     // Mark as processed to avoid duplicate actions
     TripRequestSearchService.markRequestAsProcessed(solicitudData.id);
     
     // Notify server of rejection
     await TripRequestSearchService.rejectRequest(
       solicitudId: solicitudData.id,
       conductorId: widget.conductorId,
       motivo: 'Driver declined',
     );
     
     // Return to searching screen
     if (mounted) Navigator.pop(context);
   }
   
2. Request Released

   Request becomes available for other drivers

   • Your rejection is logged
   • Request offered to next available driver
   • You continue searching for other requests

Important: Excessive rejections may affect your priority in receiving future requests. Only reject if you have a valid reason.

Request Prioritization

How Requests Are Assigned

Viax uses intelligent prioritization to match drivers with passengers:

Distance Priority

Closer drivers see requests first

• Distance from your location to pickup point
• Estimated time to reach passenger
• Real-time traffic considerations

ConfianzaScore

Trust relationship between you and passenger

Confianza Scoring

ConfianzaScore calculation:
- Previous trips together: 30%
- Your average rating: 25%
- Passenger's ratings of you: 15%
- Zone proximity: 20%
- Neighborhood popularity: 10%
- Bonus: +100 if passenger marked you as favorite

Favorite Status

Passengers can mark preferred drivers

If a passenger has marked you as favorite:

• You get priority notification
• +100 point bonus to ConfianzaScore
• Badge displayed in request panel

Availability

Driver status and capacity

• Must be online and available
• No active trip in progress
• Profile approved and complete

Request List Response

From the backend API:

{
  "success": true,
  "total": 1,
  "solicitudes": [
    {
      "id": 123,
      "usuario_id": 45,
      "nombre_usuario": "Juan Pérez",
      "foto_perfil": "uploads/profile/45.jpg",
      "latitud_origen": 4.6097,
      "longitud_origen": -74.0817,
      "direccion_origen": "Calle 100 #15-20",
      "latitud_destino": 4.6531,
      "longitud_destino": -74.0836,
      "direccion_destino": "Calle 127 #7-45",
      "distancia_km": 5.2,
      "precio_estimado": 12500,
      "fecha_solicitud": "2026-03-05 14:30:00",
      "confianza": {
        "score": 45.5,
        "score_total": 145.5,
        "viajes_previos": 5,
        "es_favorito": true
      }
    }
  ]
}

Auto-Rejection

If you don’t respond within 30 seconds:

1. Timer Expires

   30-second countdown reaches zero

2. Auto-Reject

   System automatically rejects the request

   Timeout Handler

   Timer? _requestTimer;
   
   void _startRequestTimer() {
     _requestTimer = Timer(Duration(seconds: 30), () {
       if (_selectedRequest != null && !_requestProcessed) {
         _rejectRequest();
       }
     });
   }
   
   @override
   void dispose() {
     _requestTimer?.cancel();
     super.dispose();
   }
   
3. Sound Stops

   Notification sound automatically stops

4. Continue Searching

   You return to searching mode for new requests

Best Practices

Maximize Your Earnings:

1. Respond Quickly - Faster responses increase your acceptance rate
2. Check Distance - Consider pickup distance vs. trip fare
3. Know Your Area - Accept trips in areas you know well
4. Build Trust - High ratings lead to more favorite requests
5. Stay Online - More availability means more opportunities

Avoid These Mistakes:

• Don’t accept requests you can’t fulfill
• Don’t reject too many consecutive requests
• Don’t keep passengers waiting after accepting
• Don’t ignore low-rated requests if you need income

Next Steps

After accepting a ride:

Trip Execution

Learn the complete trip workflow from pickup to completion

Navigation

Use maps and navigation to reach your passenger

Earnings

Track your income from completed trips

Notifications

Manage notification settings and alerts