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.
| Polje | Tip | Obavezno | Opis |
|---|---|---|---|
serviceTypeId | uuid | ✓ | Vrsta usluge za koju se računa cijena |
fromZoneId / toZoneId | uuid | — | Za fiksne međuzonske cijene (npr. aerodrom) |
pickupLatitude / pickupLongitude | number | — | Koordinate preuzimanja |
dropoffLatitude / dropoffLongitude | number | — | Koordinate odredišta |
distanceKm / durationMinutes | number | — | Ako ruta nije poznata, pošaljite ih sami |
averageSpeedKmh | number | — | Prosječna brzina za procjenu vremena |
at | ISO 8601 | — | Trenutak za koji se primjenjuje cjenik (noćna tarifa, praznik) |
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"
}'
{
"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
| Trenutak | Ono što dobivate |
|---|---|
| Prije narudžbe | maximumPrice — najviša cijena i raščlamba |
| Po narudžbi | estimatedPrice u detalju vožnje (ista vrijednost) |
| Nakon završetka | finalPrice — stvarna cijena prema prijeđenoj ruti i čekanju, nikad viša od najviše |

