Flood Sample

This page provides a complete sample response for a flood hazard from the Active Hazards API endpoint. Flood hazards are sourced from multiple providers including the NASA Global Flood Model and the Australian Bureau of Meteorology. The sample below shows an Australian BoM riverine flood warning.

Flood-Specific Properties

Incident Data

The incident.properties object for flood hazards varies by source. For Australian Bureau of Meteorology alerts, key properties include:

  • hazardName - Name of the flood event

  • senderName - Source name (e.g., "Australian Government Bureau of Meteorology")

  • headline - Official flood warning headline text

  • severity - Severity level (e.g., "Severe")

  • urgency - Urgency classification

  • certainty - Certainty classification

For NASA Global Flood Model alerts, additional properties include pfafId, pfafIdList, rfrScore, cfrScore, scaledRiverineRisk, scaledCoastalRisk, hazardScore, GloFAS2Yr/GloFAS5Yr/GloFAS20Yr, VIIRSTotalScore, DFOTotalScore, oneDayFloodAreaKm/fiveDayFloodAreaKm, incidentSeverity, and flag.

Features

The features property for floods contains GeoJSON features describing the affected areas. Feature types and content vary by source provider.

Exposure Areas

Floods may use multiple exposure levels depending on the source:

  • Level 0 (LIMITED): Areas with limited flood exposure

  • Level 1 (MODERATE): Areas with moderate flood exposure

  • Level 2 (STRONG): Areas with strong flood exposure

Exposure Assessment Units

  • population: Object containing demographic breakdowns — total (number of people), total0_14 (children 0-14), total15_64 (adults 15-64), total65_Plus (seniors 65+), households (number of households), vulnerable (vulnerable population)

  • capital: Object containing infrastructure data — total (USD replacement value), school (number of schools), hospital (number of hospitals)

  • totalByCountry: Array of regional breakdowns per country, each containing population, capital, country code (country), admin names (admin0, admin1, admin2), and humanitarian needs (foodNeeds, waterNeeds, wasteNeeds, shelterNeeds with units)

  • totalByAdmin: Array of admin-level breakdowns with the same structure as totalByCountry

  • Humanitarian needs: foodNeeds (CAL), waterNeeds (liters), wasteNeeds (100 liters), shelterNeeds (sq meters)

Sample Response

circle-info

Note: Coordinate arrays have been replaced with [...] for brevity. The features array has been truncated to show a representative EXPOSURE_AREA feature type. This sample contained 3 exposure area features (LIMITED, MODERATE, STRONG) with 3 corresponding exposure levels in the exposure assessment.

Last updated