API · v1
API aberta
Todos os incêndios deste atlas em JSON, CSV e GeoJSON. Sem chave, sem registo e sem limite rígido: perímetros, focos, concelhos afetados, meteorologia, perigo de incêndio e fumo.
Como funciona
- Não é preciso chave nem registo. Se for descarregar muito, vá devagar e guarde em cache.
- CORS aberto: pode chamar-se a partir do navegador.
- As respostas podem ficar em cache entre cinco minutos e uma hora, conforme o recurso.
- Dados sob CC BY 4.0: use-os citando o WorldFires e a fonte original.
- A versão v1 não mudará de forma incompatível; os campos novos são acrescentados no fim.
Exemplos
/api/v1/fires?country=ES&year=2026&min_ha=1000
Incêndios em Espanha em 2026 com mais de 1.000 ha
/api/v1/fires?bbox=40.0,-5.2,40.6,-4.2&format=geojson
O que está dentro de um retângulo, em GeoJSON
/api/v1/fires/navaluenga-2026-07
Uma ficha completa
/api/v1/fires/navaluenga-2026-07/geometry
O perímetro ardido
/api/v1/fires/navaluenga-2026-07/detections?format=csv
As deteções VIIRS em CSV
/api/v1/fires/navaluenga-2026-07/weather
O tempo dia a dia e o FWI
/api/v1/active?hours=72
O que arde agora, últimas 72 horas
/api/v1/hotspots?lat=38.99&lon=-1.86&radius_km=50&hours=48
Focos isolados a menos de 50 km de um ponto, últimas 48 horas
/api/v1/hotspots?bbox=36,-9.5,44,3.5&format=geojson
Focos das últimas 24 horas na Espanha peninsular, em GeoJSON
/api/v1/countries
Países cobertos e a sua série oficial
/api/v1/stats?country=PT
Totais de Portugal por ano e mês
/api/v1/places?country=ES&q=nava
Procurar concelhos
Filtros de /fires
| country | Código do país, de duas ou três letras (PT, PRT). |
| year | Ano de início. |
| from / to | Intervalo de datas, aaaa-mm-dd. |
| min_ha / max_ha | Área mínima e máxima, em hectares. |
| bbox | Retângulo lat_min,lon_min,lat_max,lon_max. |
| region / place | Slug da região ou do concelho. |
| active | active=true, só os que ainda ardem. |
| lat / lon / radius_km | Círculo em torno de um ponto, raio em km. Só /hotspots e /active. |
| hours | Horas para trás em /hotspots (1-168) e /active (24, 72, 168). |
| static | static=true inclui tochas, indústria e vulcões, marcados como static. |
| q | Procura no nome e no slug. |
| sort / order | Ordena por start, end ou area; order=asc ou desc. |
| limit / offset | limit até 1.000 e offset para paginar. |
| format | json (por omissão), csv ou geojson. |
| pretty | pretty=1 para ler à vista. |
Forma da resposta
Tudo devolve um objeto com «meta» e «data». Em meta vão a contagem, a licença e as fontes; csv e geojson devolvem o formato padrão.
{
"meta": {
"count": 2, "total": 1232, "limit": 2, "offset": 0,
"generated": "2026-10-23T17:33:33+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"
}
]
}De onde vêm os dados
Perímetros do EFFIS e do GWIS (Copernicus), focos VIIRS da NASA FIRMS, limites administrativos do geoBoundaries / OCHA COD-AB, meteorologia ERA5 da Open-Meteo com o índice FWI calculado aqui, e fumo do modelo CAMS do Copernicus.
Citação sugerida: WorldFires (worldfires.org), a partir do EFFIS e do GWIS (Copernicus) e da NASA FIRMS.