שליחת חדשות וצי NakBus נמצאים כעת בלוח השותפים
חבר את חשבון המפתח שלך לחשבון Nakordoni Partners עם אותו האימייל ונהל שם חדשות ואת צי האוטובוסים שלך (NakDriver / NakManager), עם תפקידי צוות. מפתחות ה-API, נקודות הקצה והאפליקציות שלך נשארים ללא שינוי, והדפים כאן ממשיכים לפעול. פתח את Nakordoni Partners
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"
סקירה, כיסוי ומחירים: Truck Route API
🔑 התחברו כמפתחים כדי לנסות את נקודת הקצה הזו בשידור חי ב־Sandbox — 50 קריאות בדיקה חינם ביום. התחברות
עודכן