Skip to main content
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-ны, EU 561 демалыс жоспарын, жүргізуге тыйым салу уақытын және шекара өткелдеріне келу уақытын анықтайды.

Бұл жоспарлау бағасы, кепілдік емес. Деректер жинау 2026 жылдың қыркүйегінде басталды, сондықтан үйренілген заңдылықтар әлі жас және апталар жинақталған сайын жақсарады. Ауа райы барлық жерде қамтылмаған. Балама жылдамырақ болып көрінсе, ол жауапта ұсынылады; негізгі маршрут сіздің орныңызға ешқашан ауыстырылмайды.

Параметр: traffic

МәніНе істейді
traffic=forecastӘдепкі. Үйренілген қайталанатын кептелістер плюс өту уақытындағы нақты уақыттағы қозғалыс, жол жұмыстары, жабулар және ауа райы.
traffic=liveТек ағымдағы қозғалыс, апта күні мен сағаттың үйренілген заңдылығынсыз.
traffic=offҚозғалыс қабаты жоқ: маршрут уақыты бос жолмен жүру уақытымен есептеледі.

Жауап блогы: traffic_forecast

Жауапқа traffic_forecast блогы қосылады: бос жол және болжамды ұзақтық, кешігудің себептер бойынша бөлінуі (recurring, live, roadworks, weather), маршруттағы hotspot-тар олардың 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 немесе диспетчерлік бағдарламамда пайдалана аламын ба?

Иә. Бұл JSON қайтаратын қарапайым HTTPS GET сұрауы, сондықтан REST API-ді шақыра алатын кез келген TMS, ERP, диспетчерлік немесе телематика жүйесі оны пайдалана алады. Құжаттамада барлық параметрлер мен жауап схемасы берілген.

API жол ақысын қайтара ма?

Иә, еуромен берілген болжам ретінде: елдер бойынша, маршруттағы ақылы километрлер мен осьтер санына және салмаққа сәйкес жүк көлігі тарифі негізінде, оған маршруттағы ақылы туннельдер мен көпірлер қосылады. Тарифтер — Euro VI тарифтері. Тарифі базада жоқ ел нөл ретінде есептелмейді — ол қамту туралы ескертпеде аталады және жалпы сомадан шығарылады.

Қауіпті жүктерге (ADR) маршрут жоспарлай ала ма?

Жүктің ADR кластарын және оның туннель шектеу кодын жібере аласыз. Санаты осы кодқа тыйым салатын туннельдер санаты картаға түсірілген жерлерде айналып өтіледі; басқа маршрут болмаса, жауапта бұл көрсетіледі. Жүгіңізге қолданылатын ADR ережелерін тексеруге өзіңіз жауаптысыз.

Алғашқы жүк көлігі маршрутыңызды жоспарлаңыз

Тегін аккаунт ашып, кілт алыңыз — әр аккаунтта күніне 10 маршрут сұрауы тегін.