These docs are for v1.0. Click to read the latest docs for v2.0.

Using the Fleet simulator

How to use the Robot Fleets in Karhoo Sandbox environment

What is the Fleet Simulator

Karhoo has a Fleet Simulator that simulates Fleet behaviour and allows Developers to test and end-to-end trip.

Access to these simulated Fleets (also referred to as 'Robot' Fleets) are available to all Partners in the Sandbox environment.

Karhoo has setup Fleets to simulate all relevant scenarios. We actively encourage Developers to use these Fleets and test all available scenarios.

Scenarios

  • Full end-to-end journey with status transitions
  • Different Fleet types (Fixed vs. Metered) and Vehicle types (Saloon, Exec etc.)
  • Driver Tracking and Driver details
  • Simulate Fleet and User cancellations
  • Meeting points for configured POIs
  • Additional costs accumulated during the trip e.g. waiting time
  • Testing Karhoo notifications (when enabled)

Robot Fleets

Karhoo has setup different Robot Fleets:

For specific countries, two 'local' Fleets the represent the majority of Fleet types:

  1. Fixed Fare fleet (Private Hire Fleet)
  2. Metered Fare fleet

Additionally, there are two 'Global' Fleets available in every country to ensure there is coverage in most situations.

TypeFleet nameCountriesSpecifications
Local Meter FleetLocal Taxi (Robot Fleet UK) - Fleet names have some localisation,UK, FR, US1) Fares type: 'Metered'
2) Additional extras and expenses added to every trip:
Waiting time: 0.503
3) Localisation e.g. Driver names, phone numbers, and Currency
PHV FleetPHV Fleet (Robot Fleet UK) - Fleet names have some localisation,UK, FR, US1) Fares type: 'Fixed'
2) Additional extras and expenses added to every trip:
Waiting time: 0.50
Tolls: 0.50
3) Localisation e.g. Driver names, phone numbers, and Currency
Global PHV FleetGlobal PHV (Robot Fleet WWW)Global1) Fares type: 'Metered'
2) Quote = Final Fare
3) Localisation is set to UK
Global Taxi FleetGlobal Taxi (Robot Fleet WWW)Global1) Fares are type 'Fixed'
2) Quote = Final Fare
3) Localisation is set to UK

Example of quote request for UK displaying the local Fleets (yellow icons) and global Fleet also available (pink icons)

1228

Example of quote request for UK displaying the local Fleets (yellow icons) and global Fleet also available (pink icons)

For specific use-cases, Karhoo has setup Robot Fleets. To avoid accidental bookings, they may be setup in specific locations only:

Use CaseFleet NameDescriptionLocation
Fleet Cancellation'Will Always Decline (Robot Fleet)'This Fleet will decline shortly after accepting the bookingWorldwide (except New Zealand)
Missing Driver Details'No Driver Info Fleet (Robot Fleet GB)'This Fleet does not return driver information (no name, vehicle description, phone number)Oxford

Other notes:

*All metered Fleet have the same pricing and all PHV fleets have the same pricing structure. Across the range it should be (with some exceptions): Electric < Taxi < Saloon < Exec < MPV

Caveats

  • Robot fleets behave in a very consistent and deterministic way that obviously differ from the real world. e.g. most fleet are setup with no booking latency, Driver delays, all information available etc.
  • Not all metadata available (e.g. not every airport is configured)
  • Fleets 'fly' in a straight line to Pickup and Drop-off instead of following streets
  • GPS tracking is available reliably for every
  • real-life edge cases e.g. when a trip gets 'stuck' in a particular state or connection is lost
  • Fleets are always available and ETA are fast
  • Except for the fixed €/£/$ 0.50 Waiting time added to metered Fleets, Quote = Final price, whereas with real Taxi fleets, the price is an estimation and the taximeter determines the final price.

Please let us know if you would like to test a specific scenario

Known issues

  • Too close pickup and destination - Please don't select addresses that are next to one another, otherwise the trip will get stuck. Suggestion is at least 100m apart so that there is some driver tracking data available
  • The quoted price of Taxi fleets increases with the distance, PHV fleets are set to a fixed price.