La soumission d'actualités et la flotte NakBus sont désormais dans le tableau de bord partenaire
Connectez votre compte développeur à un compte Nakordoni Partners avec la même adresse e-mail et gérez-y les actualités et votre flotte de bus (NakDriver / NakManager), avec des rôles d'équipe. Vos clés API, points de terminaison et applications restent inchangés, et les pages ici continuent de fonctionner. Ouvrir Nakordoni Partners
Truck Route API Online
API de calcul d'itinéraire poids lourd avec stations-service et parkings poids lourds le long du parcours, ainsi que postes de pesage et plan de repos du conducteur. Envoyez l'origine, la destination et votre véhicule (hauteur, poids, longueur, largeur, charge à l'essieu, matières dangereuses) et obtenez un itinéraire conforme à la réglementation PL avec les restrictions et les interdictions de circulation datées rencontrées, les passages de frontière avec leur attente en direct, les stations-service avec prix, les parkings poids lourds (sécurisé, capacité, équipements) et les ponts-bascules dans un corridor autour du tracé. Avec include=rest, les règles UE 561/2006 sont appliquées à l'état de votre conducteur : pauses de 45 minutes toutes les 4 h 30 au plus, repos quotidiens avant la limite de 9 h / 10 h, chacun placé sur un vrai parking avant que la limite soit atteinte, interdictions de week-end et de jours fériés attendues, attentes aux frontières sur la chronologie, équipage simple ou double — et l'heure d'arrivée estimée inclut le tout. Le plan de repos est une aide à la planification, pas un enregistrement de chronotachygraphe.
GET https://nakordoni.eu/api/v2/data/truck-route
— classe de quota: route
| Paramètre | Description |
|---|---|
from | Origine sous forme lat,lon (obligatoire sauf si from_city est fourni), p. ex. 52.2297,21.0122 |
to | Destination sous forme lat,lon (obligatoire sauf si to_city est fourni) |
from_city | Nom de la ville d'origine au lieu des coordonnées (ajoutez from_country pour plus de précision) |
from_country | Pays ISO 3166-1 alpha-2 de from_city, p. ex. PL |
to_city | Nom de la ville de destination au lieu des coordonnées |
to_country | Pays ISO 3166-1 alpha-2 de to_city |
via | Jusqu'à 5 étapes sous forme lat,lon|lat,lon |
height | Hauteur du véhicule en mètres (1.0–5.0) |
weight | Poids total en charge du véhicule en tonnes (1–60) ; détermine les restrictions et interdictions liées au poids |
length | Longueur du véhicule en mètres (2–30) |
width | Largeur du véhicule en mètres (1.0–3.5) |
axle_load | Charge à l'essieu en tonnes (1–20) |
axles | Nombre d'essieux, tracteur plus remorque (2–12) ; utilisé pour le calcul d'itinéraire et pour les classes de péage (par défaut pour les péages : 5 à partir de 18 t, 3 à partir de 12 t, sinon 2) |
trailers | Nombre de remorques (0–3) ; renvoyé dans la réponse, sans effet sur l'itinéraire pour l'instant |
hazmat | Marchandises dangereuses : 0 (par défaut), 1 = chargement ADR sans classe indiquée, ou liste séparée par des virgules de classes ADR 1–9 et/ou explosive, gas, flammable, flammable_solid, oxidizing, poison, radioactive, corrosive, harmful_to_water |
adr_tunnel | Code de restriction ADR pour les tunnels de la cargaison : B, C, D ou E. Les tunnels dont la catégorie l'interdit sont évités (implique hazmat) |
avoid | Liste séparée par des virgules de tolls, ferries, motorways, borders, tunnels, unpaved, low_emission_zones |
emission_class | Classe d'émissions du véhicule euro0 … euro6 ; utilisée pour les contrôles de zones à faibles émissions et les notes de péage (les péages sont calculés aux tarifs Euro VI) |
alternatives | Nombre d'itinéraires alternatifs, 0–2 (par défaut 0 ; uniquement pour les itinéraires sans points via) |
geometry | polyline5 (par défaut), polyline6 ou geojson |
arrive_at | Arrivée souhaitée au format RFC 3339 ; le départ est calculé à rebours en incluant pauses et repos (à la place de depart_at) |
route_type | fastest (par défaut) ou eco |
include | Liste séparée par des virgules de fuel, parking, weigh, rest (par défaut : les quatre) |
corridor_km | Distance maximale à l'itinéraire pour les stations-service, parkings et postes de pesage, 0.2–5 km (par défaut 2) |
fuel | Types de carburant à tarifer, liste séparée par des virgules (par défaut diesel) |
depart_at | Départ au format ISO 8601 avec fuseau horaire, jusqu'à 14 jours à l'avance (par défaut : maintenant) |
aliases | Acceptés pour faciliter la migration : depart → depart_at, departAt, arriveAt, vehicleHeight, vehicleWidth, vehicleLength, vehicleWeight (kg ou t), vehicleAxleWeight / axleWeight → axle_load, vehicleNumberOfAxles / axleCount → axles, vehicleTrailers → trailers, vehicleAdrTunnelRestrictionCode → adr_tunnel, vehicleEmissionClass → emission_class, maxAlternatives → alternatives, waypoints → via |
crew | 1 (par défaut) ou 2 conducteurs — l'équipage double utilise la fenêtre de repos quotidien de 30 heures et des repos de 9 h |
traffic | forecast (par défaut), live ou off. forecast = congestion récurrente apprise + trafic en direct près du départ + travaux, fermetures et météo au moment du passage ; live = trafic actuel sans le schéma appris ; off = aucune couche de trafic (temps de trajet en circulation fluide) |
driven_since_break_min | État du conducteur : minutes conduites depuis la dernière pause de 45 minutes (par défaut 0) |
driven_today_min | État du conducteur : minutes conduites depuis le dernier repos quotidien (par défaut 0) |
driven_week_min | État du conducteur : minutes conduites cette semaine calendaire (par défaut 0) |
driven_last_week_min | État du conducteur : minutes conduites la semaine dernière, pour la limite de 90 h par quinzaine (par défaut 0) |
reduced_daily_rests_used | Repos quotidiens réduits (9 h) déjà pris depuis le dernier repos hebdomadaire, 0–3 (par défaut 0) |
extended_days_used | Jours de conduite de 10 heures déjà utilisés cette semaine, 0–2 (par défaut 0) |
last_weekly_rest_end | Fin du dernier repos hebdomadaire au format ISO 8601 (par défaut : supposée juste avant le départ) |
reduced_weekly_ok | 1 = un repos hebdomadaire réduit (24 h) peut être planifié (par défaut 0 = régulier de 45 h) |
lang | Code de langue pour les noms et les messages (par défaut en) |
Champs de la réponse — à l’intérieur de l’objet data de l’enveloppe. [] indique une liste : data.items[].name est donc le champ name de chaque élément. Un champ vaut null, est absent ou est une liste vide quand nous n’avons pas de valeur — jamais un espace réservé.
| Champ | Description |
|---|---|
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"
Présentation, couverture et tarifs : Truck Route API
🔑 Connectez-vous en tant que développeur pour essayer cet endpoint en direct dans la sandbox — 50 appels de test gratuits par jour. Connexion
Mis à jour