Przejdź do treści
Menu
Nowość · API v2

Truck Route API: wyznaczanie trasy dla ciężarówek ze stacjami paliw i parkingami na trasie

Jedno wywołanie zwraca trasę dozwoloną dla danego pojazdu, plan odpoczynków kierowcy zgodny z unijnymi przepisami o czasie pracy kierowcy oraz stacje paliw i parkingi dla ciężarówek po drodze — z aktualnymi cenami, odległością od startu i długością objazdu do każdego z nich.

Obliczane tym samym silnikiem wyznaczania tras co nasza aplikacja nawigacyjna dla ciężarówek TruckTurn.

Odbierz bezpłatny klucz API Przeczytaj dokumentację Zobacz cennik

Planer tras dla ciężarówek dla flot, spedycji i systemów TMS

Dyspozytornia przewoźnika

Zaplanowanie trasy TIR-a dopasowanej do pojazdu, zanim kierowca wyruszy, oraz podgląd miejsc, w których ciężarówka może po drodze zatankować i odpocząć.

Dostawcy TMS i ERP

API planera tras dla ciężarówek w systemie do zarządzania transportem — bez budowania, hostowania i utrzymywania własnego silnika wyznaczania tras.

Telematyka flotowa

Przeliczanie bieżącej pozycji i stanu tachografu kierowcy na realistyczne ETA z postojami oraz podpowiadanie kolejnego tankowania lub parkingu.

Giełdy transportowe

Wycena ładunków na podstawie dystansu dozwolonego dla ciężarówki i czasu jazdy z pauzami, a nie trasy samochodu osobowego.

Co zwraca jedno wywołanie

API do wyznaczania tras dla ciężarówek

Dystans, czas przejazdu i geometria trasy z uwzględnieniem wysokości, masy, długości, szerokości i nacisku na oś pojazdu oraz zadeklarowanej klasy towarów niebezpiecznych.

Zakazy ruchu ciężarówek i kontrola dopuszczalności

Znane nam zakazy ruchu ciężarówek i ograniczenia dla pojazdów są uwzględniane przy wyznaczaniu trasy.

Plan odpoczynków wg unijnych przepisów o czasie pracy kierowcy

Pauzy, odpoczynki dobowe i tygodniowe wg EU Regulation 561/2006, każdy na parkingu dla ciężarówek na trasie, z godzinami.

Stacje paliw na trasie

Stacje w pobliżu trasy z aktualnymi cenami, tam gdzie je mamy, kilometrem, na którym się pojawiają, i długością objazdu.

Parkingi dla ciężarówek na trasie

Parkingi dla ciężarówek i MOP-y z kilometrem od startu i długością objazdu od trasy.

Stacje ważenia na trasie

Wagi dla ciężarówek i stacje ważenia na trasie, z kilometrem, na którym pojawia się każda z nich.

Koszty opłat drogowych wg krajów

Szacunkowe opłaty drogowe dla ciężarówek na trasie w euro, dla każdego kraju oraz dla płatnych tuneli i mostów, na podstawie liczby osi i masy pojazdu. Kraje, których nie potrafimy jeszcze wycenić, są wymienione w odpowiedzi i nigdy nie są liczone jako bezpłatne.

Towary niebezpieczne i opcje omijania

Po zadeklarowaniu klas ADR i kodu ograniczeń przejazdu przez tunele (B, C, D lub E) dla ładunku tunele, których kategoria na to nie pozwala, są omijane — tam, gdzie kategoria jest zmapowana. Można też omijać opłaty drogowe, promy, autostrady, przejścia graniczne, tunele, drogi nieutwardzone i strefy czystego transportu.

Trasy ekologiczne

Możliwość zamówienia trasy, która przedkłada mniejsze zużycie paliwa nad najkrótszy czas jazdy.

Omija Rosję i Kaliningrad

Trasy nigdy nie przebiegają przez Rosję ani Kaliningrad.

Plan odpoczynków kierowcy zgodny z unijnymi przepisami o czasie pracy kierowcy (rozporządzenie 561/2006)

Planowanie pauz kierowcy wbudowane w trasę. API planuje czas jazdy, pauzy i odpoczynki tak, jak opisuje je EU Regulation 561/2006, i umieszcza każdy postój na rzeczywistym parkingu dla ciężarówek na trasie — dzięki temu zwracane ETA to ETA ciężarówki z postojami, a nie czas jazdy bez przerw.

