API · v1

Відкритий API

Усі пожежі цього атласу в JSON, CSV і GeoJSON. Без ключа, без реєстрації і без жорсткого ліміту: периметри, осередки, уражені громади, погода, пожежна небезпека і дим.

/api/v1 /api/v1/fires /api/v1/countries

Як це працює

Ключ і реєстрація не потрібні. Якщо тягнете багато, робіть це повільно і кешуйте.
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 км від точки, останні 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	Код країни, дві або три літери (UA, UKR).
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 з обчисленим тут індексом FWI і дим із моделі CAMS програми Copernicus.

Рекомендоване посилання: WorldFires (worldfires.org), за даними EFFIS і GWIS (Copernicus) та NASA FIRMS.