Accesso ai dati tramite servizi web
Per favorire l'accesso e l'interoperabilità dei dati, il Database Fotografico Macrosismico (DFM) mette a disposizione un servizio di tipo RESTful che consente di interrogare e scaricare in modo programmatico le informazioni relative alle fotografie archiviate.
Questo servizio è pensato per ricercatori, sviluppatori e specialisti del settore che necessitano di integrare i dati del DFM all'interno dei propri sistemi, applicativi (es. GIS) o flussi di analisi.
Endpoint del servizio
L'accesso al servizio avviene tramite una richiesta HTTP GET all'endpoint principale:
https://dfm.ingv.it/services/query
La richiesta può essere personalizzata attraverso una serie di parametri per filtrare i risultati in base a criteri geografici, temporali o sismologici.
Parametri di ricerca
È possibile combinare i seguenti parametri per affinare la ricerca.
Filtri geografici
È possibile cercare fotografie individuando i terremoti a cui sono associate, delimitando l’area di interesse tramite una "bounding box", ossia un rettangolo che racchiude gli epicentri entro cui effettuare la ricerca.
- minlatitude, maxlatitude, minlongitude, maxlongitude
In alternativa, è possibile individuare i terremoti associati alle fotografie tramite una ricerca radiale, che consente di selezionare gli eventi sismici compresi in un’area circolare definita da un punto centrale e da un raggio espresso in chilometri.
- latitude: Latitudine del centroide, espresso come grado sessadecimale, usare il punto per separare i decimali.
- longitude: Longitudine del centroide, espresso come grado sessadecimale, usare il punto per separare i decimali.
- radius: Raggio in chilometri dal centroide, usare il punto per separare i decimali.
Filtri temporali
Per cercare i terremoti a cui sono associate le fotografie all'interno di un intervallo di tempo:- starttime: Data di inizio, formato AAAA-MM-GG (es. 2000-08-31).
- endtime: Data di fine, formato AAAA-MM-GG.
Filtri sismologici
E' possibile cercare le fotografie associate a uno specifico terremoto a partire dall'identificativo del terremoto assegnato da una di queste due infrastrutture dell'INGV:
- eventid_asmi: ID univoco dell'evento assegnato dall'Archivio Sorico Macrosismico Italiano (ASMI).
- eventid_ont: ID univoco dell'evento assegnato dall'Osservatorio Nazionale Terremoti (ONT).
E' possibile cercare terremoti a cui sono associate fotografie filtrando per la magnitudo:
- minmagnitude: magnitudo minima dell'evento sismico associato.
- maxmagnitude: magnitudo massima.
Formato dell'output
Il servizio restituisce i dati in formato GeoJSON, uno standard aperto basato su JSON per la rappresentazione di dati geografici. Questo formato è facilmente integrabile in software GIS, librerie di mappatura web (come Leaflet o OpenLayers) e strumenti di analisi dati.
La struttura della risposta è una "FeatureCollection" GeoJSON, dove ogni "Feature" rappresenta una singola fotografia e contiene:
- una geometria di tipo Point con le coordinate geografiche del luogo fotografato.
- un insieme di proprietà che descrivono in dettaglio:
- Dati del terremoto: data, area epicentrale, magnitudo, coordinate epicentrali.
- Dati del luogo: comune, provincia, regione, coordinate.
- Dati della fotografia: ID della foto, URL per visualizzare l'immagine originale, descrizione della tipologia costruttiva e del livello di danno osservato (secondo la scala EMS-98).
Esempio di Proprietà di un elemento GeoJSON
"properties": {
"id_ont": "8669321",
"id_asmi": "20161026_1918_001",
"parameters_source": "CPTI15",
"earthquake_date": "2016-10-26 19:18:07",
"epicentral_area": "Valnerina",
"epicentral_latitude": "42.904",
"epicentral_longitude": "13.090",
"magnitude": "6.07",
"place_country": "Italy",
"place_region": "Umbria",
"place_province": "Perugia",
"place_province_code": "PG",
"place_municipality": "Norcia",
"place_id": "IT_49265",
"place_name": "Savelli",
"place_lat": "42.726",
"place_lon": "13.127",
"typology": "Muratura",
"element_description": "Generico B",
"damage_degree": "1",
"damage_description": "Crepe capillari",
"photo_album_id": "1629",
"photo_id": "1629",
"photo_author": "Archivio DFM-INGV",
"photo_license": "CC BY 4.0",
"photo_url": "https:\/\/dfm.ingv.it\/upload_new\/original\/1629-photo.jpg"
}
Esempi di utilizzo
Ricerca di tutte le foto del terremoto dell'Irpinia del 1980:
https://dfm.ingv.it/services/query?eventid_asmi=19801123_1834_000
Ricerca di foto in un'area geografica (Lunigiana) per terremoti con magnitudo superiore a 5.0:
Citazione
L'utilizzo dei dati ottenuti tramite questo servizio è libero. Si prega gli utenti di indicare la seguente citazione bibliografica del Database Fotografico Macrosismico in ogni prodotto o pubblicazione derivata
QUEST, Quick Earthquake Survey Team (2022). Database Macrosismico Fotografico (DFM). Istituto Nazionale di Geofisica e Vulcanologia (INGV). https://doi.org/10.13127/dfm