Elenco comuni italia

Dati e open data
21

Ok grazie per l’impegno!

22

fatto!

Online comuni.alessiopellizzaro.it

API per ottenere le informazioni pubbliche dei 7900 comuni italiani

Note Base

  • API è Gratuita e cercherò di mantenerla tale, in caso di insostenibilità valuterò il da farsi
  • i dati sono quelli pubblicati online da ISTAT o Disponibili nei vari OpenData Dateset (incrociati)
  • per utilizzare le API è Obbligatorio registrarsi e ottenere il token( x 2 motivi, 1 - per riuscire a comunicare in caso di problematiche, 2- per non lasciare un Endpoint esposto alla rete senza protezioni)
  • il DB si aggiornerà 1 volta alla settimana (domenica) notte tempo

il Portale è stato fatto in qualche ora, quindi potrebbe ancora dei bug/Errori di testo nelle prossime settimane con più calma provvederò ai vari aggiornamenti

Come si Usa

Filtri Dati

  • Ogni Chiave dell’oggetto può essere usato come filtro nei QueryParams in richiesta
  • Nel caso non si inseriscano valori di filtro verrà restituito l’intero elenco da 7900 records non paginato (per ora)
  • Solo nel caso di Richieste per filtro con “Denominazione” verranno restituiti anche i dati “Elettorali del comune”

Come Ottenere il Token di Richiesta

  1. Vai Sul Sito è Clicca su “Registrati”
  2. Inserisci una tua Email e una Password a tua scelta
  3. vai Alla Pagina #Api
  4. Clicca su “Add New”

dopo ciò apparirà nella tabella sottostante un nuovo record e cliccando nel punto apposito si copierà il token

ad oggi non c’è un limite al numero di token per ogni utente

Richiesta

essempio per ottenere i Dati del Comune “Montecchio Maggiore”

curl --location 'https://comuni.alessiopellizzaro.it/api/v1/comuni?Denominazione=Montecchio%20Maggiore' \
--header 'Authorization: Bearer YOUR_TOKEN'

Risposta

{
    "success": true,
    "message": "Comuni ottenuti con successo.",
    "records": 1,
    "comuni": [
        {
            "CodiceRegione": 5,
            "CodicedellUnitaTerritorialeSovracomunale_Storico_1": 24,
            "ProgressivoDelComune": 61,
            "CodiceComuneFormatoAlfanumerico": "024061",
            "Denominazione": "Montecchio Maggiore",
            "DenominazioneIt": "Montecchio Maggiore",
            "DenominazioneOther": "",
            "CodiceRipartizioneGeografica": "2",
            "RipartizioneGeografica": "Nord-est",
            "Regione": "Veneto",
            "DenominazioneDellUnitàTerritorialeSovracomunale": null,
            "TipologiaDiUnitàTerritorialeSovracomunale": null,
            "FlagComuneCapoluogoDiProvincia_CittàMetropolitana_libero": 0,
            "SiglaAutomobilistica": "VI",
            "CodiceComuneformatoNumerico": 24061,
            "CodiceComuneNumerico_2010_2016": 24061,
            "CodiceComuneNumerico_2006_2009": 24061,
            "CodiceComuneNumerico_1995_2005": 24061,
            "CodiceCatastaleDelComune": "F464",
            "CodiceElettorale": "1050900610",
            "CodiceBelfiore": "F464",
            "PrefissoTelefonico": "0444",
            "CodiceCAP": "36075",
            "NUTS1_2010": "ITH",
            "NUTS2_2010": "ITH3",
            "NUTS3_2010": "ITH32",
            "NUTS1_2021": "ITH",
            "NUTS2_2021": "ITH3",
            "NUTS3_2021": "ITH32",
            "updatedAt": "2023-12-09T21:25:58.000Z",
            "Elezionis": [
                {
                    "ISTAT_CODICE_COMUNE": "024061",
                    "CODICE_COMUNE": "0610",
                    "POPOLAZIONE_CENSITA": 23315,
                    "MAGGIORITARIO_PROPORZIONALE": "P",
                    "DESCRIZIONE_TEMPO_GESTIONE": "ORDINARIA",
                    "DATA_ELEZIONE": "26/05/2019",
                    "DATA_BALLOTTAGGIO": "",
                    "SIGLA_TITOLO_ACCADEMICO": "",
                    "COGNOME": "...",
                    "NOME": "....",
                    "SESSO": "M",
                    "LIVELLO_CARICA": 10,
                    "DESCRIZIONE_CARICA": "Sindaco",
                    "PARTITO_LISTA_COALIZIONE": "...",
                    "PROFESSIONE": "...."
                }

            ]
        }
    ]
}

