Truck Route API Online
API de rutare pentru camioane, cu stații de alimentare și parcări pentru camioane de-a lungul rutei, plus stații de cântărire și un plan de odihnă pentru șofer. Trimite punctul de plecare, destinația și vehiculul tău (înălțime, greutate, lungime, lățime, sarcină pe axă, mărfuri periculoase) și primești o rută legală pentru vehicule grele, cu restricțiile și interdicțiile datate de circulație pentru camioane pe care le întâlnește, punctele de trecere a frontierei de pe traseu cu timpul de așteptare în timp real, stații de alimentare cu prețuri, parcări pentru camioane (indicator de pază, capacitate, facilități) și cântare auto într-un coridor în jurul traseului. Cu include=rest, regulile UE 561/2006 sunt aplicate stării șoferului tău: pauze de 45 de minute la cel mult 4 h 30 min una de alta, odihne zilnice înainte de limita de 9 h / 10 h, fiecare plasată într-o parcare reală înainte de atingerea limitei, interdicțiile de weekend și de sărbători așteptate, așteptările la frontieră pe cronologie, echipaj simplu sau dublu — iar ETA include toate acestea. Planul de odihnă este un ajutor de planificare, nu o înregistrare de tahograf.
GET https://nakordoni.eu/api/v2/data/truck-route
— clasă de cotă: route
| Parametru | Descriere |
|---|---|
from | Punctul de plecare ca lat,lon (obligatoriu dacă nu este dat from_city), ex. 52.2297,21.0122 |
to | Destinația ca lat,lon (obligatoriu dacă nu este dat to_city) |
from_city | Numele orașului de plecare în loc de coordonate (adaugă from_country pentru precizie) |
from_country | Țara lui from_city conform ISO 3166-1 alpha-2, ex. PL |
to_city | Numele orașului de destinație în loc de coordonate |
to_country | Țara lui to_city conform ISO 3166-1 alpha-2 |
via | Până la 5 puncte intermediare ca lat,lon|lat,lon |
height | Înălțimea vehiculului în metri (1.0–5.0) |
weight | Masa totală a vehiculului în tone (1–60); determină restricțiile și interdicțiile legate de greutate |
length | Lungimea vehiculului în metri (2–30) |
width | Lățimea vehiculului în metri (1.0–3.5) |
axle_load | Sarcina pe axă în tone (1–20) |
axles | Numărul de axe, cap tractor plus remorcă (2–12); folosit pentru rutare și pentru clasele de taxare (implicit pentru taxe: 5 de la 18 t, 3 de la 12 t, altfel 2) |
trailers | Numărul de remorci (0–3); returnat în răspuns, fără efect deocamdată asupra rutării |
hazmat | Mărfuri periculoase: 0 (implicit), 1 = încărcătură ADR fără clasă precizată, sau o listă separată prin virgulă de clase ADR 1–9 și/sau explosive, gas, flammable, flammable_solid, oxidizing, poison, radioactive, corrosive, harmful_to_water |
adr_tunnel | Codul restricției ADR pentru tuneluri al încărcăturii: B, C, D sau E. Tunelurile a căror categorie îl interzice sunt evitate (implică hazmat) |
avoid | Listă separată prin virgulă: tolls, ferries, motorways, borders, tunnels, unpaved, low_emission_zones |
emission_class | Clasa de emisii a vehiculului euro0 … euro6; folosită pentru verificarea zonelor cu emisii reduse și notele despre taxe (taxele sunt calculate la tarifele Euro VI) |
alternatives | Numărul de rute alternative, 0–2 (implicit 0; doar pentru rute fără puncte via) |
geometry | polyline5 (implicit), polyline6 sau geojson |
arrive_at | Sosirea dorită conform RFC 3339; plecarea este planificată înapoi, inclusiv pauzele și odihnele (în loc de depart_at) |
route_type | fastest (implicit) sau eco |
include | Listă separată prin virgulă: fuel, parking, weigh, rest (implicit toate patru) |
corridor_km | Distanța maximă față de rută pentru stațiile de alimentare, parcări și stațiile de cântărire, 0.2–5 km (implicit 2) |
fuel | Tipurile de combustibil de evaluat, listă separată prin virgulă (implicit diesel) |
depart_at | Plecarea în format ISO 8601 cu fus orar, până la 14 zile în avans (implicit: acum) |
aliases | Acceptate pentru trecere ușoară: depart → depart_at, departAt, arriveAt, vehicleHeight, vehicleWidth, vehicleLength, vehicleWeight (kg sau t), vehicleAxleWeight / axleWeight → axle_load, vehicleNumberOfAxles / axleCount → axles, vehicleTrailers → trailers, vehicleAdrTunnelRestrictionCode → adr_tunnel, vehicleEmissionClass → emission_class, maxAlternatives → alternatives, waypoints → via |
crew | 1 (implicit) sau 2 șoferi — echipajul dublu folosește fereastra de 30 de ore pentru odihna zilnică și odihne de 9 h |
traffic | forecast (implicit), live sau off. forecast = congestie recurentă învățată + trafic live în apropierea plecării + lucrări rutiere, închideri și condiții meteo la momentul trecerii; live = trafic curent fără tiparul învățat; off = fără strat de trafic (durată de parcurs în regim liber) |
driven_since_break_min | Starea șoferului: minute conduse de la ultima pauză de 45 de minute (implicit 0) |
driven_today_min | Starea șoferului: minute conduse de la ultima odihnă zilnică (implicit 0) |
driven_week_min | Starea șoferului: minute conduse în această săptămână calendaristică (implicit 0) |
driven_last_week_min | Starea șoferului: minute conduse în săptămâna trecută, pentru limita de 90 h pe două săptămâni (implicit 0) |
reduced_daily_rests_used | Odihne zilnice reduse (9 h) deja luate de la ultima odihnă săptămânală, 0–3 (implicit 0) |
extended_days_used | Zile de condus de 10 ore deja folosite în această săptămână, 0–2 (implicit 0) |
last_weekly_rest_end | Sfârșitul ultimei odihne săptămânale în format ISO 8601 (implicit: presupus chiar înainte de plecare) |
reduced_weekly_ok | 1 = se poate planifica o odihnă săptămânală redusă (24 h) (implicit 0 = regulată, 45 h) |
lang | Codul limbii pentru nume și mesaje (implicit en) |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
data.route | distance_m, duration_s (pure driving), geometry (format in geometry_format), bbox, countries (ISO codes in order), departure_at, toll_distance_m, fuel_l, ascent_m, descent_m, legal, avoid; with arrive_at also arrive_at_requested. |
data.route.country_split[] | Per country in route order: country, km, duration_min. |
data.route.adr | Only with adr_tunnel: tunnel_code, tunnels_avoided[] and tunnels_on_route[] (name, category, lat, lon). |
data.route.low_emission_zones_avoided[] | Only with avoid=low_emission_zones: zones the route was moved out of (name, country); low_emission_zones_on_route[] lists any that could not be avoided. |
data.tolls | Estimated truck tolls: currency (EUR), total_eur, complete, by_country[] (country, km_toll, cost_eur, basis), objects[] (priced tunnels and bridges: name, type, country, lat, lon, cost_eur, basis), estimate, coverage_note. A country we cannot price has cost_eur null and is named in coverage_note. |
data.alternatives[] | Only with alternatives: distance_m, duration_s, forecast_duration_s (with traffic), tolls (currency, total_eur, complete, by_country) and geometry for each alternative route. Alternatives are planned without time-dependent restrictions and are not ban-checked; the main route is. Empty when no reasonable alternative exists. |
data.route.restriction_hits[] | Restrictions for this vehicle still on the line: kind, name, country, at_km. |
data.route.truck_bans[] | Dated truck driving bans on the route: name, kind, country, details, min_weight_t, window_from, window_to, eta_at_ban (on the traffic forecast timeline), eta_at_ban_free (free-flow timeline), km_from_start, applies, active, avoided. |
data.route.border_crossings[] | Crossings on the route: name, ppid, from_country, to_country, lat, lon, km_from_start, status; wait_min = time on the exit side + the entry side at the planned arrival (wait_at), null when neither side is measured (wait_minutes = same value, legacy name); wait_sides[] (side country, role exit|entry, ppid, min, basis live|forecast, note when not measured); wait_notes[]; wait_capped (a side over 48 h is planned at 48 h); registration_required = an electronic-queue lane: register before arriving, the time to get a slot is not included in the wait. |
data.route.warnings[] | code and message, e.g. ban_avoidance_skipped, restrictions_on_route, adr_tunnel_on_route, adr_tunnel_not_checked, low_emission_zone_on_route, closure_on_route (a full motorway closure overlaps the passing time), tolls_not_fully_avoided, arrive_at_not_reachable. |
data.route.closures_on_route[] | German motorways: closures, roadworks and traffic warnings within 150 m of the line whose time window overlaps the moment the truck passes: type (closure, roadwork, warning), road, title, km_from_start, eta, from, to, full_closure, lorry_specific (text names lorries or a weight limit), lat, lon. The route is not changed around them. |
data.traffic_forecast | Unless traffic=off: model, mode, duration_base, duration_s_free, duration_s_forecast, delay_s (recurring, live, roadworks, weather, total), hotspots[] (km_from_start, km_to, eta, delay_s, reason recurring|live|roadworks|lane_closure|closure|weather, label, road, confidence low|medium|high, dow_hour, delay_by_reason, country; jam_frequency and road_condition where known), weather_on_route[], closures_avoided[], recommended_alternative (a forecast-faster alternative is only recommended — the primary route is never swapped), coverage (how much data backed the plan, with a note), calc_ms. The forecast timeline drives the ETA, rest plan, ban timing and border-wait timing. A planning estimate; data collection started in September 2026. |
data.rest_plan[] | EU 561/2006 stops in order: type (break, daily_rest, weekly_rest), start_at, end_at, duration_min, km_from_start, parking (a parkings[] row or null), reason, overlaps_ban, counts_as. |
data.waits[] | Forced waits on the timeline: ban_wait (a driving ban) and border_wait, same shape as rest_plan. |
data.eta | Arrival time including driving, breaks, rests, ban waits and border waits; with driving_time_min, total_time_min and crew. |
data.weekly_rest_check | next_weekly_rest_due_by, weekly_rest_on_trip, driven_week_min_at_arrival, driven_fortnight_min_at_arrival, weekly and fortnight limits, reduced rests and 10 h days used at arrival. |
data.assumptions[] | Defaults applied to driver state you did not send, and country rules not planned for. |
data.rest_warnings[] | code, km_from_start, message — e.g. no_parking_in_window when a stop had to be placed at the legal limit. |
data.fuel_stations[] | name, brand, lat, lon, country, km_from_start, distance_from_route_km, detour_km, prices[] (fuel_type, price, currency, stale), price_updated_at. |
data.parkings[] | name, type (parking, rest_area, truck_stop, autohof), lat, lon, country, km_from_start, distance_from_route_km, detour_km, capacity, capacity_trucks (official truck spaces where known, e.g. German motorway rest areas), secure, amenities[], opening_hours. |
data.weigh_stations[] | name, lat, lon, country, km_from_start, distance_from_route_km, detour_km, type and side (null when not known). |
data.coverage | corridor_km, countries_on_route, fuel_grades, fuel countries with sparse or no price data, truncated lists, measured_at. |
data.resolved_locations | Only with from_city/to_city: query, lat, lon, label of the geocoded point. |
data.disclaimer | The rest plan is a planning aid, not a tachograph record or legal advice. |
data.attribution | List of credits to display: always "Data by nakordoni.eu"; plus "Weigh stations: © OpenStreetMap contributors (ODbL)" whenever weigh_stations is non-empty. |
curl "https://nakordoni.eu/api/v2/data/truck-route?from=52.2297,21.0122&to=52.52,13.405&weight=40&height=4&axles=5&emission_class=euro6&crew=1" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Actualizat