Truck Route API Online
Բեռնատարների երթուղավորման API՝ երթուղու երկայնքով վառելիքի լցակայաններով և բեռնատարների կայանատեղերով, ինչպես նաև կշռման կետերով և վարորդի հանգստի պլանով։ Ուղարկեք մեկնարկի և նպատակակետի կետերը և ձեր տրանսպորտային միջոցի տվյալները (բարձրություն, քաշ, երկարություն, լայնություն, առանցքային բեռ, վտանգավոր բեռ) և ստացեք ծանր բեռնատարների համար թույլատրելի երթուղի՝ իր հանդիպող սահմանափակումներով և թվագրված բեռնատարների արգելքներով, երթուղու վրա գտնվող սահմանային անցակետերը՝ իրական սպասման ժամանակով, գներով վառելիքի լցակայանները, բեռնատարների կայանատեղերը (պահպանվող լինելը, տարողությունը, հարմարությունները) և գծի միջանցքում գտնվող կշռման կետերը։ include=rest դեպքում վարորդի վիճակի նկատմամբ կիրառվում են EU 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); օգտագործվում է երթուղավորման և ճանապարհավճարի դասերի համար (ճանապարհավճարի կանխադրվածը՝ 5՝ 18 տ-ից, 3՝ 12 տ-ից, այլապես՝ 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 կմ (կանխադրված՝ 2) |
fuel | Գնահատվող վառելիքի տեսակները՝ ստորակետերով ցանկ (կանխադրված՝ diesel) |
depart_at | Մեկնումը՝ ISO 8601 ձևաչափով՝ ժամային գոտով, մինչև 14 օր առաջ (կանխադրված՝ հիմա) |
aliases | Ընդունվում է հեշտ անցման համար՝ depart → depart_at, departAt, arriveAt, vehicleHeight, vehicleWidth, vehicleLength, vehicleWeight (կգ կամ տ), 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"
Թարմացվել է