> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/Braian551/viax/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

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

## Sound Notification System

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

### How It Works

<Steps>
  <Step title="New Request Detected">
    System finds a matching trip request near your location
  </Step>

  <Step title="Sound Alert Plays">
    `request_notification.mp3` plays at maximum volume to get your attention
  </Step>

  <Step title="Visual Panel Appears">
    Trip details slide up from the bottom of the screen
  </Step>

  <Step title="30-Second Timer">
    You have 30 seconds to accept or reject the request
  </Step>
</Steps>

### Sound Service Implementation

```dart Sound Notification Service theme={null}
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');
    }
  }
}
```

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

## Trip Request Information

Each request displays comprehensive information to help you decide:

### Request Data Model

```dart Trip Request View Model theme={null}
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:

<CardGroup cols={2}>
  <Card title="Passenger Info" icon="user">
    * Name and photo
    * Rating (if available)
    * Favorite badge (if you're their favorite)
  </Card>

  <Card title="Trip Details" icon="route">
    * Pickup address
    * Destination address
    * Distance and duration
  </Card>

  <Card title="Earnings" icon="dollar-sign">
    * Estimated fare
    * Your potential earnings
    * Commission breakdown
  </Card>

  <Card title="Route Preview" icon="map">
    * Map with route highlighted
    * Distance to pickup
    * Traffic conditions
  </Card>
</CardGroup>

## Accepting a Request

### Accept Flow

<Steps>
  <Step title="Review Details">
    Examine the trip information displayed on the request panel

    ```dart Request Panel theme={null}
    RequestActionPanel(
      request: selectedRequest,
      routeToClient: routeToClient,
      currentLocation: currentLocation,
      onAccept: _acceptRequest,
      onReject: _rejectRequest,
      onTimeout: _rejectRequest,
      isDark: isDark,
    )
    ```
  </Step>

  <Step title="Tap Accept Button">
    Click the green "Accept" button to accept the trip

    ```dart Accept Request theme={null}
    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')),
        );
      }
    }
    ```
  </Step>

  <Step title="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
  </Step>
</Steps>

### Accept Request API

```dart Trip Request Search Service theme={null}
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

<Steps>
  <Step title="Tap Reject Button">
    Click the red "Reject" button or let the timer expire

    ```dart Reject Request theme={null}
    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);
    }
    ```
  </Step>

  <Step title="Request Released">
    Request becomes available for other drivers

    * Your rejection is logged
    * Request offered to next available driver
    * You continue searching for other requests
  </Step>
</Steps>

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

## Request Prioritization

### How Requests Are Assigned

Viax uses intelligent prioritization to match drivers with passengers:

<AccordionGroup>
  <Accordion title="Distance Priority" icon="location-dot">
    Closer drivers see requests first

    * Distance from your location to pickup point
    * Estimated time to reach passenger
    * Real-time traffic considerations
  </Accordion>

  <Accordion title="ConfianzaScore" icon="star">
    Trust relationship between you and passenger

    ```dart Confianza Scoring theme={null}
    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
    ```
  </Accordion>

  <Accordion title="Favorite Status" icon="heart">
    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
  </Accordion>

  <Accordion title="Availability" icon="toggle-on">
    Driver status and capacity

    * Must be online and available
    * No active trip in progress
    * Profile approved and complete
  </Accordion>
</AccordionGroup>

### Request List Response

From the backend API:

```json theme={null}
{
  "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:

<Steps>
  <Step title="Timer Expires">
    30-second countdown reaches zero
  </Step>

  <Step title="Auto-Reject">
    System automatically rejects the request

    ```dart Timeout Handler theme={null}
    Timer? _requestTimer;

    void _startRequestTimer() {
      _requestTimer = Timer(Duration(seconds: 30), () {
        if (_selectedRequest != null && !_requestProcessed) {
          _rejectRequest();
        }
      });
    }

    @override
    void dispose() {
      _requestTimer?.cancel();
      super.dispose();
    }
    ```
  </Step>

  <Step title="Sound Stops">
    Notification sound automatically stops
  </Step>

  <Step title="Continue Searching">
    You return to searching mode for new requests
  </Step>
</Steps>

## Best Practices

<Tip>
  **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
</Tip>

<Warning>
  **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
</Warning>

## Next Steps

After accepting a ride:

<CardGroup cols={2}>
  <Card title="Trip Execution" icon="route" href="/drivers/trip-execution">
    Learn the complete trip workflow from pickup to completion
  </Card>

  <Card title="Navigation" icon="map" href="/drivers/navigation-maps">
    Use maps and navigation to reach your passenger
  </Card>

  <Card title="Earnings" icon="money-bill" href="/drivers/earnings-tracking">
    Track your income from completed trips
  </Card>

  <Card title="Notifications" icon="bell" href="/drivers/notifications">
    Manage notification settings and alerts
  </Card>
</CardGroup>