Flood Forecasting API

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:

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:

  1. Create a Google Cloud Account
  2. Create an API key

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 in the following countries: Albania, Angola, Antigua and Barbuda, Argentina, Armenia, Australia, Austria, Azerbaijan, Bahamas, Bangladesh, Barbados, Belarus, Belgium, Belize, Bolivia, Bosnia and Herzegovina, Botswana, Brazil, Brunei Darussalam, Bulgaria, Burkina Faso, Burundi, Cabo Verde, Cambodia, Cameroon, Canada, Central African Republic, Chad, Chile, Colombia, Comoros, Congo, Costa Rica, Croatia, Cuba, Czech Republic, Denmark, Djibouti, Dominica, Dominican Republic, Ecuador, El Salvador, Equatorial Guinea, Eritrea, Estonia, Eswatini, Fiji, Finland, France, French Guiana, Gabon, Gambia, Georgia, Germany, Ghana, Greece, Grenada, Guatemala, Guinea, Guinea-Bissau, Guyana, Haiti, Holy See, Honduras, Hungary, Iceland, India, Indonesia, Ireland, Israel, Italy, Ivory Coast, Jamaica, Kazakhstan, Kenya, Kiribati, Kyrgyzstan, Lao People's Democratic Republic, Latvia, Lesotho, Liberia, Lithuania, Madagascar, Malawi, Malaysia, Mali, Malta, Mauritania, Mauritius, Mexico, Moldova, Montenegro, Mozambique, Myanmar, Namibia, Nauru, Nepal, Netherlands, New Caledonia, New Zealand, Nicaragua, Nigeria, North Macedonia, Norway, Pakistan, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Poland, Portugal, Qatar, Romania, Rwanda, Saint Kitts and Nevis, Saint Lucia, Saint Vincent and the Grenadines, Samoa, Sao Tome and Principe, Saudi Arabia, Senegal, Serbia, Sierra Leone, Singapore, Slovakia, Slovenia, Solomon Islands, Somalia, South Africa, South Sudan, Spain, Sri Lanka, Suriname, Sweden, Switzerland, Taiwan, Tajikistan, Thailand, Timor-Leste, Tonga, Trinidad and Tobago, Turkey, Turkmenistan, Tuvalu, Ukraine, United Arab Emirates, United Kingdom, United States of America, Uruguay, Uzbekistan, Vanuatu, Venezuela, Vietnam, Yemen, Zambia, Zimbabwe.

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.