API plánovača trasy Online
Plán cesty od dverí k dverám cez hranicu: trasa, hraničné priechody na nej so živým radom alebo predpoveďou na čas vášho príchodu a zastávky na odpočinok, jedlo a tankovanie, ktoré vodič naozaj robí — na jednej časovej osi. Dlhý rad sa počíta ako už splatná prestávka, takže čakanie sa nikdy nezapočíta dvakrát; autobusy a kamióny majú povinný odpočinok podľa EÚ 561/2006 a servisné zastávky autobusov sú kalibrované na viac než 1000 licencovaných cestovných poriadkoch. Každý hraničný priechod navyše vracia wait_basis: vehicle_lane, keď má vaša kategória vozidla vlastný meraný rad, car_lane, keď je najlepším dostupným signálom rad v pruhu pre osobné autá.
GET https://nakordoni.eu/api/v2/data/route-plan
— trieda kvóty: heavy
| Parameter | Popis |
|---|---|
origin_lat | Zemepisná šírka východiskového bodu (povinné) |
origin_lon | Zemepisná dĺžka východiskového bodu (povinné) |
dest_lat | Zemepisná šírka cieľa (povinné) |
dest_lon | Zemepisná dĺžka cieľa (povinné) |
vehicle | car (predvolené), bus alebo truck — určuje profil trasovania aj model zastávok |
depart | Čas odchodu vo formáte ISO-8601, najviac 14 dní dopredu (predvolene: teraz). Na jeho základe sa počíta prognóza radu na čas príchodu |
via | Voliteľné medzibody vo formáte lat,lon;lat,lon (najviac 3) — napríklad na vedenie trasy cez iný hraničný priechod |
forecast | 1 (predvolené) = predpovedať rad na čas vášho príchodu na každý priechod; 0 = použiť aktuálny rad |
stop_places | 1 = pre každú zastávku uviesť konkrétne odpočívadlo / čerpaciu stanicu (predvolene 0) |
overnight | 1 = pridať odporúčanú nocľažnú zastávku, ak jazda presiahne 11 h (predvolene 0) |
geometry | 1 = zahrnúť úplnú geometriu trasy (predvolene 0) |
alternatives | 1 (predvolené) = zahrnúť blízke alternatívne priechody aj s ich radmi |
preference | recommended (predvolené), fastest alebo shortest |
lang | Kód jazyka pre názvy priechodov (predvolene en) |
Polia odpovede — vnútri objektu data v obálke odpovede. [] označuje zoznam, takže data.items[].name je pole name každého prvku. Pole býva null, chýba alebo je prázdny zoznam, keď preň nemáme hodnotu — zástupný údaj nedopĺňame.
| Pole | Popis |
|---|---|
data.route | The drive itself: distance_km, drive_seconds, vehicle, toll_distance_km. |
data.borders[].ppid | A crossing on the route, with name, from, to and crossing_type. |
data.borders[].wait | Its live or arrival-time-forecast wait, with wait_basis — vehicle_lane when your vehicle class has its own measured queue, car_lane when the car queue is the best available signal. |
data.borders[].at_km | Where it falls on the route, with at_drive_seconds and distance_from_route_km. |
data.borders[].alternatives[] | Other crossings worth switching to: ppid, name, wait_minutes, queue_cars, detour_km. |
data.stops[].type | Break, meal or refuelling, with reason, at_km, at_drive_s, minutes, starts_at and ends_at. |
data.summary | The timeline totals: drive_seconds, stop_seconds, border_wait_seconds, total_seconds, arrival_at, stop_count, border_count and borders_absorbed_breaks — long waits that satisfied a due break instead of adding to it. |
data.model | Rules the plan was built on: vehicle, basis (driving-hygiene or EU 561/2006), break_after_drive_min, meal_after_drive_min, fuel_every_km. |
data.warnings[] | Things to tell the driver: code, ppid, name, status, message, suggested_alternative — e.g. a closed crossing on the route. |
curl "https://nakordoni.eu/api/v2/data/route-plan?origin_lat=50.4501&origin_lon=30.5234&dest_lat=52.2297&dest_lon=21.0122&vehicle=car&stop_places=1&lang=en" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Aktualizované