Skip to main content
Menu
E re · API v2

Truck Route API: planifikues rruge për kamionë me pika karburanti dhe parkime kamionësh përgjatë rrugës

Një thirrje kthen një rrugë të lejuar për mjetin tuaj, një plan pushimi për shoferin sipas rregullave të BE-së për kohën e drejtimit, si dhe pikat e karburantit dhe parkimet e kamionëve përgjatë rrugës — me çmimet aktuale, distancën nga nisja dhe devijimin që kërkon secila.

Llogaritur me të njëjtin motor rrugëzimi si aplikacioni ynë i navigimit për kamionë TruckTurn.

Merrni një çelës API falas Lexoni dokumentacionin Shihni çmimet

Planifikues rruge për kamionë për flota, dispeçeri dhe TMS

Dispeçeria e transportuesve

Planifikoni një rrugë kamioni që i përshtatet mjetit para se shoferi të niset dhe shihni ku mund të furnizohet me karburant dhe të pushojë kamioni gjatë rrugës.

Ofruesit e TMS dhe ERP

Shtoni një API për planifikimin e rrugëve të mjeteve të rënda në softuerin tuaj të menaxhimit të transportit, pa ndërtuar, pritur apo mirëmbajtur një motor rrugëzimi.

Telematika e flotave

Ktheni pozicionin aktual dhe gjendjen e takografit të shoferit në një ETA realiste me ndalesa pushimi dhe sugjeroni pikën e radhës të karburantit ose parkimin.

Tregjet e ngarkesave

Jepni oferta për ngarkesa bazuar në një distancë të lejuar për kamionë dhe një kohë drejtimi që përfshin pushimet, në vend të një rruge për makina.

Çfarë merrni në një thirrje

API rrugëzimi për kamionë

Distanca, kohëzgjatja dhe gjeometria e rrugës që respektojnë lartësinë, peshën, gjatësinë, gjerësinë dhe ngarkesën për bosht të mjetit tuaj, si dhe klasën e mallrave të rrezikshme që deklaroni.

Ndalimet për kamionë dhe kontrollet e lejueshmërisë

Ndalimet e qarkullimit për kamionë dhe kufizimet e mjeteve që njohim merren parasysh kur llogaritet rruga.

Plan pushimi sipas rregullave të BE-së për kohën e drejtimit

Pushime të shkurtra, pushime ditore dhe javore sipas EU Regulation 561/2006, secili në një parkim kamionësh në rrugë, me orare.

Pika karburanti përgjatë rrugës

Pika pranë rrugës me çmime aktuale aty ku i kemi, kilometri ku ndodhen dhe devijimi.

Parkime kamionësh përgjatë rrugës

Parkime kamionësh dhe zona pushimi me kilometrin nga nisja dhe devijimin nga rruga.

Stacione peshimi përgjatë rrugës

Peshore kamionësh dhe stacione peshimi në rrugë, me kilometrin ku ndodhet secili.

Kostot e pagesës rrugore sipas vendit

Një vlerësim i pagesave rrugore për kamionë në rrugë, në euro, sipas vendit dhe për tunelet e urat me pagesë, bazuar në numrin e boshteve dhe peshën. Vendet që ende nuk mund t'i llogarisim emërtohen në përgjigje dhe nuk llogariten kurrë si falas.

Mallra të rrezikshme dhe opsione shmangieje

Deklaroni klasat ADR dhe kodin e kufizimit për tunelet (B, C, D ose E) të ngarkesës suaj, dhe tunelet, kategoria e të cilave e ndalon, shmangen aty ku kategoria është e hartuar. Mund të shmangni gjithashtu pagesat rrugore, tragetet, autostradat, pikat kufitare, tunelet, rrugët e pashtruara dhe zonat me emetime të ulëta.

Rrugëzim ekologjik

Kërkoni një rrugë që i jep përparësi konsumit më të ulët të karburantit para kohës më të shkurtër të drejtimit.

Shmang Rusinë dhe Kaliningradin

Rrugët nuk kalojnë kurrë nëpër Rusi apo Kaliningrad.

