River flood forecast for a Philippine location
get_flood_forecastRetrieve daily river discharge forecasts for Philippine places to evaluate flood risk. Outputs discharge rates and bounds in cubic meters per second for specified forecast periods.
Instructions
Daily river discharge forecast for a Philippine place, from Open-Meteo's GloFAS model.
Returns a daily river_discharge_m3s series for the nearest river cell to the resolved location, plus its max and min bounds, in cubic meters per second. This is a model estimate, not a gauge reading, so treat it as one signal among many for flood risk. Examples:
get_flood_forecast("Cagayan de Oro") # 7-day default forecast get_flood_forecast("Marikina", forecast_days=14, past_days=3) # 14 days ahead, 3 days back
On failure: an unresolved location, or a forecast_days or past_days value that is not a whole number or is out of range, returns data_status "invalid_request", with validation_error true and days []. A PSGC outage during location resolution, or an Open-Meteo fetch failure, returns data_status "unavailable", with upstream_error true and days []. A response with no readable daily.time entries, or a river_discharge list shorter than daily.time (including an empty list), returns data_status "indeterminate", with upstream_error true, days [], and is never cached.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| location | Yes | City, municipality, or province name. | |
| past_days | No | Days of past discharge to include, from 0 to 30. Default 0. | |
| forecast_days | No | Days ahead to forecast, from 1 to 30. Default 7. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||