API pentru planificarea rutei Online
Un plan din poartă în poartă pentru o călătorie transfrontalieră: ruta, punctele de trecere de pe ea cu coada în timp real sau prognoza pentru ora sosirii tale și opririle de odihnă, masă și alimentare pe care șoferul le face cu adevărat — pe o singură axă a timpului. O coadă lungă contează drept pauza deja scadentă, așa că așteptarea nu este numărată niciodată de două ori; autobuzele și camioanele primesc odihna obligatorie conform UE 561/2006, iar opririle de serviciu ale autobuzelor sunt calibrate pe peste 1000 de orare licențiate. Fiecare punct de trecere raportează și wait_basis: vehicle_lane când categoria vehiculului dvs. are propria coadă măsurată, car_lane când coada benzii pentru autoturisme este cel mai bun semnal disponibil.
GET https://nakordoni.eu/api/v2/data/route-plan
— clasă de cotă: heavy
| Parametru | Descriere |
|---|---|
origin_lat | Latitudinea punctului de plecare (obligatoriu) |
origin_lon | Longitudinea punctului de plecare (obligatoriu) |
dest_lat | Latitudinea destinației (obligatoriu) |
dest_lon | Longitudinea destinației (obligatoriu) |
vehicle | car (implicit), bus sau truck — stabilește atât profilul de rutare, cât și modelul opririlor |
depart | Ora plecării în format ISO-8601, cel mult cu 14 zile în avans (implicit: acum). Pe baza ei se calculează prognoza cozii pentru ora sosirii |
via | Puncte intermediare opționale, în formatul lat,lon;lat,lon (maximum 3) — de exemplu, pentru a trasa ruta printr-un alt punct de trecere a frontierei |
forecast | 1 (implicit) = prognozează coada pentru ora sosirii dumneavoastră la fiecare punct de trecere; 0 = folosește coada curentă |
stop_places | 1 = indică pentru fiecare oprire o zonă de odihnă / benzinărie reală (implicit 0) |
overnight | 1 = adaugă o oprire de noapte cu caracter de recomandare când condusul depășește 11 h (implicit 0) |
geometry | 1 = include geometria completă a rutei (implicit 0) |
alternatives | 1 (implicit) = include punctele de trecere alternative din apropiere, împreună cu cozile lor |
preference | recommended (implicit), fastest sau shortest |
lang | Codul limbii pentru denumirile punctelor de trecere (implicit en) |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
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"
Actualizat