Supporto

in caso di problematiche scrivetemi pure

23

Bel servizio, grazie.
ma invece del nome del comune non puoi inserire nella query API il codice istat del comune che è piu facile digitare ed è anche piu facile evitare errori di battitura?

tipo:
curl --location 'https://comuni.alessiopellizzaro.it/api/v1/comuni?ISTAT=908766
–header ‘Authorization: Bearer YOUR_TOKEN’

24

Ciao @sal21
Il campo è CodiceComuneFormatoAlfanumerico

Purtroppo avendo la fonte primaria L’istat viene chiamato così, nei prossimi giorni aggiorno con un alias

25

Ciao Alessio.
Ti ho mandato una email da:
Gss****@iol.it

1 Mi Piace
26

Funzione Appena pubblicata,

con questo aggiornamento si aggiunge il parametro che chiedi “ISTAT” e il parametro “Provincia”,

in oltre ogni volta che si ottiene un unico comuni si riceve ora anche la lista delle strade disponibile da openstreetmap,

essempio di richiesta

curl --location 'https://comuni.alessiopellizzaro.it/api/v1/comuni?ISTAT=023001' \
--header 'Authorization: Bearer YOUR_TOKEN'

esempio di body:

{
    "success": true,
    "message": "Comuni ottenuti con successo.",
    "records": 1,
    "comuni": [
        {
            "CodiceRegione": 5,
            "CodicedellUnitaTerritorialeSovracomunale_Storico_1": 23,
            "ProgressivoDelComune": 1,
            "CodiceComuneFormatoAlfanumerico": "023001",
            "Denominazione": "Affi",
            "DenominazioneIt": "Affi",
            "DenominazioneOther": "",
            "CodiceRipartizioneGeografica": "2",
            "RipartizioneGeografica": "Nord-est",
            "Regione": "Veneto",
            "DenominazioneDellUnitàTerritorialeSovracomunale": null,
            "TipologiaDiUnitàTerritorialeSovracomunale": null,
            "FlagComuneCapoluogoDiProvincia_CittàMetropolitana_libero": 0,
            "SiglaAutomobilistica": "VR",
            "CodiceComuneformatoNumerico": 23001,
            "CodiceComuneNumerico_2010_2016": 23001,
            "CodiceComuneNumerico_2006_2009": 23001,
            "CodiceComuneNumerico_1995_2005": 23001,
            "CodiceCatastaleDelComune": "A061",
            "CodiceElettorale": "1050890010",
            "CodiceBelfiore": "A061",
            "PrefissoTelefonico": "045",
            "CodiceCAP": "37010",
            "NUTS1_2010": "ITH",
            "NUTS2_2010": "ITH3",
            "NUTS3_2010": "ITH31",
            "NUTS1_2021": "ITH",
            "NUTS2_2021": "ITH3",
            "NUTS3_2021": "ITH31",
            "updatedAt": "2023-12-09T21:25:57.000Z",
            "streets": [
                "Autostrada del Brennero",
                "Località Caorsa",
                "Località Cocche",
                "Località Coletto",
                "Località Incaffi",
                "Superstrada Peschiera-Affi",
                "Svincolo Affi-L. Di Garda Dir. Brennero",
                "Svincolo Affi-L. Di Garda Sud",
                "Svincolo Affi-L. Di Garda Sud Dir. Brennero",
                "Svincolo Affi-L. Di Garda Sud Dir. Modena",
                "Val Sorda",
                "Via Adolfo Consolini",
                "Via Alessandro Volta",
                "Via Antonio Meucci",
                "Via Archimede",
                "Via Belvedere",
                "Via Belvedere Sopra Paerno",
                "Via Broiare",
                "Via Ca' Balotta",
                "Via Ca' del Bosco",
                "Via Ca' del Ri",
                "Via Ca' del Rì",
                "Via Campisana",
                "Via Carducci",
                "Via Casetta",
                "Via Castello",
                "Via Ceriel",
                "Via Chiesa",
                "Via Comboni",
                "Via Cortivi",
                "Via Costabella",
                "Via Coste",
                ...
            ]
        }
    ]
}

aperto ad altri suggerimenti

saluti

27