Narzędzie do planowania, a nie zapis tachografu ani porada prawna. Za przestrzeganie przepisów o czasie pracy kierowcy nadal odpowiadają kierowca i przewoźnik.

Prognoza ruchu wzdłuż trasy

Domyślnie czas trasy jest liczony z prognozą ruchu na moment, w którym ciężarówka faktycznie przejedzie każdy odcinek, a nie na moment wysłania zapytania. Oś czasu prognozy wyznacza ETA, plan odpoczynków wg EU 561, czas obowiązywania zakazów ruchu oraz godzinę dotarcia do przejść granicznych.

To szacunek planistyczny, a nie gwarancja. Zbieranie danych rozpoczęło się we wrześniu 2026, więc wyuczone wzorce są jeszcze młode i poprawiają się wraz z upływem kolejnych tygodni. Pogoda nie jest uwzględniana wszędzie. Gdy alternatywa wygląda na szybszą, jest rekomendowana w odpowiedzi; trasa podstawowa nigdy nie jest podmieniana za Ciebie.

Parametr: traffic

WartośćCo robi
traffic=forecastDomyślnie. Wyuczone powtarzalne zatory oraz ruch na żywo, roboty drogowe, zamknięcia i pogoda w czasie przejazdu.
traffic=liveTylko bieżący ruch, bez wyuczonego wzorca dla dnia tygodnia i godziny.
traffic=offBez warstwy ruchu: czas trasy jest liczony jako czas przejazdu przy swobodnym ruchu.

Blok odpowiedzi: traffic_forecast

Odpowiedź zawiera dodatkowy blok traffic_forecast: czasy przejazdu przy swobodnym ruchu i według prognozy, opóźnienie z podziałem na przyczyny (recurring, live, roadworks, weather), hotspoty na trasie wraz z ich ETA, przyczyną, drogą, pewnością oraz dniem tygodnia i godziną, punkty pogodowe na trasie, uniknięte zamknięcia, rekomendowaną alternatywę, gdy prognozowana jest jako szybsza, oraz wskaźniki coverage. Każda trasa alternatywna ma forecast_duration_s, a każdy zakaz ruchu ma eta_at_ban na osi czasu prognozy obok eta_at_ban_free.

curl "https://nakordoni.eu/api/v2/data/truck-route?from=52.4064,16.9252&to=45.4642,9.1900&weight=40&height=4&alternatives=1&depart_at=2026-10-09T13:00:00%2B02:00&traffic=forecast" \
  -H "Authorization: Bearer $NKD_API_KEY"
Pokaż fragment prawdziwej odpowiedzi 
{
  "traffic_forecast": {
    "model": "nkd-traffic-forecast-2",
    "mode": "forecast",
    "duration_base": "free_flow",
    "duration_s_free": 51732,
    "duration_s_forecast": 52067,
    "delay_s": { "recurring": 335, "live": 0, "roadworks": 0, "weather": 0, "total": 335 },
    "hotspots": [
      { "km_from_start": 0.5, "km_to": 4, "eta": "2026-10-09T13:00:32+02:00", "delay_s": 67,
        "reason": "recurring", "label": "Recurring congestion (historical pattern)", "road": "433, 196",
        "confidence": "low", "dow_hour": "Fri 13-14h", "delay_by_reason": { "recurring": 67 },
        "country": "PL", "jam_frequency": 1, "observations": 4 },
      { "km_from_start": 232, "km_to": 256, "eta": "2026-10-09T15:36:12+02:00", "delay_s": 248,
        "reason": "recurring", "label": "Recurring congestion (historical pattern)", "road": "L30",
        "confidence": "low", "dow_hour": "Fri 15-16h", "delay_by_reason": { "recurring": 248 },
        "country": "DE", "jam_frequency": 0.35, "observations": 3 }
    ],
    "weather_on_route": [
      { "km_from_start": 145, "eta": "2026-10-09T14:38:03+02:00", "temp_c": 14.8, "precip_mm_h": 0,
        "precip_type": null, "wind_gust_kmh": 17, "visibility_km": 25.8, "speed_factor": 1, "effects": [] }
    ],
    "closures_avoided": [],
    "recommended_alternative": null,
    "coverage": {
      "profile_cells_hit": 44, "ensemble_cells_hit": 0, "ensemble_cells_in_horizon": 0, "route_cells": 823,
      "sampled_since": "2026-09-15", "max_observations_per_weekday_hour": 54, "live_traffic_age_min": 44,
      "weather_covered_km": 55, "route_km": 1291.8,
      "note": "Recurring congestion is learned from our own traffic observations since 2026-09-15 … Delays are the excess over free-flow truck speed. …"
    },
    "calc_ms": 1345
  },
  "alternatives": [
    { "distance_m": 1359314, "duration_s": 54373, "forecast_duration_s": 54707, "…": "…" }
  ],
  "route": {
    "truck_bans": [
      { "name": "Seasonal", "country": "AT", "eta_at_ban": "2026-10-10T11:28:47+02:00",
        "eta_at_ban_free": "2026-10-09T23:38:13+02:00", "…": "…" }
    ],
    "…": "…"
  }
}

