L'11 settembre 2026 un cliente che usa le nostre API in ambito proptech ci ha scritto una segnalazione asciutta: cercando "Via privata Gorizia, San Giuliano Milanese" riceveva cinque risultati quasi identici, tutti civico 1, con coordinate leggermente diverse. Gli era successo anche con Via Trieste e Via Fratelli Rosselli, stesso comune. Chi cerca un indirizzo si aspetta un punto, non un ventaglio. Avevamo un bug, e la sua origine era più profonda di quanto sembrasse.
La prima scoperta: sei accessi per un civico
La tabella degli indirizzi conteneva sei righe per Via Privata Gorizia 1, tutte legittime secondo la fonte, con punti distanti uno o due metri l'uno dall'altro. La causa sta nella struttura stessa dell'ANNCSU, l'Archivio Nazionale dei Numeri Civici e delle Strade Urbane gestito da ISTAT e Agenzia delle Entrate. L'archivio registra una riga per ogni accesso esterno: un civico con più ingressi, o rilevato più volte, genera più punti. Il geocoder li restituiva tutti.
Il fenomeno è nazionale e va ben oltre un comune. Nella nostra base contavamo 2.450.281 gruppi di comune, via e civico con righe ripetute, per un totale di 5.021.442 righe in eccesso, il 18,3% della tabella. A San Giuliano Milanese la quota saliva al 61%: 2.052 gruppi duplicati e 6.073 righe extra su 9.966.
La seconda scoperta: un comune ripetuto quattro volte
Durante i test è emerso un secondo problema, indipendente dal primo. La ricerca di "Via Trieste 29" senza indicare la città restituiva quattro volte lo stesso punto con quattro nomi diversi: Sovizzo, Gambugliano, Vighizzolo d'Este. La tabella dei comuni conteneva quattro righe per il codice M436, il codice della fusione del 2024 in provincia di Vicenza, e tre di quelle righe avevano il codice sbagliato. Ogni join sul codice del comune moltiplicava i risultati.
Il terzo dettaglio: la virgola fantasma
Un terzo difetto, più piccolo ma visibile: la località vuota produceva indirizzi come "Via Privata Gorizia 1, , Milano". Una stringa vuota non viene saltata dalla concatenazione, a differenza di un valore nullo. Il fix è un controllo esplicito.
Il fix, in tre mosse
Prima mossa: un solo risultato per ogni combinazione di comune, via, civico ed esponente. Tra gli accessi dello stesso civico scegliamo il punto con il metodo di rilevazione migliore, secondo la scala ufficiale dell'archivio (rilevo strumentale sotto i 5 metri prima dell'interpolazione), e a parità di metodo il punto più stabile.
Seconda mossa: pulizia dei codici duplicati nella tabella comuni, con un indice univoco che impedisce al problema di ripresentarsi.
Terza mossa: gestione corretta della località vuota nella formattazione dell'indirizzo.
Dopo il fix, Via Privata Gorizia a San Giuliano Milanese restituisce 13 risultati univoci, uno per civico (1, 2, 2/A, 2/B, 2/C, 2/D, 3, 4, 4/A, 4/B, 4/C, 5, 7), ciascuno con il suo punto. Via Trieste 29 esiste una volta sola, a Sovizzo. Il cliente ha riaperto il suo progetto senza ventagli.
Perché questo caso è una lezione per chi costruisce software proptech
L'ANNCSU è la fonte ufficiale dei civici italiani, e chi lavora con gli indirizzi non può ignorarla. Ma usarla bene richiede di conoscerne la struttura: gli accessi multipli, la scala dei metodi di rilevazione, le fusioni di comuni che cambiano i codici. La qualità del geocoding sta nella fonte, e soprattutto nel modo in cui la si interpreta.
Per questo pubblichiamo il caso: quando un cliente segnala un problema, la risposta è il fix accompagnato dalla spiegazione di cosa c'era sotto, con i numeri. La nostra API di geocoding è costruita sopra questi controlli, e i dati aggiornati sono visibili sulla mappa catastale. Se il tuo software deve gestire indirizzi italiani, i servizi di sviluppo software di Zornade includono questa esperienza. Per capire come funziona il geocoding in Italia, parti dalla guida dedicata.
Domande frequenti
Perché un civico ha più coordinate nell'ANNCSU?
L'archivio registra una riga per accesso esterno. Un civico con più ingressi, o rilevato più volte, genera più punti anche molto vicini tra loro. Spetta al geocoder scegliere un punto rappresentativo, altrimenti la ricerca restituisce duplicati.
Le coordinate ANNCSU sono sempre precise?
No. Il campo METODO racconta la qualità: il rilevo strumentale sotto i 5 metri è il riferimento migliore, la derivazione indiretta può sbagliare anche di chilometri. Per questo scegliamo il punto con il metodo migliore e validiamo gli outlier contro il baricentro della via.
Come posso provare il geocoding corretto?
Con la nostra API di geocoding: token gratuito, un solo punto per civico e metodo di rilevazione già risolto a monte.
Ultimo aggiornamento: settembre 2026, Redazione Zornade
Foto di copertina: Tima Miroshnichenko su Pexels