Перейти до вмісту
Menu
Нове · API v2

Truck Route API: планувальник маршруту для вантажівок з АЗС і стоянками на маршруті

Один виклик повертає маршрут, дозволений для вашого транспортного засобу, план відпочинку водія за правилами ЄС щодо режиму праці та відпочинку, а також АЗС і стоянки для вантажівок по дорозі — з поточними цінами, відстанню від старту та об’їздом до кожної з них.

Розраховується тим самим рушієм маршрутизації, що й наш навігатор для вантажівок TruckTurn.

Планувальник маршруту для фур — для автопарків, диспетчерів і TMS

Диспетчерська перевізника

Плануйте маршрут фури, що підходить транспортному засобу, ще до виїзду водія, і бачте, де вантажівка може заправитися й відпочити дорогою.

Розробники TMS і ERP

Додайте API планувальника маршрутів для вантажівок у свою систему управління перевезеннями без створення, хостингу та підтримки власного рушія маршрутизації.

Телематика автопарку

Перетворюйте поточну позицію та стан тахографа водія на реалістичний ETA із зупинками й пропонуйте наступну заправку чи стоянку.

Вантажні біржі

Розраховуйте ставки на вантажі за дозволеною для вантажівки відстанню та часом у дорозі з урахуванням перерв, а не за маршрутом легковика.

Що ви отримуєте за один виклик

API маршрутизації для вантажівок

Відстань, тривалість і геометрія маршруту з урахуванням висоти, маси, довжини, ширини й навантаження на вісь вашого ТЗ, а також заявленого класу небезпечного вантажу.

Заборони руху вантажівок і перевірка допустимості

Відомі нам заборони руху вантажівок та обмеження для транспортних засобів враховуються під час розрахунку маршруту.

План відпочинку за правилами ЄС щодо часу керування

Перерви, щоденний і щотижневий відпочинок за EU Regulation 561/2006, кожен — на стоянці для вантажівок на маршруті, із зазначенням часу.

АЗС на маршруті

Станції поблизу маршруту з поточними цінами, де вони в нас є, кілометром, на якому вони трапляються, і об’їздом.

Стоянки для вантажівок на маршруті

Стоянки для вантажівок і зони відпочинку з кілометром від старту та об’їздом від маршруту.

Пункти зважування на маршруті

Ваги для вантажівок і пункти зважування на маршруті з кілометром, на якому трапляється кожен із них.

Вартість платних доріг за країнами

Оцінка плати за проїзд вантажівки маршрутом у євро — за країнами, а також для платних тунелів і мостів — з урахуванням кількості осей і маси. Країни, для яких ми ще не можемо розрахувати вартість, зазначаються у відповіді й ніколи не вважаються безкоштовними.

Небезпечні вантажі та параметри об’їзду

Вкажіть класи ADR і код обмеження проїзду через тунелі (B, C, D або E) для вашого вантажу — тунелі, категорія яких це забороняє, оминаються там, де категорію нанесено на карту. Також можна уникати платних доріг, поромів, автомагістралей, пунктів пропуску через кордон, тунелів, ґрунтових доріг і зон низьких викидів.

Еко-маршрутизація

Запитуйте маршрут, що віддає перевагу меншій витраті пального, а не найкоротшому часу в дорозі.

Оминає Росію та Калінінград

Маршрути ніколи не проходять через Росію чи Калінінград.

План відпочинку водія за правилами ЄС щодо режиму праці та відпочинку (Регламент 561/2006)

Планувальник перерв для вантажівок, вбудований у маршрут. API планує час керування, перерви й відпочинок так, як їх описує EU Regulation 561/2006, і розміщує кожну зупинку на реальній стоянці для вантажівок уздовж маршруту — тож отриманий ETA є ETA вантажівки із зупинками, а не часом руху без зупинок.

Інструмент планування, а не запис тахографа й не юридична консультація. Відповідальність за дотримання правил щодо часу керування та відпочинку і далі несуть водій та перевізник.

Прогноз трафіку вздовж маршруту

За замовчуванням час маршруту розраховується з прогнозом трафіку на момент, коли вантажівка фактично проїжджатиме кожну ділянку, а не на момент надсилання запиту. Часова шкала прогнозу визначає ETA, план відпочинку за EU 561, час заборон руху та час прибуття на прикордонні пункти.

Планова оцінка, а не гарантія. Збір даних розпочався у вересні 2026 року, тому вивчені шаблони ще молоді й покращуються в міру накопичення тижнів. Погода охоплена не скрізь. Коли альтернатива виглядає швидшою, її рекомендовано у відповіді; основний маршрут ніколи не підміняється замість вас.

