API planera trasy Online
Plan podróży od drzwi do drzwi: trasa, przejścia graniczne na niej z bieżącą kolejką lub prognozą na godzinę przyjazdu oraz postoje na odpoczynek, posiłek i tankowanie, które kierowca naprawdę robi — na jednej osi czasu. Długa kolejka liczy się jako należna już przerwa, więc czas oczekiwania nigdy nie jest liczony dwukrotnie; autobusy i ciężarówki mają obowiązkowy odpoczynek wg UE 561/2006, a postoje serwisowe autobusów skalibrowano na ponad 1000 licencjonowanych rozkładów. Każde przejście graniczne zwraca też wait_basis: vehicle_lane, gdy dla Twojej kategorii pojazdu mierzona jest osobna kolejka, oraz car_lane, gdy najlepszym dostępnym sygnałem jest kolejka pasa dla aut osobowych.
GET https://nakordoni.eu/api/v2/data/route-plan
— klasa limitu: heavy
| Parametr | Opis |
|---|---|
origin_lat | Szerokość geograficzna punktu początkowego (wymagane) |
origin_lon | Długość geograficzna punktu początkowego (wymagane) |
dest_lat | Szerokość geograficzna celu (wymagane) |
dest_lon | Długość geograficzna celu (wymagane) |
vehicle | car (domyślnie), bus lub truck — wybiera zarówno profil trasowania, jak i model postojów |
depart | Czas wyjazdu w formacie ISO-8601, maksymalnie 14 dni do przodu (domyślnie: teraz). Na jego podstawie liczona jest prognoza kolejki na moment przyjazdu |
via | Opcjonalne punkty pośrednie w formacie lat,lon;lat,lon (maks. 3) — np. aby poprowadzić trasę przez inne przejście graniczne |
forecast | 1 (domyślnie) = prognozuj kolejkę na godzinę Twojego przyjazdu do każdego przejścia; 0 = użyj bieżącej kolejki |
stop_places | 1 = podaj dla każdego postoju konkretne miejsce odpoczynku / stację paliw (domyślnie 0) |
overnight | 1 = dodaj zalecany postój na nocleg, gdy jazda przekracza 11 godz. (domyślnie 0) |
geometry | 1 = dołącz pełną geometrię trasy (domyślnie 0) |
alternatives | 1 (domyślnie) = dołącz pobliskie alternatywne przejścia graniczne wraz z ich kolejkami |
preference | recommended (domyślnie), fastest lub shortest |
lang | Kod języka nazw przejść granicznych (domyślnie en) |
Pola odpowiedzi — wewnątrz obiektu data w kopercie odpowiedzi. [] oznacza listę, więc data.items[].name to pole name każdego elementu. Pole bywa null, nieobecne lub jest pustą listą, gdy nie mamy wartości — nigdy nie wstawiamy atrapy.
| Pole | Opis |
|---|---|
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"
Zaktualizowano