Truck Route API Online
API διαδρομολόγησης φορτηγών με πρατήρια καυσίμων και χώρους στάθμευσης φορτηγών κατά μήκος της διαδρομής, καθώς και σταθμούς ζύγισης και πλάνο ανάπαυσης οδηγού. Στείλτε αφετηρία, προορισμό και το όχημά σας (ύψος, βάρος, μήκος, πλάτος, φορτίο άξονα, επικίνδυνα φορτία) και λάβετε διαδρομή νόμιμη για βαρέα οχήματα με τους περιορισμούς και τις χρονικά προσδιορισμένες απαγορεύσεις κυκλοφορίας φορτηγών που συναντά, τα συνοριακά περάσματα με τον ζωντανό χρόνο αναμονής, πρατήρια με τιμές καυσίμων, χώρους στάθμευσης φορτηγών (ασφαλής, χωρητικότητα, παροχές) και ζυγιστήρια εντός ζώνης γύρω από τη διαδρομή. Με include=rest εφαρμόζονται οι κανόνες ΕΕ 561/2006 στην κατάσταση του οδηγού: διαλείμματα 45 λεπτών το πολύ ανά 4 ω 30 λ, ημερήσιες αναπαύσεις πριν από το όριο των 9 ω / 10 ω, καθεμία τοποθετημένη σε πραγματικό χώρο στάθμευσης πριν συμπληρωθεί το όριο, αναμονή για απαγορεύσεις Σαββατοκύριακου και αργιών, αναμονές στα σύνορα στη χρονογραμμή, μονό ή διπλό πλήρωμα — και η εκτιμώμενη άφιξη τα περιλαμβάνει όλα. Το πλάνο ανάπαυσης είναι βοήθημα προγραμματισμού, όχι καταγραφή ταχογράφου.
GET https://nakordoni.eu/api/v2/data/truck-route
— κλάση ποσόστωσης: route
| Παράμετρος | Περιγραφή |
|---|---|
from | Αφετηρία ως lat,lon (υποχρεωτικό εκτός αν δοθεί from_city), π.χ. 52.2297,21.0122 |
to | Προορισμός ως lat,lon (υποχρεωτικό εκτός αν δοθεί to_city) |
from_city | Όνομα πόλης αφετηρίας αντί για συντεταγμένες (προσθέστε from_country για ακρίβεια) |
from_country | Χώρα ISO 3166-1 alpha-2 του from_city, π.χ. PL |
to_city | Όνομα πόλης προορισμού αντί για συντεταγμένες |
to_country | Χώρα ISO 3166-1 alpha-2 του to_city |
via | Έως 5 ενδιάμεσα σημεία ως lat,lon|lat,lon |
height | Ύψος οχήματος σε μέτρα (1.0–5.0) |
weight | Μικτό βάρος οχήματος σε τόνους (1–60)· καθορίζει τους περιορισμούς και τις απαγορεύσεις βάρους |
length | Μήκος οχήματος σε μέτρα (2–30) |
width | Πλάτος οχήματος σε μέτρα (1.0–3.5) |
axle_load | Φορτίο άξονα σε τόνους (1–20) |
axles | Αριθμός αξόνων, ελκυστήρας συν ρυμουλκούμενο (2–12)· χρησιμοποιείται για τη διαδρομολόγηση και για τις κατηγορίες διοδίων (προεπιλογή για διόδια: 5 από 18 t, 3 από 12 t, αλλιώς 2) |
trailers | Αριθμός ρυμουλκούμενων (0–3)· επιστρέφεται στην απάντηση, χωρίς επίδραση στη διαδρομή προς το παρόν |
hazmat | Επικίνδυνα εμπορεύματα: 0 (προεπιλογή), 1 = φορτίο ADR χωρίς δηλωμένη κατηγορία, ή λίστα κατηγοριών ADR 1–9 χωρισμένη με κόμμα ή/και explosive, gas, flammable, flammable_solid, oxidizing, poison, radioactive, corrosive, harmful_to_water |
adr_tunnel | Κωδικός περιορισμού σηράγγων ADR του φορτίου: B, C, D ή E. Αποφεύγονται οι σήραγγες των οποίων η κατηγορία το απαγορεύει (συνεπάγεται hazmat) |
avoid | Λίστα χωρισμένη με κόμμα από tolls, ferries, motorways, borders, tunnels, unpaved, low_emission_zones |
emission_class | Κατηγορία εκπομπών οχήματος euro0 … euro6· χρησιμοποιείται για ελέγχους ζωνών χαμηλών εκπομπών και σημειώσεις διοδίων (τα διόδια τιμολογούνται με τιμές Euro VI) |
alternatives | Αριθμός εναλλακτικών διαδρομών, 0–2 (προεπιλογή 0· μόνο για διαδρομές χωρίς σημεία via) |
geometry | polyline5 (προεπιλογή), polyline6 ή geojson |
arrive_at | Επιθυμητή άφιξη κατά RFC 3339· η αναχώρηση προγραμματίζεται αντίστροφα, συμπεριλαμβανομένων διαλειμμάτων και αναπαύσεων (αντί για depart_at) |
route_type | fastest (προεπιλογή) ή eco |
include | Λίστα χωρισμένη με κόμμα από fuel, parking, weigh, rest (προεπιλογή: και τα τέσσερα) |
corridor_km | Μέγιστη απόσταση από τη διαδρομή για πρατήρια, στάθμευση και σταθμούς ζύγισης, 0.2–5 km (προεπιλογή 2) |
fuel | Τύποι καυσίμου για τιμολόγηση, λίστα χωρισμένη με κόμμα (προεπιλογή diesel) |
depart_at | Αναχώρηση κατά ISO 8601 με ζώνη ώρας, έως 14 ημέρες μπροστά (προεπιλογή: τώρα) |
aliases | Αποδεκτά για εύκολη μετάβαση: depart → depart_at, departAt, arriveAt, vehicleHeight, vehicleWidth, vehicleLength, vehicleWeight (kg ή t), vehicleAxleWeight / axleWeight → axle_load, vehicleNumberOfAxles / axleCount → axles, vehicleTrailers → trailers, vehicleAdrTunnelRestrictionCode → adr_tunnel, vehicleEmissionClass → emission_class, maxAlternatives → alternatives, waypoints → via |
crew | 1 (προεπιλογή) ή 2 οδηγοί — το διπλό πλήρωμα χρησιμοποιεί το παράθυρο ημερήσιας ανάπαυσης 30 ωρών και αναπαύσεις 9 ω |
traffic | forecast (προεπιλογή), live ή off. forecast = μαθημένη επαναλαμβανόμενη συμφόρηση + ζωντανή κίνηση κοντά στην αναχώρηση + οδικά έργα, κλεισίματα και καιρός τη στιγμή της διέλευσης· live = τρέχουσα κίνηση χωρίς το μαθημένο μοτίβο· off = χωρίς επίπεδο κίνησης (χρόνος οδήγησης ελεύθερης ροής) |
driven_since_break_min | Κατάσταση οδηγού: λεπτά οδήγησης από το τελευταίο διάλειμμα 45 λεπτών (προεπιλογή 0) |
driven_today_min | Κατάσταση οδηγού: λεπτά οδήγησης από την τελευταία ημερήσια ανάπαυση (προεπιλογή 0) |
driven_week_min | Κατάσταση οδηγού: λεπτά οδήγησης αυτή την ημερολογιακή εβδομάδα (προεπιλογή 0) |
driven_last_week_min | Κατάσταση οδηγού: λεπτά οδήγησης την προηγούμενη εβδομάδα, για το όριο των 90 ω ανά δεκαπενθήμερο (προεπιλογή 0) |
reduced_daily_rests_used | Μειωμένες (9 ω) ημερήσιες αναπαύσεις που έχουν ήδη ληφθεί από την τελευταία εβδομαδιαία ανάπαυση, 0–3 (προεπιλογή 0) |
extended_days_used | Ημέρες οδήγησης 10 ωρών που έχουν ήδη χρησιμοποιηθεί αυτή την εβδομάδα, 0–2 (προεπιλογή 0) |
last_weekly_rest_end | Λήξη της τελευταίας εβδομαδιαίας ανάπαυσης κατά ISO 8601 (προεπιλογή: θεωρείται ακριβώς πριν την αναχώρηση) |
reduced_weekly_ok | 1 = επιτρέπεται προγραμματισμός μειωμένης (24 ω) εβδομαδιαίας ανάπαυσης (προεπιλογή 0 = κανονική 45 ω) |
lang | Κωδικός γλώσσας για ονόματα και μηνύματα (προεπιλογή en) |
Πεδία της απάντησης — μέσα στο αντικείμενο data του φακέλου απάντησης. Το [] δηλώνει λίστα, άρα το data.items[].name είναι το πεδίο name κάθε στοιχείου. Ένα πεδίο είναι null, απουσιάζει ή είναι κενή λίστα όταν δεν έχουμε τιμή — ποτέ κάτι εικονικό.
| Πεδίο | Περιγραφή |
|---|---|
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"
Ενημερώθηκε