Параметр: traffic

ЗначенняЩо робить
traffic=forecastЗа замовчуванням. Вивчені повторювані затори плюс трафік наживо, дорожні роботи, закриття та погода на момент проїзду.
traffic=liveЛише поточний трафік, без вивченого шаблону за днем тижня та годиною.
traffic=offБез шару трафіку: час маршруту розраховується за часом руху у вільному потоці.

Блок відповіді: traffic_forecast

Відповідь додає блок traffic_forecast: тривалість у вільному потоці та прогнозовану тривалість, затримку з розбивкою за причиною (recurring, live, roadworks, weather), hotspots на маршруті з їхнім ETA, причиною, дорогою, довірою та днем тижня й годиною, точки погоди на маршруті, уникнуті закриття, рекомендовану альтернативу, коли прогнозується, що вона швидша, та показники coverage. Кожен альтернативний маршрут містить forecast_duration_s, а кожна заборона руху містить eta_at_ban на часовій шкалі прогнозу поруч з 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"
Показати фрагмент реальної відповіді
{
  "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", "…": "…" }
    ],
    "…": "…"
  }
}

Реальна відповідь, скорочена до двох hotspot, однієї точки погоди, однієї альтернативи та однієї заборони; довгі тексти скорочено. Документація містить повний список полів.

Подивіться реальний розрахунок

Збережені відповіді для популярних маршрутів вантажівок, розраховані API: карта, зупинки й ETA нижче — це те, що повернув API, а не живий виклик із цієї сторінки.

  • АЗС
  • Стоянка для вантажівок
  • Пункт зважування
  • Перерва
  • Щоденний відпочинок
  • Щотижневий відпочинок
  • Очікування на кордоні
Відстань930 km
Час керування10 год 22 хв
Загальний час із відпочинком22 год 7 хв
  1. ВідправленняДень 1, 06:00
  2. Рух · 394 km · 4 год 24 хв
  3. Перерва · 45 хв День 1, 10:24 · о Raststätte Börde-Nord 1, Hohe Börde
  4. Рух · 401 km · 4 год 27 хв
  5. Щоденний відпочинок · 11 год 0 хв День 1, 15:37 · о Punkt 9749
  6. Рух · 135 km · 1 год 29 хв
  7. Прибуття (ETA)День 2, 04:06

Запит

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
Фрагмент відповіді
{
    "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"
  …

Розраховано 2026-10-09 04:30 UTC

Приклад запиту й відповіді

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 }
  ]
}

Скорочено й для ілюстрації — назви полів ще можуть змінитися до релізу. Повний перелік параметрів і схема відповіді — у документації.

Покриття

Маршрутизація охоплює Європу й ніколи не проходить через Росію чи Калінінград. Наявність цін на пальне та щільність стоянок різняться за країнами — списки нижче беруться безпосередньо з наших актуальних даних.

Країни з цінами на АЗС

Поточні ціни на АЗС доступні лише в цих країнах. В інших країнах маршрут, план відпочинку й стоянки працюють, але ціни на пальне не повертаються.

  • Італія · 58,659 АЗС
  • Німеччина · 43,672 АЗС
  • Іспанія · 39,429 АЗС
  • Франція · 31,496 АЗС
  • Греція · 14,154 АЗС
  • Португалія · 9,807 АЗС
  • Норвегія · 4,001 АЗС
  • Хорватія · 2,540 АЗС
  • Австрія · 1,996 АЗС
  • Словенія · 1,736 АЗС
  • Польща · 151 АЗС · обмежене покриття

Стоянки для вантажівок за країнами

Стоянки для вантажівок, які є в нашій базі, за країнами. В одних країнах покриття щільніше, ніж в інших.

  • Польща · 6,286 стоянок
  • Німеччина · 3,518 стоянок
  • Франція · 1,184 стоянок
  • Чехія · 963 стоянок
  • Румунія · 924 стоянок
  • Бельгія · 815 стоянок
  • Іспанія · 731 стоянок
  • Австрія · 677 стоянок
  • Нідерланди · 633 стоянок
  • Угорщина · 572 стоянок
  • Італія · 535 стоянок
  • Словаччина · 472 стоянок
  • Хорватія · 429 стоянок
  • Литва · 360 стоянок
  • Болгарія · 340 стоянок
  • Велика Британія · 241 стоянок
  • Латвія · 235 стоянок
  • Сербія · 215 стоянок
  • Україна · 200 стоянок
  • Естонія · 199 стоянок
  • Північна Македонія · 135 стоянок
  • Греція · 116 стоянок
  • Словенія · 116 стоянок
  • Португалія · 104 стоянок
  • Швеція · 84 стоянок
  • Данія · 83 стоянок
  • Швейцарія · 79 стоянок
  • Норвегія · 67 стоянок
  • Люксембург · 64 стоянок
  • Чорногорія · 55 стоянок
  • Албанія · 51 стоянок

