The Flood Forecasting API provides an interface to access real time riverine flood forecasts, which is also available on the Flood Hub.
For historical data, refer to our publicly available datasets:
- Inundation History dataset which contains information on water occurancy around the world (1999 - 2020)
- Google Runoff Reanalysis & Reforecast dataset (GRRR) global river discharge estimates (1980-2023)
For more details about the research and publications underlying the datasets, visit our website. The data exposed by this API is under the CC BY 4.0 license and offered at no charge.
API access
To get started, fill out the waitlist form
to join the waiting list. Once approved, we'll send you an email. If you've already received your approval email, reply to it with your Google Cloud Project ID (more details below).
The Flood Forecasting API is public and offered at no charge. Accessing the Flood Forecasting API requires an API key and enabling the Flood Forecasting API.
Once you have an API key and have enabled the Flood Forecasting API, you can verify API access by running this colab notebook.
API keys
If you use Google Cloud or other Google Developer services, you can use those existing API keys
or make a new one.
If you don't have any Google API keys, you will need to:
Enable Flood Forecasting API
To enable the Flood Forecasting API, navigate to the Flood Forecasting API page and click the Enable button.If you cannot access this page, it likely means you have not yet been added as a Service Consumer. First, verify that you are logged in with the correct email address you provided to us. If you are using the correct email address and still lack access, reply to your approval email for assistance.
For more general information about enabling APIs, see this guide.
Coverage
The API provides access to Google's flood forecasts for the following countries (represented in ISO-3166-1 Alpha-2): AO, AR, AT, AU, AZ, BD, BE, BF, BG, BO, BR, BW, BY, BZ, CA, CD, CF, CG, CH, CI, CL, CM, CO, CR, CZ, DE, DK, EC, EE, ES, FI, FR, GB, GE, GH, GM, GN, GR, GT, GW, GY, HN, HU, ID, IE, IN, IS, IT, KE, KG, KH, KZ, LA, LK, LR, LS, LT, LV, MD, MG, ML, MM, MW, MX, MY, MZ, NA, NG, NI, NL, NO, NP, NZ, PE, PG, PH, PK, PL, PT, PY, RO, RS, RW, SE, SI, SK, SL, SN, SO, SR, SS, TD, TH, TJ, TR, UA, US, UY, UZ, VE, VN, ZA, ZM, ZW.
Feedback
If you find any issue or bug, submit this bug form. Make sure to include a concise description of the issue, a clear way to reproduce it, and the expected behavior. For feature requests and general feedback, fill this feedback form. As a part of the pilot, the flood forecasting team will be meeting with participants that want to share feedback, use cases or need support in implementation. Reply to your approval email if you would like to set a meeting with the team.