Plan pushimi për shoferin sipas rregullave të BE-së për kohën e drejtimit (Rregullorja 561/2006)

Një planifikues pushimesh për mjete të rënda, i integruar në rrugë. API planifikon kohën e drejtimit, pushimet e shkurtra dhe të gjata ashtu siç i përshkruan EU Regulation 561/2006 dhe e vendos çdo ndalesë në një parkim të vërtetë kamionësh përgjatë rrugës — kështu që ETA që merrni është një ETA kamioni me ndalesa pushimi, jo një kohë drejtimi pa ndërprerje.

Një mjet ndihmës planifikimi, jo regjistrim takografi dhe jo këshillë ligjore. Shoferi dhe operatori mbeten përgjegjës për respektimin e rregullave të kohës së drejtimit.

Parashikimi i trafikut përgjatë rrugës

Si parazgjedhje, koha e rrugës llogaritet me një parashikim trafiku për momentin kur kamioni kalon realisht çdo seksion, jo për momentin kur dërgoni kërkesën. Vija kohore e parashikimit përcakton ETA-n, planin e pushimit sipas EU 561, kohën e ndalimeve të qarkullimit dhe kohën e mbërritjes në pikat kufitare.

Një vlerësim planifikimi, jo garanci. Mbledhja e të dhënave filloi në shtator 2026, ndaj modelet e mësuara janë ende të reja dhe përmirësohen ndërsa grumbullohen javë të dhënash. Moti nuk mbulohet kudo. Kur një alternativë duket më e shpejtë, ajo rekomandohet në përgjigje; rruga kryesore nuk zëvendësohet kurrë në vendin tuaj.

Parametri: traffic

VleraÇfarë bën
traffic=forecastParazgjedhja. Bllokimet e përsëritura të mësuara plus trafiku live, punimet rrugore, mbylljet dhe moti në kohën e kalimit.
traffic=liveVetëm trafiku aktual, pa modelin e mësuar sipas ditës së javës dhe orës.
traffic=offPa shtresë trafiku: koha e rrugës llogaritet me kohën e udhëtimit në rrugë të lirë.

Blloku i përgjigjes: traffic_forecast

Përgjigja shton një bllok traffic_forecast: kohëzgjatjet në rrugë të lirë dhe ato të parashikuara, vonesën e ndarë sipas shkakut (e përsëritur, live, punime rrugore, mot), hotspots në rrugë me ETA, shkakun, rrugën, besueshmërinë dhe ditën e javës e orën, pikat e motit në rrugë, mbylljet e shmangura, një alternativë të rekomanduar kur parashikohet të jetë më e shpejtë, si dhe shifrat e coverage. Çdo rrugë alternative përmban forecast_duration_s, dhe çdo ndalim qarkullimi përmban eta_at_ban në vijën kohore të parashikimit pranë 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"
Shfaq një pjesë të një përgjigjeje reale 
{
  "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", "…": "…" }
    ],
    "…": "…"
  }
}

Një përgjigje reale, e shkurtuar në dy hotspots, një pikë moti, një alternativë dhe një ndalim; tekstet e gjata janë shkurtuar. Dokumentacioni përmban listën e plotë të fushave.

Shihni një llogaritje reale

Përgjigje të ruajtura për rrugë të njohura kamionësh, të llogaritura nga API — harta, ndalesat e pushimit dhe ETA më poshtë janë ato që ktheu API, jo një thirrje në kohë reale nga kjo faqe.

  • Pikë karburanti
  • Parkim kamionësh
  • Stacion peshimi
  • Pushim
  • Pushim ditor
  • Pushim javor
  • Pritje në kufi
Distanca930 km
Koha e drejtimit10 orë 22 min
Koha totale me pushimet22 orë 7 min
  1. NisjaDita 1, 06:00
  2. Drejtim · 394 km · 4 orë 24 min
  3. Pushim · 45 min Dita 1, 10:24 · në Raststätte Börde-Nord 1, Hohe Börde
  4. Drejtim · 401 km · 4 orë 27 min
  5. Pushim ditor · 11 orë 0 min Dita 1, 15:37 · në Punkt 9749
  6. Drejtim · 135 km · 1 orë 29 min
  7. Mbërritja (ETA)Dita 2, 04:06

