Skip to main content

1.3 On-demand Trips Bookings

Overview​

The On-Demand Trip Booking feature allows customers to book a ride for immediate travel instantly. This system is designed to offer a seamless and real-time experience by connecting customers with the nearest available drivers in just a few taps.

🔹 How It Works​

  1. Customer Initiates Instant Booking

    • The customer selects their pickup and drop-off locations
    • They choose the “Book Now” or on-demand option from the app

  2. Driver Search Begins

    • The system starts searching for nearby drivers within a predefined pickup radius
    • The admin from the backend settings can configure this radius and allocation behavior

  3. Trip Request Sent to Drivers

    • The system sends the trip request to eligible drivers one by one or in parallel (as configured)
    • Each driver receives the request with a countdown timer to accept or reject the trip

  4. Driver Response Handling

    • If a driver accepts the trip, the system immediately confirms the booking to the customer and shares the driver's details
    • If a driver rejects or does not respond within the timeout period, the system forwards the request to the next eligible driver

  5. No Driver Available Scenario

    • If no drivers accept the request, the system marks the booking as “No Driver Found”
    • The customer is notified that no driver is available at the moment

🔹 Benefits​

  • Enables real-time booking without waiting
  • Automatically searches and allocates the nearest drivers
  • Fully configurable allocation behavior (timeout, radius, retry logic)
  • Reduces dependency on manual dispatching by the admin

🔧 Admin Configuration Options​

  • Search Radius: Set the distance within which to search for drivers
  • Timeout Duration: Define how long a driver has to respond to a trip request
  • Allocation Mode: Choose between one-to-one or batch-wise dispatching

🔔 Customer Notifications​

  • Trip Accepted: Notified instantly with driver details
  • Trip Rejected/No Driver: Informed via in-app alert if no drivers are available

This feature ensures that customers experience minimal delays when requesting a ride, while also providing transparency and control to the admin team.