NASA FIRMS

NASA FIRMS (Fire Information for Resource Management System) provides global active fire hotspot data from MODIS and VIIRS satellite instruments. An API key is required — register for free at firms.modaps.eosdis.nasa.gov/api/map_key/.

The response format is CSV (not JSON).

MetaData(NASAFIRMS())

MetaData("FIRMS_MAP_KEY", "5,000 req/10 min", :natural_hazards, Dict(:longitude => "Center longitude of fire pixel (°)", :acq_date => "Acquisition date (YYYY-MM-DD)", :bright_ti4 => "VIIRS I-4 brightness temperature (K)", :acq_time => "Acquisition time UTC (HHMM)", :daynight => "Day (D) or Night (N) observation", :confidence => "Detection confidence", :frp => "Fire Radiative Power (MW)", :scan => "Along-scan pixel size (km)", :bright_ti5 => "VIIRS I-5 brightness temperature (K)", :satellite => "Satellite platform"…), :point, "375 m (VIIRS) / 1 km (MODIS)", "Global", :timeseries, nothing, "Near real-time + archive", "NASA EOSDIS", "https://firms.modaps.eosdis.nasa.gov/api/", Dict("CSV" => "336ed68f-0bac-5ca0-87d4-7b16caf5d00b", "DataFrames" => "a93c6f00-e57d-5684-b7b6-d8193f3e46c0"))

Setup

Set the environment variable:

ENV["FIRMS_MAP_KEY"] = "your-map-key"

Bounding Box Query

using GeoInterface.Extents: Extent

plan = DataAccessPlan(NASAFIRMS(),
    Extent(X=(-125.0, -114.0), Y=(32.0, 42.0)),
    Date(2024, 7, 1), Date(2024, 7, 5))
files = fetch(plan)

Requests longer than 10 days are automatically split into 10-day chunks.

Country Query

Query by ISO 3-letter country code (the extent argument is ignored):

plan = DataAccessPlan(NASAFIRMS(), (0.0, 0.0),
    Date(2024, 7, 1), Date(2024, 7, 3);
    country = "AUS")

Options

Keyword	Type	Default	Description
`satellite`	`String`	`"VIIRS_SNPP_NRT"`	Satellite source (see below)
`country`	`String`	`""`	ISO 3-letter country code (overrides spatial extent)

Satellite Sources

Source ID	Description
`VIIRS_SNPP_NRT`	VIIRS Suomi-NPP Near Real-Time
`VIIRS_SNPP_SP`	VIIRS Suomi-NPP Standard Processing
`VIIRS_NOAA20_NRT`	VIIRS NOAA-20 Near Real-Time
`VIIRS_NOAA21_NRT`	VIIRS NOAA-21 Near Real-Time
`MODIS_NRT`	MODIS Near Real-Time
`MODIS_SP`	MODIS Standard Processing
`LANDSAT_NRT`	Landsat 8/9 (US/Canada only)

Variables

Variable	Description
`latitude`	Center latitude of fire pixel (°)
`longitude`	Center longitude of fire pixel (°)
`bright_ti4`	VIIRS I-4 brightness temperature (K)
`bright_ti5`	VIIRS I-5 brightness temperature (K)
`frp`	Fire Radiative Power (MW)
`confidence`	Detection confidence
`acq_date`	Acquisition date (YYYY-MM-DD)
`acq_time`	Acquisition time UTC (HHMM)
`satellite`	Satellite platform
`daynight`	Day (D) or Night (N) observation
`scan`	Along-scan pixel size (km)
`track`	Along-track pixel size (km)