2,150 real river cells from the GloFAS upstream-area network, rendered as a smoothed severity heat field — the return period each day's forecast discharge exceeds. Drag to orbit · ⌘/Ctrl-scroll to zoom · press play to run the 30-day horizon.
One request per point of interest. This page renders a
representative sample shaped exactly like live responses; the river
network itself is the real GloFAS v4 upstream-area grid — the same data
/v1/flood snaps to.
# nearest river cell is chosen for you (largest upstream area within ±0.1°)
curl -H "x-api-key: wk_live_…" \
"$BASE/v1/flood?latitude=-27.47&longitude=153.03&days=30"{
"snapped": { "latitude": -27.43, "longitude": 153.13,
"distance_km": 7.7, "upstream_area_km2": 13545 },
"run_date": "2026-07-20",
"daily": {
"time": ["2026-07-21", "2026-07-22", …],
"discharge": [812.4, 1290.7, …], // m³/s at the snapped cell
"exceeds": [null, 2, …] // return period met that day
},
"thresholds": { "rp2": 1180.0, "rp10": 2762.4, … },
"max_return_period_exceeded": 10,
"attribution": "Copernicus Emergency Management Service"
}| Field | Meaning |
|---|---|
snapped | The river cell actually used — the highest-upstream-area cell within ±0.1° of your point. Naïve nearest-cell misses rivers; this doesn't. |
daily.exceeds | Largest return period (2/5/10/20/50/100-yr) whose threshold that day's discharge meets — the severity this globe colors by. |
thresholds | The JRC return-period discharge thresholds at the snapped cell, so clients can draw their own bands. |
404 "no river cell…" | Point too far from any modelled river (10 km² upstream floor) — a data-coverage answer, not an error. |