TRACCE

API e accesso ai dati

Torna alla mappa

Consulta e scarica i dati

Download con filtri opzionali

Anno, regione, provincia, città e tipologia sono tutti opzionali e si possono combinare. Lascia tutto vuoto per scaricare l'intero dataset. Le province e le città mantengono i nomi presenti nella fonte NUDM, non i nomi normalizzati del repertorio geografico.

URL generato: /api/v1/download

Parametri

ParametroDescrizioneEsempio
annoAnni presenti nel database: Caricamento...2025
regioneNome esatto della regioneLazio
provinciaNome esatto della provinciaRoma
cittaNome esatto della città nella fonteRoma
tipoCategoria della fonteomicidio
formatoSolo per download: CSV (default) oppure GeoJSONgeojson

I filtri testuali non distinguono maiuscole e minuscole e ignorano gli spazi esterni. Non sono ricerche parziali. I filtri si applicano insieme (AND). Usa la codifica URL per spazi, apostrofi e lettere accentate; il modulo sopra lo fa automaticamente.

Esempi pronti

Endpoint disponibili

GETRisultato
/api/v1/downloadFile CSV o GeoJSON scaricabile
/api/v1/casesGeoJSON dei casi con copertura geografica
/api/v1/analysis/casesElenco per l'analisi: nome, cognome, età, causa di morte e dettagli selezionati riportati dalla fonte, inclusi descrizione del reato, numero di figli minori orfani (Figli), giustificazione/descrizione dei media (Motivazione) e cosa succede dopo (Dopo). Sono testi della fonte, non motivazioni verificate. Le descrizioni possono contenere dettagli sensibili. I campi mancanti sono null. Non include nomi di presunti responsabili.
/api/v1/statistics/yearlyConteggi per anno
/api/v1/statistics/territoryConteggi per regione o provincia, con livello=regione|provincia
/api/v1/mapCerchi e statistiche dei territori, con livello=regione|provincia|comune. Ogni gruppo include source_locations, i nomi originali dei territori della fonte per selezionare esattamente i relativi casi.

Tutti questi endpoint accettano i cinque filtri opzionali. I conteggi comprendono tutti i casi monitorati; filtra tipo se vuoi una categoria specifica.

Contenuto dei file e limiti geografici

CSV e GeoJSON esportano i campi richiesti in un ordine stabile, compresi nome e cognome della vittima, nome del presunto responsabile, source_hash e i metadati year e anno. Se un campo sorgente richiesto manca, viene restituito vuoto/null; sono incluse anche le altre colonne sorgente disponibili nel DuckDB.

Le coordinate originali dei casi possono mancare: nel GeoJSON la geometria è null e nel CSV i campi sono vuoti. I cerchi della mappa usano centri territoriali del repertorio Opendatasoft/ISTAT e non indicano indirizzi o luoghi esatti degli eventi. Non confondere la copertura dei casi con quella dei cerchi aggregati.

Esempio Python

import requests

response = requests.get(
    "https://localhost/api/v1/download",
    params={"anno": 2025, "regione": "Lazio", "citta": "Roma"},
    verify="tracce-local-ca.crt",
    timeout=30,
)
response.raise_for_status()
with open("casi-2025-roma.csv", "wb") as output:
    output.write(response.content)

Errori