Dërgimi i lajmeve dhe flota NakBus tani janë në panelin e partnerit
Lidhni llogarinë tuaj të zhvilluesit me një llogari Nakordoni Partners me të njëjtin email dhe menaxhoni atje lajmet dhe flotën tuaj të autobusëve (NakDriver / NakManager), me role ekipi. Çelësat tuaj API, endpoints dhe aplikacionet mbeten të pandryshuara, dhe faqet këtu vazhdojnë të funksionojnë. Hap Nakordoni Partners
Truck Route API Online
API për itinerare kamionësh me stacione karburanti dhe parkime kamionësh përgjatë itinerarit, plus stacione peshimi dhe plan pushimi për shoferin. Dërgoni origjinën, destinacionin dhe mjetin tuaj (lartësia, pesha, gjatësia, gjerësia, ngarkesa për bosht, mallra të rrezikshme) dhe merrni një itinerar të ligjshëm për kamionë të rëndë, me kufizimet dhe ndalimet e datuara të qarkullimit të kamionëve që has, kalimet kufitare në të me pritjen e tyre live, stacione karburanti me çmime, parkime kamionësh (shenja e sigurisë, kapaciteti, shërbimet) dhe peshore brenda një korridori rreth vijës. Me include=rest zbatohen rregullat e EU 561/2006 për gjendjen e shoferit tuaj: pushime 45-minutëshe me maksimumi 4 orë 30 minuta largësi, pushime ditore para kufirit 9 orë / 10 orë, secili vendosur në një parking real përpara se të arrihet kufiri, pritje për ndalimet e fundjavës dhe festave, pritje kufitare në vijën kohore, ekuipazh i vetëm ose i dyfishtë — dhe ora e vlerësuar e mbërritjes i përfshin të gjitha. Plani i pushimit është ndihmë planifikimi, jo regjistrim tahografi.
GET https://nakordoni.eu/api/v2/data/truck-route
— klasa e kuotës: route
| Parametri | Përshkrimi |
|---|---|
from | Origjina si lat,lon (e detyrueshme nëse nuk jepet from_city), p.sh. 52.2297,21.0122 |
to | Destinacioni si lat,lon (e detyrueshme nëse nuk jepet to_city) |
from_city | Emri i qytetit të origjinës në vend të koordinatave (shtoni from_country për saktësi) |
from_country | Shteti ISO 3166-1 alpha-2 i from_city, p.sh. PL |
to_city | Emri i qytetit të destinacionit në vend të koordinatave |
to_country | Shteti ISO 3166-1 alpha-2 i to_city |
via | Deri në 5 pika kalimi si lat,lon|lat,lon |
height | Lartësia e mjetit në metra (1.0–5.0) |
weight | Pesha bruto e mjetit në tonë (1–60); ndikon te kufizimet dhe ndalimet e lidhura me peshën |
length | Gjatësia e mjetit në metra (2–30) |
width | Gjerësia e mjetit në metra (1.0–3.5) |
axle_load | Ngarkesa për bosht në tonë (1–20) |
axles | Numri i boshteve, traktor plus rimorkio (2–12); përdoret për itinerarin dhe për klasat e pagesës rrugore (parazgjedhje për pagesën: 5 nga 18 t, 3 nga 12 t, përndryshe 2) |
trailers | Numri i rimorkiove (0–3); kthehet në përgjigje, ende pa efekt në itinerar |
hazmat | Mallra të rrezikshme: 0 (parazgjedhje), 1 = ngarkesë ADR pa klasë të specifikuar, ose një listë e ndarë me presje e klasave ADR 1–9 dhe/ose explosive, gas, flammable, flammable_solid, oxidizing, poison, radioactive, corrosive, harmful_to_water |
adr_tunnel | Kodi i kufizimit ADR për tunelet i ngarkesës: B, C, D ose E. Tunelet kategoria e të cilëve e ndalon shmangen (nënkupton hazmat) |
avoid | Listë e ndarë me presje e tolls, ferries, motorways, borders, tunnels, unpaved, low_emission_zones |
emission_class | Klasa e emetimeve e mjetit euro0 … euro6; përdoret për kontrollet e zonave me emetime të ulëta dhe shënimet e pagesës rrugore (pagesat çmohen sipas tarifave Euro VI) |
alternatives | Numri i itinerareve alternative, 0–2 (parazgjedhje 0; vetëm për itinerare pa pika via) |
geometry | polyline5 (parazgjedhje), polyline6 ose geojson |
arrive_at | Mbërritja e dëshiruar si RFC 3339; nisja planifikohet mbrapsht duke përfshirë pushimet (në vend të depart_at) |
route_type | fastest (parazgjedhje) ose eco |
include | Listë e ndarë me presje e fuel, parking, weigh, rest (parazgjedhje: të katërta) |
corridor_km | Distanca maksimale nga itinerari për stacionet e karburantit, parkimit dhe peshimit, 0.2–5 km (parazgjedhje 2) |
fuel | Llojet e karburantit për t'u çmuar, listë e ndarë me presje (parazgjedhje diesel) |
depart_at | Nisja si ISO 8601 me zonë kohore, deri në 14 ditë përpara (parazgjedhje: tani) |
aliases | Pranohen për kalim të lehtë: depart → depart_at, departAt, arriveAt, vehicleHeight, vehicleWidth, vehicleLength, vehicleWeight (kg ose t), vehicleAxleWeight / axleWeight → axle_load, vehicleNumberOfAxles / axleCount → axles, vehicleTrailers → trailers, vehicleAdrTunnelRestrictionCode → adr_tunnel, vehicleEmissionClass → emission_class, maxAlternatives → alternatives, waypoints → via |
crew | 1 (parazgjedhje) ose 2 shoferë — ekuipazhi i dyfishtë përdor dritaren ditore të pushimit prej 30 orësh dhe pushime 9-orëshe |
traffic | forecast (parazgjedhja), live ose off. forecast = bllokimet e përsëritura të mësuara + trafiku live pranë nisjes + punimet rrugore, mbylljet dhe moti në kohën e kalimit; live = trafiku aktual pa modelin e mësuar; off = pa shtresë trafiku (koha e udhëtimit në rrugë të lirë) |
driven_since_break_min | Gjendja e shoferit: minuta të drejtuara që nga pushimi i fundit 45-minutësh (parazgjedhje 0) |
driven_today_min | Gjendja e shoferit: minuta të drejtuara që nga pushimi i fundit ditor (parazgjedhje 0) |
driven_week_min | Gjendja e shoferit: minuta të drejtuara këtë javë kalendarike (parazgjedhje 0) |
driven_last_week_min | Gjendja e shoferit: minuta të drejtuara javën e kaluar, për kufirin 90-orësh dyjavor (parazgjedhje 0) |
reduced_daily_rests_used | Pushime ditore të shkurtuara (9 orë) të marra tashmë që nga pushimi i fundit javor, 0–3 (parazgjedhje 0) |
extended_days_used | Ditë drejtimi 10-orëshe të përdorura tashmë këtë javë, 0–2 (parazgjedhje 0) |
last_weekly_rest_end | Fundi i pushimit të fundit javor si ISO 8601 (parazgjedhje: supozohet pak para nisjes) |
reduced_weekly_ok | 1 = mund të planifikohet një pushim javor i shkurtuar (24 orë) (parazgjedhje 0 = i rregullt 45 orë) |
lang | Kodi i gjuhës për emrat dhe mesazhet (parazgjedhje en) |
Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.
| Fusha | Përshkrimi |
|---|---|
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"
Përmbledhje, mbulimi dhe çmimet: Truck Route API
🔑 Hyni si zhvillues për ta provuar këtë endpoint drejtpërdrejt në Sandbox — 50 thirrje testimi falas në ditë. Hyni
Përditësuar