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 | from_city-ის ქვეყანა ISO 3166-1 alpha-2 ფორმატით, მაგ. PL |
to_city | დანიშნულების ქალაქის სახელი კოორდინატების ნაცვლად |
to_country | to_city-ის ქვეყანა ISO 3166-1 alpha-2 ფორმატით |
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); გამოიყენება მარშრუტიზაციისა და გადასახადის კლასებისთვის (გადასახადებისთვის ნაგულისხმევი: 18 t-დან 5, 12 t-დან 3, სხვა შემთხვევაში 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"
განახლდა