Kërkesa

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
Pjesë nga përgjigjja 
{
    "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"
  …

Llogaritur më 2026-10-09 04:30 UTC

Shembull kërkese dhe përgjigjeje

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

I shkurtuar dhe ilustrues — emrat e fushave mund të ndryshojnë ende para publikimit. Dokumentacioni përmban listën e plotë të parametrave dhe skemën e përgjigjes.

Mbulimi

Rrugëzimi mbulon Evropën dhe nuk kalon kurrë nëpër Rusi apo Kaliningrad. Çmimet e karburantit dhe dendësia e parkimeve ndryshojnë sipas vendit — listat më poshtë vijnë drejtpërdrejt nga të dhënat tona në kohë reale.

Vendet me çmime të pikave të karburantit

Çmimet aktuale të pikave janë të disponueshme vetëm në këto vende. Gjetkë rruga, plani i pushimit dhe parkimet funksionojnë njësoj, por çmimet e karburantit nuk kthehen.

  • Itali · 58,659 pika
  • Gjermani · 43,672 pika
  • Spanjë · 39,429 pika
  • Francë · 31,496 pika
  • Greqi · 14,154 pika
  • Portugali · 9,807 pika
  • Norvegji · 4,001 pika
  • Kroaci · 2,540 pika
  • Austri · 1,996 pika
  • Slloveni · 1,736 pika
  • Poloni · 151 pika · mbulim i kufizuar

Parkime kamionësh sipas vendit

Vendndodhjet e parkimeve të kamionëve që kemi, sipas vendit. Mbulimi është më i dendur në disa vende se në të tjerë.

  • Poloni · 6,286 parkime
  • Gjermani · 3,518 parkime
  • Francë · 1,184 parkime
  • Çeki · 963 parkime
  • Rumani · 924 parkime
  • Belgjikë · 815 parkime
  • Spanjë · 731 parkime
  • Austri · 677 parkime
  • Holandë · 633 parkime
  • Hungari · 572 parkime
  • Itali · 535 parkime
  • Sllovaki · 472 parkime
  • Kroaci · 429 parkime
  • Lituani · 360 parkime
  • Bullgari · 340 parkime
  • Mbretëria e Bashkuar · 241 parkime
  • Letoni · 235 parkime
  • Serbi · 215 parkime
  • Ukrainë · 200 parkime
  • Estoni · 199 parkime
  • Maqedonia e Veriut · 135 parkime
  • Greqi · 116 parkime
  • Slloveni · 116 parkime
  • Portugali · 104 parkime
  • Suedi · 84 parkime
  • Danimarkë · 83 parkime
  • Zvicër · 79 parkime
  • Norvegji · 67 parkime
  • Luksemburg · 64 parkime
  • Mal i Zi · 55 parkime
  • Shqipëri · 51 parkime

Plus numra më të vegjël në 2 vende të tjera.

Numrat lexohen nga baza jonë e të dhënave dhe rifreskohen çdo disa orë.

Çmimet

Çdo llogari

Falas
  • 10 thirrje rrugësh në ditë
  • Falas për çdo llogari, përfshirë Explorer. Nuk nevojitet kartë.
Merrni një çelës API falas

Pro

€99 / muaj
  • 2,000 thirrje rrugësh në ditë
  • Të përfshira në plan, krahas thirrjeve të tjera të API-t të të dhënave.
Zgjidhni një plan

Pro MAX

€299 / muaj
  • 10,000 thirrje rrugësh në ditë
  • Të përfshira në plan, krahas thirrjeve të tjera të API-t të të dhënave.
Zgjidhni një plan

Thirrje shtesë rrugësh

€9 / muaj për bllok
  • +100 thirrje rrugësh në ditë
  • Shtoni blloqe në një plan me pagesë kur flota juaj ka nevojë për më shumë.

Çmimet janë neto, pa TVSH.

Pyetje të shpeshta

Çfarë është Truck Route API?

Një API rrugëzimi për kamionë: dërgoni një nisje, një destinacion dhe mjetin tuaj, dhe merrni një rrugë të lejuar për kamionë, një plan pushimi për shoferin sipas rregullave të BE-së për kohën e drejtimit, si dhe pikat e karburantit dhe parkimet e kamionëve përgjatë rrugës — në një përgjigje JSON.

Si ndryshon nga një API rrugëzimi për makina?

Një rrugë për makina mund ta dërgojë një mjet 4 metra të lartë dhe 40 tonë nën një urë të ulët ose në një rrugë me kufizim peshe. Kjo rrugë llogaritet sipas përmasave, peshave, ngarkesës për bosht dhe klasës së mallrave të rrezikshme të mjetit tuaj dhe merr parasysh ndalimet e qarkullimit për kamionë.

A i planifikon pushimet e shoferit?

Po. Planifikon pushimet e shkurtra, pushimet ditore dhe javore sipas EU Regulation 561/2006 — përfshirë pushimet e ndara, pushimet e reduktuara dhe drejtimin në ekip me dy shoferë — e vendos çdo ndalesë në një parkim kamionësh në rrugë dhe i përfshin në ETA. Jepni kohët aktuale të drejtimit të shoferit dhe plani nis nga aty ku ndodhet.

A është plani i pushimit garanci ligjore?

Jo. Është një mjet ndihmës planifikimi që ndjek rregullat ashtu siç i kemi zbatuar ne. Nuk është regjistrim takografi, as këshillë ligjore, dhe nuk garanton përputhshmërinë. Shoferi dhe operatori mbeten përgjegjës, dhe trafiku real, pritjet dhe kohët e ngarkimit do ta ndryshojnë planin.

Cilat vende kanë çmime karburanti?

Vetëm vendet e listuara te Mbulimi në këtë faqe. Ajo listë gjenerohet nga të dhënat tona në kohë reale, ndaj tregon atë që API mund të kthejë sot.

A kalon ndonjëherë një rrugë nëpër Rusi?

Jo. Rrugët shmangin Rusinë dhe Kaliningradin.

Sa thirrje rrugësh janë falas?

Çdo llogari merr 10 thirrje rrugësh falas në ditë. Planet me pagesë përfshijnë më shumë, dhe thirrje shtesë rrugësh mund të shtohen në blloqe prej 100 në ditë.

A mund ta përdor në TMS-në ose softuerin tim të dispeçerisë?

Po. Është një HTTPS GET i thjeshtë që kthen JSON, kështu që çdo sistem TMS, ERP, dispeçerie ose telematike që mund të thërrasë një REST API mund ta përdorë. Dokumentacioni liston çdo parametër dhe skemën e përgjigjes.

A i kthen API kostot e pagesës rrugore?

Po, si vlerësim në euro: sipas vendit, nga kilometrat me pagesë në rrugë dhe tarifa e kamionëve për numrin e boshteve dhe peshën tuaj, plus tunelet dhe urat me pagesë në rrugë. Tarifat janë tarifa Euro VI. Një vend pa tarifë në të dhënat tona listohet në një shënim mbulimi dhe lihet jashtë totalit, në vend që të llogaritet si zero.

A mund të planifikojë rrugë për mallra të rrezikshme (ADR)?

Mund të dërgoni klasat ADR të ngarkesës dhe kodin e saj të kufizimit për tunelet. Tunelet, kategoria e të cilave e ndalon atë kod, shmangen aty ku kategoria është e hartuar; nëse nuk ekziston rrugë tjetër, përgjigjja e thotë këtë. Ju mbeteni përgjegjës për kontrollin e rregullave ADR që vlejnë për ngarkesën tuaj.

Planifikoni rrugën tuaj të parë për kamion

Krijoni një llogari falas dhe merrni një çelës — 10 thirrje rrugësh në ditë janë falas për çdo llogari.

Merrni një çelës API falas Lexoni dokumentacionin