API לתכנון מסלול Online
תוכנית מדלת לדלת לנסיעה חוצת גבול: המסלול, מעברי הגבול שעליו עם התור החי או תחזית לשעת ההגעה שלך, ועצירות המנוחה, האוכל והתדלוק שנהג באמת עושה — הכול על ציר זמן אחד. תור ארוך נחשב כהפסקה שממילא הגיע זמנה, כך שההמתנה לעולם אינה נספרת פעמיים; לאוטובוסים ולמשאיות חלה מנוחת החובה לפי EU 561/2006, ועצירות השירות של האוטובוסים מכוילות על יותר מ-1000 לוחות זמנים מורשים. כל מעבר גבול מחזיר גם wait_basis: vehicle_lane כאשר לקטגוריית הרכב שלך יש תור נמדד משלה, car_lane כאשר תור נתיב המכוניות הוא האות הטוב ביותר הזמין.
GET https://nakordoni.eu/api/v2/data/route-plan
— מחלקת מכסה: heavy
| פרמטר | תיאור |
|---|---|
origin_lat | קו הרוחב של נקודת המוצא (חובה) |
origin_lon | קו האורך של נקודת המוצא (חובה) |
dest_lat | קו הרוחב של היעד (חובה) |
dest_lon | קו האורך של היעד (חובה) |
vehicle | car (ברירת מחדל), bus או truck — קובע גם את פרופיל חישוב המסלול וגם את מודל העצירות |
depart | שעת יציאה בפורמט ISO-8601, עד 14 יום מראש (ברירת מחדל: עכשיו). על בסיסה נבנית תחזית התור לשעת ההגעה |
via | נקודות ביניים אופציונליות בפורמט lat,lon;lat,lon (עד 3) — למשל כדי להעביר את המסלול דרך מעבר גבול אחר |
forecast | 1 (ברירת מחדל) = חיזוי התור לשעת ההגעה שלך בכל מעבר גבול; 0 = שימוש בתור הנוכחי |
stop_places | 1 = לציין עבור כל עצירה אזור מנוחה / תחנת דלק ממשיים (ברירת מחדל 0) |
overnight | 1 = להוסיף עצירת לילה בגדר המלצה כאשר הנסיעה עולה על 11 שעות (ברירת מחדל 0) |
geometry | 1 = לכלול את הגאומטריה המלאה של המסלול (ברירת מחדל 0) |
alternatives | 1 (ברירת מחדל) = לכלול מעברי גבול חלופיים בקרבת מקום יחד עם התורים שלהם |
preference | recommended (ברירת מחדל), fastest או shortest |
lang | קוד שפה לשמות מעברי הגבול (ברירת מחדל en) |
שדות התשובה — בתוך אובייקט data שבמעטפת התשובה. [] מסמן רשימה, ולכן data.items[].name הוא שדה name של כל פריט. שדה יהיה null, ייעדר או יחזור כרשימה ריקה כשאין לנו ערך עבורו — לעולם לא ערך ממלא מקום.
| שדה | תיאור |
|---|---|
data.route | The drive itself: distance_km, drive_seconds, vehicle, toll_distance_km. |
data.borders[].ppid | A crossing on the route, with name, from, to and crossing_type. |
data.borders[].wait | Its live or arrival-time-forecast wait, with wait_basis — vehicle_lane when your vehicle class has its own measured queue, car_lane when the car queue is the best available signal. |
data.borders[].at_km | Where it falls on the route, with at_drive_seconds and distance_from_route_km. |
data.borders[].alternatives[] | Other crossings worth switching to: ppid, name, wait_minutes, queue_cars, detour_km. |
data.stops[].type | Break, meal or refuelling, with reason, at_km, at_drive_s, minutes, starts_at and ends_at. |
data.summary | The timeline totals: drive_seconds, stop_seconds, border_wait_seconds, total_seconds, arrival_at, stop_count, border_count and borders_absorbed_breaks — long waits that satisfied a due break instead of adding to it. |
data.model | Rules the plan was built on: vehicle, basis (driving-hygiene or EU 561/2006), break_after_drive_min, meal_after_drive_min, fuel_every_km. |
data.warnings[] | Things to tell the driver: code, ppid, name, status, message, suggested_alternative — e.g. a closed crossing on the route. |
curl "https://nakordoni.eu/api/v2/data/route-plan?origin_lat=50.4501&origin_lon=30.5234&dest_lat=52.2297&dest_lon=21.0122&vehicle=car&stop_places=1&lang=en" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
עודכן