Prawdziwa odpowiedź, skrócona do dwóch hotspotów, jednego punktu pogodowego, jednej alternatywy i jednego zakazu; długie teksty skrócono. Pełna lista pól znajduje się w dokumentacji.

Zobacz prawdziwe obliczenie

Zapisane odpowiedzi dla popularnych tras ciężarówek, obliczone przez API — mapa, postoje i ETA poniżej to dane zwrócone przez API, a nie wywołanie na żywo z tej strony.

  • Stacja paliw
  • Parking dla ciężarówek
  • Stacja ważenia
  • Pauza
  • Odpoczynek dobowy
  • Odpoczynek tygodniowy
  • Oczekiwanie na granicy
Dystans930 km
Czas jazdy10 h 22 min
Czas łączny z odpoczynkami22 h 7 min
  1. WyjazdDzień 1, 06:00
  2. Jazda · 394 km · 4 h 24 min
  3. Pauza · 45 min Dzień 1, 10:24 · o Raststätte Börde-Nord 1, Hohe Börde
  4. Jazda · 401 km · 4 h 27 min
  5. Odpoczynek dobowy · 11 h 0 min Dzień 1, 15:37 · o Punkt 9749
  6. Jazda · 135 km · 1 h 29 min
  7. Przyjazd (ETA)Dzień 2, 04:06

Zapytanie

