API · v1
Отворен API
Всички пожари в този атлас в JSON, CSV и GeoJSON. Без ключ, без регистрация и без строг лимит: периметри, огнища, засегнати общини, време, опасност от пожар и дим.
Как работи
- Не е нужен ключ или регистрация. Ако сваляте много, вървете бавно и кеширайте.
- CORS е отворен: може да се вика от браузъра.
- Отговорите се кешират от пет минути до час според ресурса.
- Данните са под CC BY 4.0: използвайте ги, като цитирате WorldFires и първоизточника.
- Версия v1 няма да се променя несъвместимо; новите полета се добавят накрая.
Примери
/api/v1/fires?country=ES&year=2026&min_ha=1000
Пожари в Испания през 2026 г. над 1000 ха
/api/v1/fires?bbox=40.0,-5.2,40.6,-4.2&format=geojson
Какво има в правоъгълник, в GeoJSON
/api/v1/fires/navaluenga-2026-07
Цяла страница на пожар
/api/v1/fires/navaluenga-2026-07/geometry
Изгорелият периметър
/api/v1/fires/navaluenga-2026-07/detections?format=csv
Неговите засичания VIIRS в CSV
/api/v1/fires/navaluenga-2026-07/weather
Времето ден по ден и FWI
/api/v1/active?hours=72
Какво гори сега, последните 72 часа
/api/v1/hotspots?lat=38.99&lon=-1.86&radius_km=50&hours=48
Отделни огнища до 50 km от точка, последните 48 часа
/api/v1/hotspots?bbox=36,-9.5,44,3.5&format=geojson
Огнища от последните 24 часа в континентална Испания, като GeoJSON
/api/v1/countries
Обхванати държави и официалният им ред
/api/v1/stats?country=PT
Общо за Португалия по година и месец
/api/v1/places?country=ES&q=nava
Търсене на общини
Филтри на /fires
| country | Код на държавата, две или три букви (BG, BGR). |
| year | Година на започване. |
| from / to | Интервал от дати, гггг-мм-дд. |
| min_ha / max_ha | Минимална и максимална площ, в хектари. |
| bbox | Правоъгълник lat_min,lon_min,lat_max,lon_max. |
| region / place | Slug на областта или общината. |
| active | active=true, само още горящите. |
| lat / lon / radius_km | Кръг около точка, радиус в km. Само /hotspots и /active. |
| hours | Часове назад за /hotspots (1-168) и /active (24, 72, 168). |
| static | static=true запазва факли, промишленост и вулкани, отбелязани static. |
| q | Търси в името и в slug. |
| sort / order | Подрежда по start, end или area; order=asc или desc. |
| limit / offset | limit до 1000 и offset за страници. |
| format | json (по подразбиране), csv или geojson. |
| pretty | pretty=1 за четене с око. |
Вид на отговора
Всичко връща обект с «meta» и «data». В meta са броят, лицензът и източниците; csv и geojson връщат съответния стандартен формат.
{
"meta": {
"count": 2, "total": 1232, "limit": 2, "offset": 0,
"generated": "2026-10-23T17:33:44+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"
}
]
}Откъде са данните
Периметри на EFFIS и GWIS (Copernicus), огнища VIIRS от NASA FIRMS, административни граници от geoBoundaries / OCHA COD-AB, време ERA5 от Open-Meteo с изчисления тук индекс FWI и дим от модела CAMS на Copernicus.
Препоръчително цитиране: WorldFires (worldfires.org), по данни на EFFIS и GWIS (Copernicus) и NASA FIRMS.