Skip to main content
The fire risk endpoint aggregates NASA FIRMS hotspot data from the last five days within a configurable radius around a coordinate and distills it into a single 0–100 risk score. The score is then mapped to a human-readable label — Alto, Medio, or Bajo — so you can quickly triage field locations without parsing raw hotspot arrays. Use this endpoint when you need a single signal to drive alerting logic or to populate a risk dashboard.

Endpoint

Parameters

float
required
Center latitude of the location to assess in decimal degrees, WGS 84.
float
required
Center longitude of the location to assess in decimal degrees, WGS 84.
float
default:"100"
Search radius around the center point in kilometres. All hotspots detected within this radius are included in the risk calculation.

Response

float
required
Center latitude echoed from the request.
float
required
Center longitude echoed from the request.
float
required
Search radius echoed from the request.
float
required
Aggregated fire risk score on a 0–100 scale. Higher values indicate greater fire activity within the search radius. Computed from the number and intensity of active hotspots detected by VIIRS_SNPP_NRT over the last five days.
string
required
Human-readable risk tier derived from risk_score:
  • "Alto" — score ≥ 60
  • "Medio" — score 30–59
  • "Bajo" — score < 30
integer
required
Number of active fire hotspots detected within the search radius over the last five days.
object
Cache metadata for the underlying NASA FIRMS data.

Error codes

Example