API · v1
API terbuka
Setiap kebakaran dalam atlas ini dalam format JSON, CSV, dan GeoJSON. Tanpa kunci, tanpa pendaftaran, dan tanpa batas permintaan yang ketat: perimeter, titik panas, kabupaten/kota terdampak, cuaca, bahaya kebakaran, dan asap.
Cara kerjanya
- Tanpa kunci dan tanpa pendaftaran. Jika Anda menarik banyak data, lakukan perlahan dan gunakan cache.
- CORS terbuka: Anda bisa memanggilnya langsung dari peramban.
- Respons dapat di-cache selama lima menit hingga satu jam, tergantung sumber dayanya.
- Data berlisensi CC BY 4.0: gunakan dengan menyebut WorldFires dan sumber aslinya.
- Versi v1 tidak akan berubah secara merusak; kolom baru ditambahkan di belakang.
Contoh
/api/v1/fires?country=ES&year=2026&min_ha=1000
Kebakaran di Spanyol pada 2026 di atas 1.000 ha
/api/v1/fires?bbox=40.0,-5.2,40.6,-4.2&format=geojson
Apa yang ada di dalam sebuah persegi panjang, dalam GeoJSON
/api/v1/fires/navaluenga-2026-07
Satu kebakaran secara lengkap
/api/v1/fires/navaluenga-2026-07/geometry
Perimeter area terbakar
/api/v1/fires/navaluenga-2026-07/detections?format=csv
Deteksi VIIRS-nya dalam CSV
/api/v1/fires/navaluenga-2026-07/weather
Cuaca dan FWI hari demi hari
/api/v1/active?hours=72
Apa yang sedang terbakar, 72 jam terakhir
/api/v1/hotspots?lat=38.99&lon=-1.86&radius_km=50&hours=48
Titik panas tunggal dalam 50 km dari satu titik, 48 jam terakhir
/api/v1/hotspots?bbox=36,-9.5,44,3.5&format=geojson
Titik panas 24 jam terakhir di daratan Spanyol, sebagai GeoJSON
/api/v1/countries
Negara yang dicakup dan seri resminya
/api/v1/stats?country=PT
Total Portugal per tahun dan bulan
/api/v1/places?country=ES&q=nava
Cari kabupaten/kota
Filter untuk /fires
| country | Kode negara, dua atau tiga huruf (ES, ESP). |
| year | Tahun kebakaran bermula. |
| from / to | Rentang tanggal, yyyy-mm-dd. |
| min_ha / max_ha | Luas minimum dan maksimum, dalam hektare. |
| bbox | Persegi panjang lat_min,lon_min,lat_max,lon_max. |
| region / place | Slug wilayah atau kabupaten/kota. |
| active | active=true untuk kebakaran yang masih menyala. |
| lat / lon / radius_km | Lingkaran di sekitar titik, radius dalam km. Hanya /hotspots dan /active. |
| hours | Jam ke belakang untuk /hotspots (1-168) dan /active (24, 72, 168). |
| static | static=true menyertakan suar, industri, dan gunung api, ditandai static. |
| q | Mencari pada nama dan slug. |
| sort / order | Urutkan menurut start, end, atau area; order=asc atau desc. |
| limit / offset | limit hingga 1.000 dan offset untuk berpindah halaman. |
| format | json (bawaan), csv, atau geojson. |
| pretty | pretty=1 agar mudah dibaca mata. |
Bentuk respons
Semua mengembalikan objek berisi «meta» dan «data». Meta memuat jumlah, lisensi, dan sumber; csv dan geojson mengembalikan format bakunya.
{
"meta": {
"count": 2, "total": 1232, "limit": 2, "offset": 0,
"generated": "2026-10-23T17:33:42+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"
}
]
}Dari mana datanya berasal
Perimeter dari EFFIS dan GWIS (Copernicus), titik panas VIIRS dari NASA FIRMS, batas administratif dari geoBoundaries / OCHA COD-AB, cuaca ERA5 dari Open-Meteo dengan indeks cuaca kebakaran yang dihitung di sini, dan asap dari model CAMS Copernicus.
Kutipan yang disarankan: WorldFires (worldfires.org), berdasarkan EFFIS dan GWIS (Copernicus) serta NASA FIRMS.