API σχεδιασμού διαδρομής Online
Ένα σχέδιο πόρτα-πόρτα για ταξίδι με συνοριακή διέλευση: η διαδρομή, τα σημεία διέλευσης πάνω της με ζωντανή ουρά ή πρόβλεψη για την ώρα άφιξής σας και οι στάσεις ξεκούρασης, φαγητού και ανεφοδιασμού που κάνει πραγματικά ο οδηγός — σε ένα ενιαίο χρονοδιάγραμμα. Μια μεγάλη ουρά μετράει ως το διάλειμμα που ούτως ή άλλως οφειλόταν, οπότε η αναμονή δεν μετριέται ποτέ δύο φορές· τα λεωφορεία και τα φορτηγά έχουν την υποχρεωτική ανάπαυση ΕΕ 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"
Ενημερώθηκε