А також менша кількість ще в 2 країнах.

Кількість зчитується з нашої бази даних і оновлюється кожні кілька годин.

Тарифи

Pro

€99 / місяць
  • 2,000 запитів маршруту на день
  • Входить у тариф разом з іншими викликами API даних.
Обрати тариф

Pro MAX

€299 / місяць
  • 10,000 запитів маршруту на день
  • Входить у тариф разом з іншими викликами API даних.
Обрати тариф

Додаткові запити маршруту

€9 / місяць за блок
  • +100 запитів маршруту на день
  • Докупуйте блоки до платного тарифу, коли вашому автопарку потрібно більше.

Ціни вказано без ПДВ.

Часті запитання

Що таке Truck Route API?

Це API маршрутизації для вантажівок: ви надсилаєте старт, пункт призначення та параметри ТЗ і отримуєте дозволений для вантажівки маршрут, план відпочинку водія за правилами ЄС щодо режиму праці та відпочинку, а також АЗС і стоянки для вантажівок по дорозі — в одній відповіді JSON.

Чим він відрізняється від API маршрутів для легкових авто?

Маршрут для легковика може спрямувати 4-метровий 40-тонний транспортний засіб під низький міст або на дорогу з обмеженням маси. Цей маршрут розраховується під габарити, масу, навантаження на вісь і клас небезпечного вантажу вашого ТЗ та враховує заборони руху вантажівок.

Чи планує він перерви та відпочинок водія?

Так. Він планує перерви, щоденний і щотижневий відпочинок за EU Regulation 561/2006 — зокрема розділені перерви, скорочений відпочинок і роботу екіпажем із двох водіїв, — розміщує кожну зупинку на стоянці для вантажівок на маршруті й враховує їх в ETA. Передайте поточний час керування водія, і план почнеться з його нинішнього стану.

Чи є план відпочинку юридичною гарантією?

Ні. Це інструмент планування, що застосовує правила так, як ми їх реалізували. Це не запис тахографа й не юридична консультація, і він не гарантує дотримання вимог. Відповідальність і далі несуть водій та перевізник, а реальний трафік, очікування та час завантаження змінять план.

У яких країнах доступні ціни на пальне?

Лише в країнах, перелічених у розділі «Покриття» на цій сторінці. Цей список формується з наших актуальних даних, тож показує, що API може повернути сьогодні.

Чи може маршрут пройти через Росію?

Ні. Маршрути оминають Росію та Калінінград.

Скільки запитів маршруту безкоштовні?

Кожен акаунт отримує 10 безкоштовних запитів маршруту на день. Платні тарифи містять більше, а додаткові запити можна докупити блоками по 100 на день.

Чи можна використовувати його в моїй TMS або диспетчерській програмі?

Так. Це звичайний HTTPS GET, що повертає JSON, тож його може використовувати будь-яка TMS, ERP, диспетчерська чи телематична система, здатна викликати REST API. У документації описано кожен параметр і схему відповіді.

Чи повертає API вартість платних доріг?

Так, як оцінку в євро: за країнами — на основі платних кілометрів маршруту й тарифу для вантажівки з вашою кількістю осей і масою, плюс платні тунелі й мости на маршруті. Тарифи — для Euro VI. Країна без тарифу в нашій базі зазначається в примітці про покриття й не входить у загальну суму, замість того щоб рахуватися як нуль.

Чи може він планувати маршрути для небезпечних вантажів (ADR)?

Ви можете передати класи ADR вантажу та його код обмеження проїзду через тунелі. Тунелі, категорія яких забороняє цей код, оминаються там, де категорію нанесено на карту; якщо іншого маршруту немає, відповідь про це повідомить. Відповідальність за перевірку правил ADR, що застосовуються до вашого вантажу, лишається за вами.

Сплануйте свій перший маршрут для вантажівки

Створіть безкоштовний акаунт і отримайте ключ — 10 запитів маршруту на день безкоштовні на кожному акаунті.