Driveoskatalog platforme

Procjena cijene

Koliko će vožnja stajati prije nego je netko naruči — iz istog cjenika koji vidi i putnik u aplikaciji.

Nitko ne voli iznenađenje na kraju vožnje. Zato cijena nastaje prije narudžbe, po cjeniku tvrtke, i putnik je vidi u aplikaciji. Isti izračun dostupan je i drugim programima, da i oni pokažu isti iznos.

POST/api/v1/quote

Procjena cijene. Opseg pricing. Ako pošaljete koordinate, udaljenost i trajanje računa se rutom; ako pošaljete distanceKm i durationMinutes, koriste se oni.

PoljeTipObaveznoOpis
serviceTypeIduuid✓Vrsta usluge za koju se računa cijena
fromZoneId / toZoneIduuid—Za fiksne međuzonske cijene (npr. aerodrom)
pickupLatitude / pickupLongitudenumber—Koordinate preuzimanja
dropoffLatitude / dropoffLongitudenumber—Koordinate odredišta
distanceKm / durationMinutesnumber—Ako ruta nije poznata, pošaljite ih sami
averageSpeedKmhnumber—Prosječna brzina za procjenu vremena
atISO 8601—Trenutak za koji se primjenjuje cjenik (noćna tarifa, praznik)
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
  }
}
Što ulazi u cijenuStart, kilometri i vrijeme iz cjenika vrste usluge; množitelj cjenika (npr. noćni rad); fiksna međuzonska cijena kad postoje obje zone; pravila čekanja i minimalne cijene. Sve je to postavka tvrtke, ne integracije.

Procjena i konačna cijena

TrenutakOno što dobivate
Prije narudžbemaximumPrice — najviša cijena i raščlamba
Po narudžbiestimatedPrice u detalju vožnje (ista vrijednost)
Nakon završetkafinalPrice — stvarna cijena prema prijeđenoj ruti i čekanju, nikad viša od najviše
Svjetla temaTamna tema
Cjenik iz kojeg procjena nastaje: tarifa, množitelj i pravila po vrsti usluge.