Ok grazie per l’impegno!
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
- Vai Sul Sito è Clicca su “Registrati”
- Inserisci una tua Email e una Password a tua scelta
- vai Alla Pagina #Api
- 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
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’
Ciao @sal21
Il campo è CodiceComuneFormatoAlfanumerico
Purtroppo avendo la fonte primaria L’istat viene chiamato così, nei prossimi giorni aggiorno con un alias
Ciao Alessio.
Ti ho mandato una email da:
Gss****@iol.it
1 Mi Piace
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
per l’ISTAT DI bologna, mi va in errore 504, timeout!
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"
}
]
}
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!
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
Ok grazie sempre.
Sta diventando un bel servizio.
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
Grazie a tutti delle Segnalazioni,
ci sto lavorando in queste “Notti” per sistemare i vari problemi, vi aggiorno appena pubblico l’aggiornamento online
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!
Grande!
Ultimo sforzo…
Riesci a estrarre le coordinate (latitudine e longitudine) per ogni strada?
Sarebbe il top!
Grazie
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
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
Anni e anni fa avevo partecipato ad una discussione qui sul forum per un problema a lavoro, e sembra che il discorso sia ancora sempre aperto. Sarei curioso di sapere i diversi casi d’uso. Ad esempio a noi serviva la lista dei comuni aggiornati per questioni di anagrafe e fatturazione. Ad altri potrebbero servire i CAP per le spedizioni, o ancora i codici catastali per i codici fiscali.
Avevo pensato e provato anche io a creare un servizio “serio” da condividere. Avendo però qualche esempio potrei considerare alcune cose a cui non avevo pensato.
Il database dei comuni è semplice da trovare, anche aggiornato. Le indicazioni geografiche un po’ meno, ma avevo giocato anche con gli shapefile a suo tempo.
Ciao a tutti,
oggi ho aggiornato il servizio e riesco a mantenerlo ancora online ,
per chi ha bisogno il servizio rimane a disposizione, anche se come dice @enrichman la parte difficile è coprire tutte le necessità,
lo scopo del servizio è da fare come “aggregatore delle informazioni” cosi da trovarle in unico posto facile da usare,
per chi vuole suggerire e valutare il portale lascio qui il form
grazie a tutti!
1 Mi Piace
Ciao a tutti,
rapido aggiornamento,
oggi ho aggiunto come da scelte espresse nel sondaggio sopra due nuovi elementi:
- ora sono state aggiunte per quasi tutti i comuni le proprie coordinate geografiche
- Aggiunta una Estrazione Apposita che espone i comuni Capoluogo di Provincia
per info vedere Documentazione : API Comuni By Alessio Pellizzaro
se avete altri suggerimenti il sondaggio resta valido!
Grazie a tutti!
1 Mi Piace