API · v1
API aperta
Tutti gli incendi di questo atlante in JSON, CSV e GeoJSON. Senza chiave, senza registrazione e senza limiti rigidi: perimetri, focolai, comuni colpiti, meteo, pericolo di incendio e fumo.
Come funziona
- Nessuna chiave e nessuna registrazione. Se scarichi molto, vai piano e usa la cache.
- CORS aperto: si può chiamare dal browser.
- Le risposte sono memorizzabili da cinque minuti a un’ora, secondo la risorsa.
- Dati con licenza CC BY 4.0: usali citando WorldFires e la fonte originale.
- La versione v1 non cambierà in modo incompatibile; i campi nuovi si aggiungono in fondo.
Esempi
/api/v1/fires?country=ES&year=2026&min_ha=1000
Incendi in Spagna nel 2026 sopra i 1.000 ha
/api/v1/fires?bbox=40.0,-5.2,40.6,-4.2&format=geojson
Cosa c’è dentro un rettangolo, in GeoJSON
/api/v1/fires/navaluenga-2026-07
Una scheda intera
/api/v1/fires/navaluenga-2026-07/geometry
Il perimetro bruciato
/api/v1/fires/navaluenga-2026-07/detections?format=csv
Le sue rilevazioni VIIRS in CSV
/api/v1/fires/navaluenga-2026-07/weather
Il tempo giorno per giorno e il FWI
/api/v1/active?hours=72
Cosa brucia adesso, ultime 72 ore
/api/v1/hotspots?lat=38.99&lon=-1.86&radius_km=50&hours=48
Singoli focolai entro 50 km da un punto, ultime 48 ore
/api/v1/hotspots?bbox=36,-9.5,44,3.5&format=geojson
Focolai delle ultime 24 ore nella Spagna peninsulare, in GeoJSON
/api/v1/countries
Paesi coperti e la loro serie ufficiale
/api/v1/stats?country=PT
Totali del Portogallo per anno e mese
/api/v1/places?country=ES&q=nava
Cercare comuni
Filtri di /fires
| country | Codice del paese, due o tre lettere (IT, ITA). |
| year | Anno di inizio. |
| from / to | Intervallo di date, aaaa-mm-gg. |
| min_ha / max_ha | Superficie minima e massima, in ettari. |
| bbox | Rettangolo lat_min,lon_min,lat_max,lon_max. |
| region / place | Slug della provincia o del comune. |
| active | active=true, solo quelli ancora accesi. |
| lat / lon / radius_km | Cerchio attorno a un punto, raggio in km. Solo /hotspots e /active. |
| hours | Ore indietro per /hotspots (1-168) e /active (24, 72, 168). |
| static | static=true include torce, industria e vulcani, marcati static. |
| q | Cerca nel nome e nello slug. |
| sort / order | Ordina per start, end o area; order=asc o desc. |
| limit / offset | limit fino a 1.000 e offset per paginare. |
| format | json (predefinito), csv o geojson. |
| pretty | pretty=1 per leggerlo a occhio. |
Forma della risposta
Tutto restituisce un oggetto con «meta» e «data». In meta stanno il conteggio, la licenza e le fonti; csv e geojson restituiscono il formato standard.
{
"meta": {
"count": 2, "total": 1232, "limit": 2, "offset": 0,
"generated": "2026-10-23T17:33:45+00:00",
"license": "CC BY 4.0 — cite WorldFires and the original sources",
"sources": { "perimeters": "EFFIS / Copernicus EMS (CC BY 4.0); GWIS / Copernicus (reconstructed from VIIRS) (CC BY 4.0); MTBS (USGS / USDA Forest Service) (Public domain); …", "hotspots": "NASA FIRMS (VIIRS)" }
},
"data": [
{
"slug": "navaluenga-2026-07", "country": "ES", "name": "Navaluenga",
"start": "2026-07-22", "end": "2026-08-09", "days": 19, "active": false,
"hectares": 63974, "area_source": "effis_perimeter",
"hotspots": 2841, "frp_max_mw": 1216.5,
"lat": 40.41, "lon": -4.69, "bbox": [-4.99, 40.26, -4.31, 40.51],
"municipality": "navaluenga", "region": "avila",
"url": "https://worldfires.org/en/fire/navaluenga-2026-07"
}
]
}Da dove vengono i dati
Perimetri EFFIS e GWIS (Copernicus), focolai VIIRS di NASA FIRMS, confini amministrativi di geoBoundaries / OCHA COD-AB, meteo ERA5 di Open-Meteo con l’indice FWI calcolato qui, e fumo del modello CAMS di Copernicus.
Citazione suggerita: WorldFires (worldfires.org), su dati EFFIS e GWIS (Copernicus) e NASA FIRMS.