Comuni, CAP e coordinate in JSON, SQL e SQLite, con un manifest che dice cosa è cambiato
Un'app, un sito o un servizio che chiede un comune a un utente ha bisogno di un elenco affidabile, nel formato in cui lo legge, e di un modo per sapere quando cambia. Qui ogni rilascio porta gli stessi dati in JSON, SQL e SQLite, con il codice ISTAT come chiave e un manifest con l'impronta di ogni file.
- Chi sviluppa app web e mobile
- Siti con form di indirizzo e autocompletamento
- API e servizi interni
- Team dati che caricano i comuni in un data warehouse
I campi che usi
Le colonne del pacchetto che servono a chi le legge da codice
Sono legate al codice ISTAT del comune, quindi si agganciano a qualunque anagrafica. JSON, SQL e SQLite sono in tutti i piani a pagamento; l'uso in un prodotto venduto richiede la licenza commerciale dei piani Pro e Full.
Comuni in JSON (json/comuni.json)
- istat
- La chiave numerica di ogni documento; istat_testo è la stessa a sei cifre, con gli zeri, per chi confronta stringhe.
- cap
- Nel JSON ogni comune porta i suoi CAP come array: niente join per un autocompletamento.
- confinanti
- I codici dei comuni confinanti, già nel documento, per suggerire i comuni vicini.
- provincia_istat
- Provincia e regione risolte dentro il documento, con sigla e nome.
Coordinate e territorio (data_comuni_geo, data_comuni_frazioni)
- latitudine
- Latitudine e longitudine del municipio in gradi decimali, per una mappa o una ricerca per distanza.
- altitudine_slm
- Altitudine e superficie, per ordinare o filtrare.
- nome
- Nei piani Pro e Full, le frazioni e località con coordinate e popolazione, per un autocompletamento più fine del comune.
Pacchetto e aggiornamenti (manifest.json, database/)
- sha256
- manifest.json elenca ogni file con la sua impronta SHA-256: un confronto dice quali file sono cambiati.
- schema.sql
- Schema e dati separati per MySQL e in dialetto ANSI, più database.sqlite pronto da aprire.
Fonti: ISTAT (codici, denominazioni, località); CAP e coordinate da fonti aperte citate nel pacchetto; Wikidata per i confinanti.
Cosa ci fai
Quattro lavori che partono da questi dati
Autocompletamento di comune e CAP
Il JSON dei comuni, con i CAP già dentro ogni documento, si carica in memoria o in un indice: un campo che suggerisce il comune e propone il CAP giusto, anche nelle città con più codici.
Un database locale pronto
database.sqlite si apre senza server e si spedisce con un'app; i dump SQL creano le tabelle con chiavi e relazioni in MySQL, MariaDB, PostgreSQL o SQL Server.
Mappa e ricerca per distanza
Le coordinate del municipio bastano per una mappa dei comuni o per trovare i comuni entro una distanza da un punto; nei piani Pro e Full anche le frazioni hanno le loro.
Aggiornare solo ciò che cambia
A ogni rilascio confronti manifest.json con quello precedente e ricarichi solo i file con un'impronta diversa; il registro degli aggiornamenti dice quali comuni sono stati toccati.
Anteprima
CAP dei comuni: un estratto dai dati reali
| Comune | Provincia | CAP |
|---|---|---|
| Abano Terme | PD | 35031 |
| Abbadia Cerreto | LO | 26834 |
| Abbadia Lariana | LC | 23821 |
| Abbadia San Salvatore | SI | 53021 |
| Abbasanta | OR | 09071 |
| Abbateggio | PE | 65020 |
Estratto a scopo illustrativo. Il pacchetto contiene l'elenco completo.
Domande
Quello che chi scrive codice chiede prima di comprare
- C'è un'API?
- No, e di proposito: ricevi i file e li servi tu, senza dipendere da un servizio esterno, senza limiti di chiamate e senza latenza. Il pacchetto è pensato per stare dentro la tua applicazione.
- Com'è fatto il JSON?
- Un documento per comune, con provincia e regione risolte, i CAP come array e i codici dei comuni confinanti; province e regioni in file separati. UTF-8, chiavi in italiano uguali ai nomi delle colonne SQL.
- Posso usare i dati in un prodotto che vendo?
- Con i piani Pro e Full sì: la licenza commerciale copre prodotti e servizi propri, purché i dati grezzi non siano scaricabili dagli utenti finali.
Provalo sul tuo caso prima di acquistarlo
La demo gratuita contiene i dati completi di una provincia, tutte le tabelle comprese, in Excel, CSV e JSON. Poi ogni rilascio ti aspetta nell'area clienti, con l'elenco di cosa è cambiato.