API · v1
Открытый API
Все пожары этого атласа в форматах JSON, CSV и GeoJSON. Без ключа, без регистрации и без жёсткого лимита запросов: периметры, термоточки, затронутые муниципалитеты, погода, пожарная опасность и дым.
Как это работает
- Ключ и регистрация не нужны. Если загружаете много, делайте это неспешно и кешируйте.
- CORS открыт: можно обращаться к API прямо из браузера.
- Ответы можно кешировать от пяти минут до часа, в зависимости от ресурса.
- Данные по лицензии 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 км от точки, последние 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 | Код страны, две или три буквы (ES, ESP). |
| 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 | Круг вокруг точки, радиус в км. Только /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:40+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 с рассчитанным здесь индексом пожарной опасности и дым из модели CAMS программы Copernicus.
Рекомендуемая ссылка: WorldFires (worldfires.org), по данным EFFIS и GWIS (Copernicus) и NASA FIRMS.