-
Created by
Erik Pelgrim, last updated on 17-08-2026
3 minute read
This import type retrieves gauge forecast data from Google's Flood Hub API.
It constructs the request url as follows:
<serverUrl>?<gaugeIds>&<issueTimeStart>&<apiKey>
Where:
<serverUrl> => taken exactly from config
<gaugeIds> => for each time series a gaugeIds=locationId is added, separated by &
<issueTimeStart> => issueTimeStart=yyyy-MM-ddTHH:mm:ssZ where the date format is used for time step 25 hours before T0.
This is because new forecasts are available roughly every 24 hours and the API returns all available forecasts since issueTimeStart.
So with 25 hours before it is most likely the most recent forecast is available.
The import automatically selects the newest forecast.
<apiKey> => taken straight from value of the string property with key="apiKey".
For example for locations with ids: hybas_2120382190 and hybas_2120410870 and a T0 of 2026-08-14 13:00 it will create the next url (GET) request:
https://floodforecasting.googleapis.com/v1/gauges:queryGaugeForecasts?gaugeIds=hybas_2120382190&gaugeIds=hybas_2120410870&issueTimeStart=2026-08-13T12:00:00Z&key=QWERTYUIOPASDFGHJKLZXCVBNM
It will request as many locations as possible at once, with a maximum of 500.
When more then 500 time series are configured for the import it will do multiple requests of maximum 500 locations at once.
Example for Intern. Radar Composite, using OpenID Connect
<import> <general> <importTypeStandard>GoogleFloodHubV1GaugeForecast</importTypeStandard> <serverUrl>https://floodforecasting.googleapis.com/v1/gauges:queryGaugeForecasts</serverUrl> </general> <properties> <string key="apiKey" value="QWERTYUIOPASDFGHJKLZXCVBNM"/> </properties> <timeSeriesSet> <moduleInstanceId>ImportFloodHubAPI</moduleInstanceId> <valueType>scalar</valueType> <parameterId>Discharge</parameterId> <locationSetId>StationsFloodHubNL</locationSetId> <timeSeriesType>external forecasting</timeSeriesType> <timeStep unit="day" multiplier="1"/> <readWriteMode>read complete forecast</readWriteMode> </timeSeriesSet> </import>
The API returns JSON where:
for each gaugeId 1 time series is created, it picks the last from the list "forecasts" within its gaugeId block
the date of issuedTime is used as forecast time of the time series
the value of the value field is placed on the time step that corresponds to forecastEndTime
for example:
Example JSON response
{
"forecasts": {
"hybas_2120382190": {
"forecasts": [
{
"issuedTime": "2026-08-13T11:00:26.391721Z",
"forecastRanges": [
{
"value": 762.0316162109375,
"forecastStartTime": "2026-08-11T00:00:00Z",
"forecastEndTime": "2026-08-12T00:00:00Z"
},
{
"value": 753.43829345703125,
"forecastStartTime": "2026-08-12T00:00:00Z",
"forecastEndTime": "2026-08-13T00:00:00Z"
},
{
"value": 749.47216796875,
"forecastStartTime": "2026-08-13T00:00:00Z",
"forecastEndTime": "2026-08-14T00:00:00Z"
},
{
"value": 743.4471435546875,
"forecastStartTime": "2026-08-14T00:00:00Z",
"forecastEndTime": "2026-08-15T00:00:00Z"
},
{
"value": 737.175537109375,
"forecastStartTime": "2026-08-15T00:00:00Z",
"forecastEndTime": "2026-08-16T00:00:00Z"
},
{
"value": 739.316650390625,
"forecastStartTime": "2026-08-16T00:00:00Z",
"forecastEndTime": "2026-08-17T00:00:00Z"
},
{
"value": 768.04364013671875,
"forecastStartTime": "2026-08-17T00:00:00Z",
"forecastEndTime": "2026-08-18T00:00:00Z"
},
{
"value": 798.81927490234375,
"forecastStartTime": "2026-08-18T00:00:00Z",
"forecastEndTime": "2026-08-19T00:00:00Z"
}
],
"gaugeId": "hybas_2120382190"
},
{
"issuedTime": "2026-08-14T11:02:37.437448Z",
"forecastRanges": [
{
"value": 752.99847412109375,
"forecastStartTime": "2026-08-12T00:00:00Z",
"forecastEndTime": "2026-08-13T00:00:00Z"
},
{
"value": 745.26409912109375,
"forecastStartTime": "2026-08-13T00:00:00Z",
"forecastEndTime": "2026-08-14T00:00:00Z"
},
{
"value": 742.85955810546875,
"forecastStartTime": "2026-08-14T00:00:00Z",
"forecastEndTime": "2026-08-15T00:00:00Z"
},
{
"value": 738.6551513671875,
"forecastStartTime": "2026-08-15T00:00:00Z",
"forecastEndTime": "2026-08-16T00:00:00Z"
},
{
"value": 739.35943603515625,
"forecastStartTime": "2026-08-16T00:00:00Z",
"forecastEndTime": "2026-08-17T00:00:00Z"
},
{
"value": 745.81085205078125,
"forecastStartTime": "2026-08-17T00:00:00Z",
"forecastEndTime": "2026-08-18T00:00:00Z"
},
{
"value": 758.571044921875,
"forecastStartTime": "2026-08-18T00:00:00Z",
"forecastEndTime": "2026-08-19T00:00:00Z"
},
{
"value": 765.5457763671875,
"forecastStartTime": "2026-08-19T00:00:00Z",
"forecastEndTime": "2026-08-20T00:00:00Z"
}
],
"gaugeId": "hybas_2120382190"
}
]
},
"hybas_2120410870": {
"forecasts": [
{
"issuedTime": "2026-08-13T13:57:20.126868Z",
"forecastRanges": [
{
"value": 18.599159240722656,
"forecastStartTime": "2026-08-11T00:00:00Z",
"forecastEndTime": "2026-08-12T00:00:00Z"
},
{
"value": 18.366485595703125,
"forecastStartTime": "2026-08-12T00:00:00Z",
"forecastEndTime": "2026-08-13T00:00:00Z"
},
{
"value": 18.017162322998047,
"forecastStartTime": "2026-08-13T00:00:00Z",
"forecastEndTime": "2026-08-14T00:00:00Z"
},
{
"value": 17.715829849243164,
"forecastStartTime": "2026-08-14T00:00:00Z",
"forecastEndTime": "2026-08-15T00:00:00Z"
},
{
"value": 18.514179229736328,
"forecastStartTime": "2026-08-15T00:00:00Z",
"forecastEndTime": "2026-08-16T00:00:00Z"
},
{
"value": 22.854780197143555,
"forecastStartTime": "2026-08-16T00:00:00Z",
"forecastEndTime": "2026-08-17T00:00:00Z"
},
{
"value": 25.9123592376709,
"forecastStartTime": "2026-08-17T00:00:00Z",
"forecastEndTime": "2026-08-18T00:00:00Z"
},
{
"value": 25.551824569702148,
"forecastStartTime": "2026-08-18T00:00:00Z",
"forecastEndTime": "2026-08-19T00:00:00Z"
}
],
"gaugeId": "hybas_2120410870"
},
{
"issuedTime": "2026-08-14T11:43:06.343101Z",
"forecastRanges": [
{
"value": 18.296808242797852,
"forecastStartTime": "2026-08-12T00:00:00Z",
"forecastEndTime": "2026-08-13T00:00:00Z"
},
{
"value": 18.161813735961914,
"forecastStartTime": "2026-08-13T00:00:00Z",
"forecastEndTime": "2026-08-14T00:00:00Z"
},
{
"value": 17.758865356445312,
"forecastStartTime": "2026-08-14T00:00:00Z",
"forecastEndTime": "2026-08-15T00:00:00Z"
},
{
"value": 18.120830535888672,
"forecastStartTime": "2026-08-15T00:00:00Z",
"forecastEndTime": "2026-08-16T00:00:00Z"
},
{
"value": 18.998016357421875,
"forecastStartTime": "2026-08-16T00:00:00Z",
"forecastEndTime": "2026-08-17T00:00:00Z"
},
{
"value": 19.132926940917969,
"forecastStartTime": "2026-08-17T00:00:00Z",
"forecastEndTime": "2026-08-18T00:00:00Z"
},
{
"value": 19.049474716186523,
"forecastStartTime": "2026-08-18T00:00:00Z",
"forecastEndTime": "2026-08-19T00:00:00Z"
},
{
"value": 18.921628952026367,
"forecastStartTime": "2026-08-19T00:00:00Z",
"forecastEndTime": "2026-08-20T00:00:00Z"
}
],
"gaugeId": "hybas_2120410870"
}
]
}
}
}
