Driveosplatform catalogue

Price estimate

What a ride will cost before anyone books it — from the same price list the passenger sees in the app.

Nobody likes a surprise at the end of a ride. That is why the price is produced before the booking, from the company’s price list, and the passenger sees it in the app. The same calculation is available to other systems, so they show the same amount.

POST/api/v1/quote

Price estimate. Scope pricing. If you send coordinates, distance and duration come from routing; if you send distanceKm and durationMinutes, those are used.

FieldTypeRequiredDescription
serviceTypeIduuid✓The service type the price is computed for
fromZoneId / toZoneIduuid—For fixed inter-zone prices (e.g. airport)
pickupLatitude / pickupLongitudenumber—Pickup coordinates
dropoffLatitude / dropoffLongitudenumber—Destination coordinates
distanceKm / durationMinutesnumber—If the route is unknown, send them yourself
averageSpeedKmhnumber—Average speed used to estimate time
atISO 8601—The moment the price list applies to (night rate, holiday)
bashprocjena za vožnju Ilica → Zračna luka
curl -s -X POST https://driveos.eu/api/v1/quote \
  -H "X-API-Key: $DEMO_TAXI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "serviceTypeId": "8f1c2a6e-6d4b-4f2a-9d31-2a7c1b6e5f01",
    "pickupLatitude": 45.8127, "pickupLongitude": 15.9700,
    "dropoffLatitude": 45.7429, "dropoffLongitude": 16.0688,
    "at": "2026-11-18T04:30:00Z"
  }'
json200 — cijena s raščlambom
{
  "quote": {
    "serviceTypeId": "8f1c2a6e-6d4b-4f2a-9d31-2a7c1b6e5f01",
    "currencyCode": "EUR",
    "maximumPrice": 24.80,
    "distanceKm": 17.4,
    "durationMinutes": 28,
    "breakdown": [
      { "code": "BASE", "label": "Start", "amount": 2.30 },
      { "code": "DISTANCE", "label": "Kilometri (17,4 km)", "amount": 19.14 },
      { "code": "TIME", "label": "Vrijeme (28 min)", "amount": 3.36 }
    ],
    "zonePrice": null,
    "multiplier": 1.0
  }
}
What goes into the priceBase, distance and time from the service type’s price list; the price-list multiplier (e.g. night work); a fixed inter-zone price when both zones are known; waiting rules and minimum fares. All of that is a company setting, not an integration setting.

Estimate and final price

MomentWhat you get
Before bookingmaximumPrice — the maximum price and its breakdown
On bookingestimatedPrice in the ride detail (the same value)
After completionfinalPrice — the real price by the travelled route and waiting, never above the maximum
Light themeDark theme
The price list the estimate comes from: tariff, multiplier and rules per service type.