Documentazione tecnica
Come preparare il file, cosa restituisce il sistema e quali errori sono stabili. Precisione prima di tutto.
Formato CSV
Il caricamento automatico accetta solo CSV tabellare con intestazioni chiare. XLSX, XLS e PDF non sono formati automatici in questa build. Le coordinate reali sono la forma più affidabile; gli indirizzi completi sono processabili via geocoding quando il dato è sufficiente.
name,lat,lon,stop_type Deposito,42.5636,12.6427,depot_start Cliente 1,42.5700,12.6500,customer Cliente 2,42.5600,12.6300,customer Deposito Ritorno,42.5636,12.6427,depot_end
Colonne supportate
| Colonna | Obbligatoria | Descrizione |
|---|---|---|
| name | sì | Nome dello stop / cliente |
| lat, lon | consigliata | Coordinate reali: la qualità migliore |
| stop_type | no | depot_start, customer, depot_end |
| tw_start, tw_end | no | Finestre orarie (audit / bounded) |
| demand | no | Domanda / carico per capacità |
| vehicle_id | no | Raggruppamento flotta |
Regola deposito
Se il file contiene depot_start e depot_end, il deposito resta primo e il rientro ultimo: vengono ricalcolati solo gli stop cliente intermedi. Se il deposito non è indicato, il sistema tratta il primo stop coerente come punto di partenza secondo le regole di normalizzazione.
Da indirizzi
Se hai solo indirizzi, usa lo strumento dedicato: normalizza e geocodifica dove possibile, marcando le righe dubbie per revisione mirata.
cliente,indirizzo,civico,comune,cap,provincia Cliente Roma,Via Roma,12,Roma,00100,RM
Campi del report
L'output è un confronto, non una promessa. Il record include almeno:
| Campo | Significato |
|---|---|
| km_attuali / km_rielaborati | Distanza prima e dopo |
| delta_km / delta_pct | Margine tecnico rilevato |
| provider | OSRM / HERE / fallback dichiarato |
| seed | Riproducibilità del calcolo |
| validation_status | Esito della validazione indipendente |
| warnings | Vincoli non applicati, dati mancanti |
Codici di errore
I codici di fallimento sono stabili: nessun errore restituisce un giro "finto".
| Codice | Quando |
|---|---|
| UNSUPPORTED_INPUT | Vincolo non supportato dichiarato nei dati |
| INVALID_MATRIX | Matrice incompleta o valori non finiti |
| MATRIX_TOO_LARGE | Oltre il limite di nodi supportato |
| DUPLICATE_JOB / MISSING_JOB | Stop duplicati o mancanti |
| VALIDATION_FAILURE | Il risultato non supera la validazione |
Limiti dichiarati
Nessuna garanzia di precisione assoluta o al numero civico nel geocoding; nessun ottimo globale matematico dichiarato salvo futura certificazione exact separata; i vincoli avanzati sono applicati o segnalati in base ai dati. Per approfondire il metodo, vedi Il metodo.