API di pianificazione del percorso Online
Un piano porta a porta per un viaggio di frontiera: il percorso, i valichi che vi si trovano con la coda in tempo reale o una previsione per l'ora del tuo arrivo e le soste per riposo, pasto e rifornimento che un conducente fa davvero — su un'unica linea temporale. Una coda lunga vale come la pausa già dovuta, quindi l'attesa non viene mai conteggiata due volte; autobus e camion hanno il riposo obbligatorio UE 561/2006 e le soste di servizio degli autobus sono calibrate su oltre 1000 orari autorizzati. Ogni valico riporta anche wait_basis: vehicle_lane quando la tua categoria di veicolo ha una coda misurata dedicata, car_lane quando la coda della corsia auto è il miglior segnale disponibile.
GET https://nakordoni.eu/api/v2/data/route-plan
— classe di quota: heavy
| Parametro | Descrizione |
|---|---|
origin_lat | Latitudine del punto di partenza (obbligatorio) |
origin_lon | Longitudine del punto di partenza (obbligatorio) |
dest_lat | Latitudine della destinazione (obbligatorio) |
dest_lon | Longitudine della destinazione (obbligatorio) |
vehicle | car (predefinito), bus o truck — determina sia il profilo di calcolo del percorso sia il modello delle soste |
depart | Orario di partenza in formato ISO-8601, fino a 14 giorni in anticipo (predefinito: adesso). È la base della previsione della coda all'ora di arrivo |
via | Punti intermedi facoltativi nel formato lat,lon;lat,lon (massimo 3) — ad esempio per far passare il percorso da un altro valico di frontiera |
forecast | 1 (predefinito) = prevedere la coda per il tuo orario di arrivo a ciascun valico; 0 = usare la coda attuale |
stop_places | 1 = indicare per ogni sosta una vera area di servizio / stazione di rifornimento (predefinito 0) |
overnight | 1 = aggiungere una sosta notturna a titolo indicativo quando la guida supera le 11 h (predefinito 0) |
geometry | 1 = includere la geometria completa del percorso (predefinito 0) |
alternatives | 1 (predefinito) = includere i valichi alternativi vicini con le relative code |
preference | recommended (predefinito), fastest o shortest |
lang | Codice lingua per i nomi dei valichi (predefinito en) |
Campi della risposta — all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.
| Campo | Descrizione |
|---|---|
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"
Aggiornato