Жаңалық жіберу және NakBus паркі енді әріптес тақтасында
Әзірлеуші аккаунтыңызды сол электрондық поштамен Nakordoni Partners аккаунтына қосыңыз және онда жаңалықтар мен автобус паркіңізді (NakDriver / NakManager) команда рөлдерімен басқарыңыз. API кілттеріңіз, endpoint-тер мен қолданбалар өзгеріссіз қалады, ал мұндағы беттер жұмысын жалғастырады. Nakordoni Partners ашу
Truck Route API Online
Маршрут бойындағы жанармай бекеттері мен жүк көліктеріне арналған тұрақтарды, сондай-ақ таразы бекеттері мен жүргізушінің демалыс жоспарын қамтитын жүк көлігі маршруттарының API-і. Жөнелту және межелі пунктті, сондай-ақ көлігіңіздің параметрлерін (биіктігі, салмағы, ұзындығы, ені, осьтік жүктеме, қауіпті жүк) жіберіңіз — ауыр жүк көліктеріне рұқсат етілген маршрутты, жолда кездесетін шектеулер мен күні көрсетілген жүк көліктеріне тыйымдарды, маршруттағы шекара өткелдерін және олардағы нақты күту уақытын, бағасы көрсетілген жанармай бекеттерін, жүк көлігі тұрақтарын (күзет белгісі, сыйымдылығы, қызметтері) және сызық маңындағы дәліздегі таразы бекеттерін аласыз. include=rest болғанда EU 561/2006 ережелері жүргізушінің күйіне қолданылады: 4 сағ 30 мин аралықтан аспайтын 45 минуттық үзілістер, 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 т-дан бастап 5, 12 т-дан бастап 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 км (әдепкі 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"
Шолу, қамту және бағалар: Truck Route API
🔑 Бұл соңғы нүктені сынақ алаңында тікелей байқап көру үшін әзірлеуші ретінде кіріңіз — тәулігіне 50 тегін сынақ шақыруы. Кіру
Жаңартылды