Il portale opendata del Comune di Firenze è gestito e manutenuto dalla EQ Risorse dati, Open data, SIT del Servizio Sviluppo Infrastrutture Tecnologiche della Direzione Sistemi Informativi e mette a disposizione degli utenti una moltitudine variegata di dataset disponibili anche tramite API CKAN e CSW. Tali API possono essere utilizzate attraverso delle richieste HTTP che forniscono i risultati formattati in JSON.
Sulle pagine di navigazione di ogni dataset, è pubblicata una tab delle varie API: RDF/XML, API Formato JSON-LD, metadato RNDT, metadato DCAT, metadato DCAT-AP_IT. I formati scaricabili delle risorse sono sostanzialmente CSV, KMZ, SHAPE.
RDF
Per il catalogo completo delle risorse RDF: l'endpoint è raggiungibile alla URL:
https://data.comune.fi.it/catalog.rdf
CKAN
Al momento le API di CKAN disponibili sono le classiche. Questo metodo permette l'interrogazione dell'indice di tutti i record, tramite la chiamata:
https://data.comune.fi.it/datastore/api/package_list
per poi fare interrogazioni puntuali ai singoli record con la chiamata
package_show?id={id-dataset}.
Il parametro id-dataset si ottiene dal file JSON di risposta alla chiamata package_list, ad esempio.
CSW
Per le API CSW: l'endpoint è raggiungibile alla URL:
https://data.comune.fi.it/services/csw
WMS
Per avere la lista completa dei dataset geografici esposti come WMS tiled il punto di accesso è la URL:
https://tms.comune.fi.it/tiles/service/wms?tiled=TRUE&request=GetCapabilities&srvice=WMS&version=1.3.0
WMTS
Per avere la medesima lista esposta come WMTS il punto di accesso è il seguente:
https://tms.comune.fi.it/tiles/service/wmts?request=GetCapabilities&service=WMTS&version=1.3.0
Date di riferimento dei metadati
Per quanto riguarda le date presenti nei metadati, la situazione potrebbe dare luogo a interpretazioni difformi nella chiave di lettura.
In generale, le date che riguardano i metadati (creazione e ultima modifica) sono coerenti con la creazione e con eventuali modifiche strutturali nel formato in cui è messo a disposizione il datasaet, o dei cambiamenti che ha subito.
Può capitare però che per quanto riguarda i dati geografici, queste date siano successive alla data di creazione/modifica del dato; ciò accade perché il catalogo interno utilizzato con il quale il catalogo del portale open data è "sincronizzato" varia queste date ad ogni singola "piccola" modifica. Abbiamo deciso di ritenere questa situazione tollerabile.