Italian Cities v2.0.0

Italian Cities v2.0.0 — clean-room prerelease

This prerelease replaces the legacy-derived canonical dataset with a
reproducible build from:

• the complete ISTAT municipality snapshot dated 2026-02-21;
• GeoNames Postal Codes IT dated 2026-07-30.

Both sources are attributed under CC BY 4.0.

Important warning

GeoNames is not Poste Italiane. Postal codes and coordinates are non-official,
provided without warranty, and must not be used as certified postal data.
GeoNames coordinates may be estimated algorithmically; the original
accuracy field is preserved.

structural_quality is passed, while
operational_data_readiness is experimental_non_official.

Candidate statistics

• 7,894 ISTAT municipalities;
• 18,415 GeoNames source records;
• 18,811 postal-code relations;
• 8,095 exact, unambiguous GeoNames record matches;
• 0 ambiguous source-record matches in this snapshot;
• 10,320 unmatched GeoNames source records, represented by 10,270 localities;
• 396 municipalities without a GeoNames postal-code match.

Breaking schema changes

Schema 3.0.0 separates municipalities, localities and many-to-many postal
relations. It adds source record IDs, reference dates, reconciliation method,
confidence and coordinate accuracy. Legacy UUID and legacy-derived quality
fields are removed from current outputs.

Legacy

Legacy artifacts remain unchanged under legacy/ and do not contribute to
the v2 canonical digest, outputs, release bundle or Pages data. The bounded
comparison report is investigative and does not prove the legacy source.

Assets

The prepared bundle contains:

• municipalities.csv
• localities.csv
• postal_codes.csv
• italian_locations.csv
• italian_locations.json
• italian_locations.xlsx
• italian_locations.sqlite
• italian_locations.sql
• SHA256SUMS

Published after explicit maintainer approval.

Italian Cities v1.1.0

Italian Cities v1.1.0 — pre-release

Questa versione rende espliciti limiti che in v1.0.0 non erano rappresentati
nello schema.

Importante:

• non è un database postale ufficiale;
• i CAP derivano dal dataset legacy e non sono verificati contro una fonte
  postale autorizzata;
• nessuna coordinata legacy è dichiarata verificata;
• provenienza e diritti upstream del dataset legacy restano incompleti;
• la release è quindi una pre-release, non raccomandata come unica fonte
  per spedizioni, compliance, emergenze o decisioni amministrative.

Cambi principali

• schema 2.1.0;
• stati di affidabilità per CAP e coordinate;
• provenienza per record con source_ids;
• nomi provincia normalizzati sullo snapshot ISTAT, mantenendo il valore
  originario;
• diff verificabile rispetto alla baseline v1.0.0;
• validatori separati per schema, territorio, coordinate, provenienza e
  formati;
• Ruff, type checking, coverage e compatibilità Python 3.11–3.13;
• CodeQL per Python e JavaScript;
• build release a privilegi di sola lettura, pubblicazione isolata e
  attestazioni di provenienza degli asset;
• Pages con filtri condivisibili, confini regionali ISTAT 2026, download della
  release corrente e tabella di copertura accessibile;
• roadmap pubblica e prime attività good first issue.

Ogni asset è generato da data/italian_locations.csv e coperto da
SHA256SUMS. Consultare README.md, DATA_SOURCES.md, DATA_LICENSE.md e
NOTICE.md prima del riuso.

Italian Cities v1.0.0 — historical baseline

Italian Cities v1.0.0

Baseline storica / pre-release. Non è un database postale ufficiale.
CAP e coordinate legacy non sono verificati per l'uso operativo. Provenienza
e diritti upstream di parte del legacy restano irrisolti.

Prima distribuzione riproducibile dei dataset e dei formati derivati,
conservata per compatibilità e confronto.

Contenuto

• 7.186 comuni riconosciuti tramite snapshot ISTAT del 21 febbraio 2026;
• 7.294 località postali ancora non classificate;
• 14.480 associazioni luogo–CAP;
• 12.388 record con coordinate disponibili o corrette;
• 2.092 record senza coordinate.

Gli asset CSV, JSON, XLSX, SQLite e SQL rappresentano gli stessi record.
SHA256SUMS permette di verificarne l'integrità.

Avviso su accuratezza, fonti e licenze

I CAP generici delle città multi-CAP non sono adatti a indirizzare spedizioni.
La presenza di una coordinata non ne certifica l'accuratezza.

I codici e la classificazione comunale ISTAT provengono dallo snapshot
dichiarato nel repository e richiedono attribuzione CC BY 4.0.

La provenienza completa dei valori legacy originari, incluse molte coordinate,
non è dimostrata dai materiali storici disponibili. Il file LICENSE contiene
CC0 1.0, ma tale rinuncia opera soltanto sui diritti posseduti dall'autore che
la applica e non dimostra la titolarità su dati eventualmente importati.

La release è fornita “as is” e resta classificata come pre-release. Prima di
riutilizzare o redistribuire i dati, leggere la documentazione corrente:

• DATA_SOURCES.md;
• DATA_LICENSE.md;
• NOTICE.md.

Verifica

shasum -a 256 -c SHA256SUMS

Import SQL con SQLite:

sqlite3 italian_locations-from-sql.sqlite < italian_locations.sql