# NASA FIRMS (branden)

Hittebronnen die satellieten binnen drie uur na de overkomst melden. In Nederland vooral heide- en duinbranden en industrie.

- Uitgever: NASA
- Gebied: Wereld · Laagste detail: 375 meter
- Periode: 2000 – heden · Ververst: elk uur
- Toegang: Gratis sleutel · Licentie: Vrij gebruik (NASA)
- Koppelsleutels: coördinaten, tijdstip
- Status: grijs
- URL: https://firms.modaps.eosdis.nasa.gov

## Wat kun je ermee?
- **Natuurbranden in Nederland.** Filter op Nederland en zoek de heide- en duinbranden van een droog voorjaar terug.

## Interessante koppelingen
- Branden na droge weken → [knmi-daggegevens](https://www.opendataindex.nl/bron/knmi-daggegevens.md) via datum. Tel de dagen zonder neerslag voor elke brand.

## Vergelijkbare bronnen
- [nasa-gibs](https://www.opendataindex.nl/bron/nasa-gibs.md): Beelden in plaats van punten.

## API (REST (GET, CSV) met MAP_KEY + open CSV-bestanden per land)

- Basis: https://firms.modaps.eosdis.nasa.gov/api
- Toegang: De API vraagt een gratis MAP_KEY (32 tekens, per e-mail aangevraagd) als deel van het pad. Zonder geldige sleutel: HTTP 400 'Invalid MAP_KEY.' (getest). De jaarbestanden per land onder /data/country/ zijn open, zonder sleutel. (getest)
- Formaten: csv, kml
- Filteren: Geen querytaal: sensor, rechthoek, dagbereik en datum zitten in het pad. Filter op type en confidence zelf in de CSV.; 

### Endpoints
- `GET /area/csv/{MAP_KEY}/{SOURCE}/{west,zuid,oost,noord}/{DAY_RANGE}[/{DATE}]`: Brandhaarden (hotspots) in een rechthoek of 'world', 1 tot 5 dagen; zonder DATE de nieuwste dagen.
- `GET /data_availability/csv/{MAP_KEY}/{SENSOR}`: Welke datums er per sensor zijn (ALL of één SOURCE).
- `GET /country/csv/{MAP_KEY}/{SOURCE}/{LAND}/{DAY_RANGE}[/{DATE}]`: Per land: staat op de API-pagina als 'Feature currently not available' (16 okt 2026). Gebruik area met een rechthoek.
- `GET https://firms.modaps.eosdis.nasa.gov/mapserver/mapkey_status/?MAP_KEY={MAP_KEY}`: Hoeveel transacties je sleutel nog heeft.
- `GET https://firms.modaps.eosdis.nasa.gov/data/country/{sensor}/{jaar}/{sensor}_{jaar}_{Land}.csv`: Open jaarbestand per land, zonder sleutel: viirs-snpp 2012–2025 (NL 2025: 252 kB), modis vanaf 2000. Lopend jaar en viirs-noaa20 gaven 404.

### Parameters
- `SOURCE`: VIIRS_SNPP_NRT, VIIRS_SNPP_SP, VIIRS_NOAA20_NRT, VIIRS_NOAA20_SP, VIIRS_NOAA21_NRT, MODIS_NRT, MODIS_SP, LANDSAT_NRT (alleen VS/Canada). NRT = bijna-realtime, SP = standaardverwerking (definitief, later). (uit de beschrijving)
- `AREA_COORDINATES`: Rechthoek in graden (Nederland ongeveer 3.2,50.7,7.3,53.6) of world. (uit de beschrijving)
- `DAY_RANGE`: Aantal dagen per vraag. (uit de beschrijving)
- `DATE`: Optioneel: geeft DATE tot DATE + DAY_RANGE − 1; zonder: vandaag terug. (uit de beschrijving)

### Kolommen van de VIIRS-CSV (jaarbestand Nederland 2025) (9)
`latitude / longitude` getal, `acq_date / acq_time` datum / HHMM, `bright_ti4 / bright_ti5` getal, `frp` getal, `scan / track` getal, `confidence` tekst, `daynight` tekst, `satellite / instrument / version` tekst, `type` integer

### Limieten en valkuilen
- 5.000 transacties per 10 minuten per MAP_KEY; een vraag over meer dagen telt als meerdere transacties. (uit de beschrijving)
- Hoogstens 5 dagen per vraag (DAY_RANGE). (uit de beschrijving)
- robots.txt van firms.modaps.eosdis.nasa.gov vraagt Crawl-delay: 1 en verbiedt o.a. /*.json$; /api/ en /data/ zijn toegestaan. (getest)
- In Nederland is ~80% van de VIIRS-detecties in de jaarbestanden een vaste warmtebron (type 2: industrie, fakkels), geen brand. Tel voor natuurbranden alleen type 0. Of de API-CSV ook een kolom type heeft, konden we zonder sleutel niet nagaan. (ervaring)
- Realtime (RT/URT) detecties worden vervangen zodra de NRT-verwerking klaar is of na 6 uur; SP-reeksen komen maanden later en zijn definitief. (uit de beschrijving)
- Elke regel is één pixel van één overkomst: één warmtebron geeft meerdere regels (2 jan 2025 10:55 UTC: twee punten ~100 m uit elkaar bij IJmuiden). Groepeer op plaats en dag voordat je 'branden' telt. (getest)

### Voorbeeld
```
https://firms.modaps.eosdis.nasa.gov/data/country/viirs-snpp/2025/viirs-snpp_2025_Netherlands.csv
```

## Wat je ermee kunt bouwen
- [Natuurbrandkaart: risico van vandaag, hittepunten en verbrande natuur](https://www.opendataindex.nl/bouwen/natuurbrand-kaart.md): Eén kaart van Nederland per veiligheidsregio met de fase van de brandweer, het brandgevaar voor vandaag en de komende dagen (EFFIS), de hittepunten die satellieten deze week zagen (zonder fabrieken) en de natuur die dit jaar is afgebrand, met de droogte van het KNMI ernaast.


## Voorbeelden met echte cijfers (3)

Per voorbeeld de bevinding, de peildatum en de aanroep die precies deze cijfers ophaalt.

- **De grootste natuurbranden in Nederland volgens EFFIS: het meest Deurne, april 2020 (649 hectare), dan Elburg, april 2026 en Ede, april 2014** (2003–2026). Tabel burntareas, country=NL. [Voorbeeld](https://www.opendataindex.nl/voorbeeld/effis-grootste-branden)
  - `https://api.effis.emergency.copernicus.eu/rest/2/burntareas/current/?country=NL`
- **Satellietdetecties van vermoedelijke vegetatiebranden in Nederland: 708 detecties in 2025, 7% meer dan in 2012** (2025). Tabel viirs-snpp, Netherlands. [Voorbeeld](https://www.opendataindex.nl/voorbeeld/firms-natuurbranden-per-jaar)
  - `https://firms.modaps.eosdis.nasa.gov/data/country/viirs-snpp/2025/viirs-snpp_2025_Netherlands.csv`
- **Satellietdetecties van vermoedelijke vegetatiebranden in Nederland per maand: het meest juni (1.312 detecties), dan april en augustus** (2012–2025). Tabel viirs-snpp, Netherlands. [Voorbeeld](https://www.opendataindex.nl/voorbeeld/firms-natuurbranden-per-maand)
  - `https://firms.modaps.eosdis.nasa.gov/data/country/viirs-snpp/2025/viirs-snpp_2025_Netherlands.csv`