GET https://nakordoni.eu/api/v2/data/truck-route?from=52.4064,16.9252&to=51.9244,4.4777&weight=40&height=4&crew=1&depart=2026-10-12T06:00:00%2B02:00
Fragment odpowiedzi 
{
    "slug": "poznan-rotterdam",
    "title": "Poznań → Rotterdam",
    "request_url": "https://nakordoni.eu/api/v2/data/truck-route?from=52.4064,16.9252&to=51.9244,4.4777&weight=40&height=4&crew=1&depart=2026-10-12T06:00:00%2B02:00",
    "departure": "2026-10-12T06:00:00+02:00",
    "geometry": "…",
    "totals": {
        "distance_km": 930,
        "driving_min": 622,
        "total_min": 1327,
        "border_wait_min": 0
    },
    "countries": [
        "PL",
        "DE",
        "…"
    ],
    "border_crossings": [],
    "tolls": {
        "currency": "EUR",
        "total_eur": 245.9,
        "complete": true,
        "by_country": [
            {
                "country": "DE",
                "km_toll": 556.4,
                "cost_eur": 193.63,
                "basis": "distance-based HGV toll: tolled km × per-km truck rate for this axle/weight class"
            },
            {
                "country": "NL",
                "km_toll": 204,
                "cost_eur": 31.82,
                "basis": "distance-based HGV toll: tolled km × per-km truck rate for this axle/weight class"
            },
            {
                "country": "PL",
                "km_toll": 159.3,
                "cost_eur": 20.45,
                "basis": "distance-based HGV toll: tolled km × per-km truck rate for this axle/weight class"
  …

Obliczono 2026-10-09 04:30 UTC

Przykładowe zapytanie i odpowiedź

curl "https://nakordoni.eu/api/v2/data/truck-route?from=52.4064,16.9252&to=45.4642,9.1900&weight=40&height=4&include=fuel,parking" \
  -H "Authorization: Bearer $NKD_API_KEY"
{
  "route": {
    "distance_km": 1186.4,
    "driving_time_min": 905,
    "eta": "2026-10-04T18:40:00+02:00",
    "vehicle": { "weight_t": 40, "height_m": 4.0 },
    "geometry": "…"
  },
  "rest_plan": [
    { "type": "break_45", "km_from_start": 352.1,
      "arrive": "2026-10-04T10:31:00+02:00", "depart": "2026-10-04T11:16:00+02:00",
      "parking": { "name": "…", "detour_km": 0.3 } },
    { "type": "daily_rest", "hours": 11, "km_from_start": 708.9, "parking": { "name": "…" } }
  ],
  "fuel": [
    { "name": "…", "km_from_start": 118.6, "detour_km": 0.8,
      "prices": { "diesel": 1.629 }, "currency": "EUR" }
  ],
  "parking": [
    { "name": "…", "km_from_start": 352.1, "detour_km": 0.3, "spaces": 60 }
  ]
}

Skrócone i poglądowe — nazwy pól mogą się jeszcze zmienić przed premierą. Pełna lista parametrów i schemat odpowiedzi są w dokumentacji.

Zasięg

Trasy obejmują Europę i nigdy nie przebiegają przez Rosję ani Kaliningrad. Ceny paliw i gęstość parkingów różnią się w zależności od kraju — poniższe listy pochodzą bezpośrednio z naszych bieżących danych.

Kraje z cenami na stacjach paliw

Aktualne ceny na stacjach są dostępne tylko w tych krajach. W pozostałych trasa, plan odpoczynków i parkingi nadal działają, ale ceny paliw nie są zwracane.

  • Włochy · 58,659 stacji
  • Niemcy · 43,672 stacji
  • Hiszpania · 39,429 stacji
  • Francja · 31,496 stacji
  • Grecja · 14,154 stacji
  • Portugalia · 9,807 stacji
  • Norwegia · 4,001 stacji
  • Chorwacja · 2,540 stacji
  • Austria · 1,996 stacji
  • Słowenia · 1,736 stacji
  • Polska · 151 stacji · ograniczony zasięg

Parkingi dla ciężarówek wg krajów

Parkingi dla ciężarówek w naszej bazie, wg krajów. W niektórych krajach pokrycie jest gęstsze niż w innych.

  • Polska · 6,286 parkingów
  • Niemcy · 3,518 parkingów
  • Francja · 1,184 parkingów
  • Czechy · 963 parkingów
  • Rumunia · 924 parkingów
  • Belgia · 815 parkingów
  • Hiszpania · 731 parkingów
  • Austria · 677 parkingów
  • Holandia · 633 parkingów
  • Węgry · 572 parkingów
  • Włochy · 535 parkingów
  • Słowacja · 472 parkingów
  • Chorwacja · 429 parkingów
  • Litwa · 360 parkingów
  • Bułgaria · 340 parkingów
  • Wielka Brytania · 241 parkingów
  • Łotwa · 235 parkingów
  • Serbia · 215 parkingów
  • Ukraina · 200 parkingów
  • Estonia · 199 parkingów
  • Macedonia Północna · 135 parkingów
  • Grecja · 116 parkingów
  • Słowenia · 116 parkingów
  • Portugalia · 104 parkingów
  • Szwecja · 84 parkingów
  • Dania · 83 parkingów
  • Szwajcaria · 79 parkingów
  • Norwegia · 67 parkingów
  • Luksemburg · 64 parkingów
  • Czarnogóra · 55 parkingów
  • Albania · 51 parkingów

Oraz mniejsze liczby w 2 kolejnych krajach.

Liczby są odczytywane z naszej bazy danych i odświeżane co kilka godzin.

Cennik

Każde konto

Za darmo
  • 10 zapytań o trasę dziennie
  • Bezpłatnie na każdym koncie, także Explorer. Karta nie jest wymagana.
Odbierz bezpłatny klucz API

Pro

€99 / miesiąc
  • 2,000 zapytań o trasę dziennie
  • W ramach planu, obok pozostałych wywołań API danych.
Wybierz plan

Pro MAX

€299 / miesiąc
  • 10,000 zapytań o trasę dziennie
  • W ramach planu, obok pozostałych wywołań API danych.
Wybierz plan

Dodatkowe zapytania o trasę

€9 / miesiąc za pakiet
  • +100 zapytań o trasę dziennie
  • Pakiety można dokupić do płatnego planu, gdy flota potrzebuje więcej.

Ceny netto, bez VAT.

Najczęściej zadawane pytania

Czym jest Truck Route API?

To API do wyznaczania tras dla ciężarówek: wysyła się punkt startowy, cel i parametry pojazdu, a w odpowiedzi otrzymuje trasę dozwoloną dla ciężarówki, plan odpoczynków kierowcy zgodny z unijnymi przepisami o czasie pracy kierowcy oraz stacje paliw i parkingi dla ciężarówek po drodze — w jednej odpowiedzi JSON.

Czym różni się od API do tras dla samochodów osobowych?

Trasa dla samochodu osobowego może poprowadzić 4-metrowy, 40-tonowy pojazd pod niski wiadukt lub na drogę z ograniczeniem masy. Ta trasa jest wyznaczana dla wymiarów, mas, nacisku na oś i klasy towarów niebezpiecznych danego pojazdu i uwzględnia zakazy ruchu ciężarówek.

Czy API planuje pauzy i odpoczynki kierowcy?

Tak. Planuje pauzy, odpoczynki dobowe i tygodniowe wg EU Regulation 561/2006 — w tym pauzy dzielone, odpoczynki skrócone i jazdę w załodze dwuosobowej — umieszcza każdy postój na parkingu dla ciężarówek na trasie i wlicza postoje do ETA. Po przekazaniu bieżących czasów jazdy kierowcy plan zaczyna się od jego aktualnego stanu.

Czy plan odpoczynków jest gwarancją prawną?

Nie. To narzędzie do planowania, które stosuje przepisy w naszej implementacji. Nie jest zapisem tachografu ani poradą prawną i nie gwarantuje zgodności z przepisami. Odpowiedzialność nadal ponoszą kierowca i przewoźnik, a rzeczywisty ruch, czas oczekiwania i załadunku zmienią plan.

W których krajach dostępne są ceny paliw?

Tylko w krajach wymienionych w sekcji „Zasięg” na tej stronie. Lista jest generowana z naszych bieżących danych, więc pokazuje, co API może zwrócić dzisiaj.

Czy trasa może przebiegać przez Rosję?

Nie. Trasy omijają Rosję i Kaliningrad.

Ile zapytań o trasę jest bezpłatnych?

Każde konto otrzymuje 10 bezpłatnych zapytań o trasę dziennie. Płatne plany obejmują więcej, a dodatkowe zapytania można dokupić w pakietach po 100 dziennie.

Czy można używać API w systemie TMS lub oprogramowaniu spedycyjnym?

Tak. To zwykłe zapytanie HTTPS GET zwracające JSON, więc może z niego korzystać każdy system TMS, ERP, spedycyjny lub telematyczny, który potrafi wywołać REST API. Dokumentacja opisuje wszystkie parametry i schemat odpowiedzi.

Czy API zwraca koszty opłat drogowych?

Tak, jako szacunek w euro: dla każdego kraju, na podstawie płatnych kilometrów na trasie i stawki dla ciężarówki o danej liczbie osi i masie, plus płatne tunele i mosty na trasie. Stawki to stawki Euro VI. Kraj bez zapisanej stawki jest wymieniony w nocie o zasięgu i pominięty w sumie, zamiast być liczony jako zero.

Czy API planuje trasy dla towarów niebezpiecznych (ADR)?

Można przesłać klasy ADR ładunku i jego kod ograniczeń przejazdu przez tunele. Tunele, których kategoria zabrania tego kodu, są omijane tam, gdzie kategoria jest zmapowana; jeśli nie ma innej trasy, odpowiedź o tym informuje. Za sprawdzenie przepisów ADR dotyczących danego ładunku nadal odpowiada użytkownik.

Zaplanuj pierwszą trasę dla ciężarówki

Załóż bezpłatne konto i odbierz klucz — 10 zapytań o trasę dziennie jest bezpłatnych na każdym koncie.

Odbierz bezpłatny klucz API Przeczytaj dokumentację