API · v1
Otwarte API
Każdy pożar z tego atlasu w formacie JSON, CSV i GeoJSON. Bez klucza, bez rejestracji i bez sztywnego limitu zapytań: obrysy, punkty cieplne, dotknięte gminy, pogoda, zagrożenie pożarowe i dym.
Jak to działa
- Bez klucza i bez rejestracji. Jeśli pobierasz dużo, rób to powoli i korzystaj z pamięci podręcznej.
- CORS jest otwarty: możesz wywoływać API bezpośrednio z przeglądarki.
- Odpowiedzi można przechowywać w pamięci podręcznej od pięciu minut do godziny, zależnie od zasobu.
- Dane na licencji CC BY 4.0: korzystaj z nich, podając WorldFires i źródło pierwotne.
- Wersja v1 nie zmieni się w sposób niekompatybilny; nowe pola są dopisywane na końcu.
Przykłady
/api/v1/fires?country=ES&year=2026&min_ha=1000
Pożary w Hiszpanii w 2026 roku powyżej 1000 ha
/api/v1/fires?bbox=40.0,-5.2,40.6,-4.2&format=geojson
Co mieści się w prostokącie, jako GeoJSON
/api/v1/fires/navaluenga-2026-07
Jeden pożar w całości
/api/v1/fires/navaluenga-2026-07/geometry
Obrys spalonego terenu
/api/v1/fires/navaluenga-2026-07/detections?format=csv
Jego detekcje VIIRS jako CSV
/api/v1/fires/navaluenga-2026-07/weather
Pogoda i FWI dzień po dniu
/api/v1/active?hours=72
Co płonie teraz, ostatnie 72 godziny
/api/v1/hotspots?lat=38.99&lon=-1.86&radius_km=50&hours=48
Pojedyncze ogniska w promieniu 50 km od punktu, ostatnie 48 godzin
/api/v1/hotspots?bbox=36,-9.5,44,3.5&format=geojson
Ogniska z ostatnich 24 godzin w kontynentalnej Hiszpanii, jako GeoJSON
/api/v1/countries
Objęte kraje i ich serie oficjalne
/api/v1/stats?country=PT
Sumy dla Portugalii według roku i miesiąca
/api/v1/places?country=ES&q=nava
Wyszukiwanie gmin
Filtry dla /fires
| country | Kod kraju, dwie lub trzy litery (ES, ESP). |
| year | Rok wybuchu pożaru. |
| from / to | Zakres dat, rrrr-mm-dd. |
| min_ha / max_ha | Minimalna i maksymalna powierzchnia w hektarach. |
| bbox | Prostokąt lat_min,lon_min,lat_max,lon_max. |
| region / place | Slug regionu lub gminy. |
| active | active=true dla pożarów, które nadal płoną. |
| lat / lon / radius_km | Okrąg wokół punktu, promień w km. Tylko /hotspots i /active. |
| hours | Godziny wstecz dla /hotspots (1-168) i /active (24, 72, 168). |
| static | static=true zostawia pochodnie, przemysł i wulkany, oznaczone static. |
| q | Przeszukuje nazwę i slug. |
| sort / order | Sortowanie według początku, końca lub powierzchni; order=asc lub desc. |
| limit / offset | limit do 1000 i offset do stronicowania. |
| format | json (domyślnie), csv lub geojson. |
| pretty | pretty=1, aby czytać wynik gołym okiem. |
Postać odpowiedzi
Wszystko zwraca obiekt z polami «meta» i «data». Meta zawiera liczbę wyników, licencję i źródła; csv i geojson zwracają zamiast tego format standardowy.
{
"meta": {
"count": 2, "total": 1232, "limit": 2, "offset": 0,
"generated": "2026-10-23T17:28:21+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"
}
]
}Skąd pochodzą dane
Obrysy z EFFIS i GWIS (Copernicus), punkty cieplne VIIRS z NASA FIRMS, granice administracyjne z geoBoundaries / OCHA COD-AB, pogoda ERA5 z Open-Meteo ze wskaźnikiem zagrożenia pożarowego wyliczanym u nas oraz dym z modelu Copernicus CAMS.
Sugerowane cytowanie: WorldFires (worldfires.org), na podstawie EFFIS i GWIS (Copernicus) oraz NASA FIRMS.