per l’ISTAT DI bologna, mi va in errore 504, timeout!

28

dovrei aver risolto


{
    "success": true,
    "message": "Comuni ottenuti con successo.",
    "records": 1,
    "comuni": [
        {
            "CodiceRegione": 8,
            "CodicedellUnitaTerritorialeSovracomunale_Storico_1": 237,
            "ProgressivoDelComune": 6,
            "CodiceComuneFormatoAlfanumerico": "037006",
            "Denominazione": "Bologna",
            "DenominazioneIt": "Bologna",
            "DenominazioneOther": "",
            "CodiceRipartizioneGeografica": "2",
            "RipartizioneGeografica": "Nord-est",
            "Regione": "Emilia-Romagna",
            "DenominazioneDellUnitàTerritorialeSovracomunale": null,
            "TipologiaDiUnitàTerritorialeSovracomunale": null,
            "FlagComuneCapoluogoDiProvincia_CittàMetropolitana_libero": 1,
            "SiglaAutomobilistica": "BO",
            "CodiceComuneformatoNumerico": 37006,
            "CodiceComuneNumerico_2010_2016": 37006,
            "CodiceComuneNumerico_2006_2009": 37006,
            "CodiceComuneNumerico_1995_2005": 37006,
            "CodiceCatastaleDelComune": "A944",
            "CodiceElettorale": "1080130060",
            "CodiceBelfiore": "A944",
            "PrefissoTelefonico": "051",
            "CodiceCAP": "40121",
            "NUTS1_2010": "ITH",
            "NUTS2_2010": "ITH5",
            "NUTS3_2010": "ITH55",
            "NUTS1_2021": "ITH",
            "NUTS2_2021": "ITH5",
            "NUTS3_2021": "ITH55",
            "updatedAt": "2024-01-24T18:59:57.000Z"
        }
    ]
}
29

OK GRAZIE.
ora sembra tutto ok

opssss

Va sempre in timeout 504
(con ISTAT di piccoli comune funziona!)

Quindi credo che sia un problema relativo alla numerosità delle strade, nell’output.

e poi sempre su ISTAT Bologna, mi escono molte strade con denominazione tedesca!

invece per l’istat di Montoro (AV) 064121 mi escono strade spagnole!

30

Ciao @sal21,

per il 504, ho appena aumentato le prestazione del server e il tempo di timeOut, la causa sembra essere le API che utilizzo per recuperare le strade che per alcuni comuni fattica, ma sto risolvendo (forse , ma devo ancora verificare se è possibile, converto il tutto alle google maps api e dovrebbe essere più preciso e veloce),

per la questione delle strade in altre lingue sto verificando, ci sono alcuni casi di omonimia perfetta tra città lontane che causa alcune sovraposizioni

31

Ok grazie sempre.
Sta diventando un bel servizio.

32

sto verificando alcuni codici ISTAT per esempio il codice 022002 Albiano in Trentino Alto Adige, con google maps mi da 27 strade, invece le rest api tua mi restituisce piu di 35.000 strade!
Questo è successo anche con altri codici ISTAT di piccoli comuni.
Questo non è un appunto ma solo un indicazione per eventuali correzioni.
Grazie sempre per tutto

33

Grazie a tutti delle Segnalazioni,
ci sto lavorando in queste “Notti” per sistemare i vari problemi, vi aggiorno appena pubblico l’aggiornamento online

34

Ciao @Salvatore_Imparato @sal21 @Sal_Sal
ho appena pubblicato l’aggiornamento che il risolve il problema dei piccoli comuni, il problema lingue e rende più veloce e stabile la risposta ,

rimango sempre aperto a nuovi suggerimenti,
grazie ancora delle segnalazioni!

35

Grande!
Ultimo sforzo…
Riesci a estrarre le coordinate (latitudine e longitudine) per ogni strada?
Sarebbe il top!
Grazie

36

Ciao a Tutti!,

in tanto un mini aggiornamento,

ho aggiunto il paramentro “format” in richiesta generica che se viene passato il valore “CSV” restituirà l’intero elenco in tale formato,

https://comuni.alessiopellizzaro.it/api/v1/comuni?format=CSV
37

Ciao a tutti,

grazie @APXc per il tuo contributo alla community.

è stato aggiornato da ISTAT il Vocabolario controllato dei comuni di italia sul catalogo schema.gov.it
è possibile accedere al vocabolario anche tramite API.

Saluti
Claudia

3 Mi Piace