All data here is produced under the Copernicus Programme and is provided free of charge, without restriction of use. For the full license information see the Copernicus Regulation.
Publications, models and data products that make use of these datasets must include proper acknowledgement, including citing datasets and the journal article as in the following citation.
Jean-Francois Pekel, Andrew Cottam, Noel Gorelick, Alan S. Belward, High-resolution mapping of global surface water and its long-term changes. Nature 540, 418-422 (2016). (doi:10.1038/nature20584)
If you are using the data as a layer in a published map, please include the following attribution text: 'Source: EC JRC/Google'
For a description of all of the datasets and details on how to use the data please see the Data Users Guide.
All of the datasets that comprise the Global Surface Water 1984-2021 are being made freely available using the following delivery mechanisms: Global Surface Water Explorer, Data Download, Google Earth Engine and Web Map Services. These are described in the following sections.
The Global Surface Water Explorer is a simple web-mapping tool that shows all of the water datasets and allows users to navigate the globe visualizing the water datasets without installing any software. It also allows users to view the complete history of water detections over the 37-year period by clicking on the map. The tool is intended as a data viewer and does not provide any analytical features - if you would like to do your own analysis on the data then access the data using Data Download or Google Earth Engine. Explore the map.
Currently all of the mapped datasets are available to download (i.e. occurrence, change, seasonality, recurrence, transitions and maximum extent). The water history datasets and metadata datasets will be made available in the near future.
The Global Surface Water data are available to download in tiles 10°x10° from the map shown below. Click on the tile to show a list of the available datasets. Each one of these datasets is a hyperlink to the *.tif file.
The full global surface water datasets can be downloaded by using this Python 2 script or using this Python 3 script . The zip file contains the Python script and a set of instructions for using it. An handy alternative way to download this data is to use the following script wrote by Petr Tsymbarovich, available at this GitHub link.
It is possible to download all the Global Surface Water Datasets via FTP using the Filezilla Client . Once downloaded and installed Filezilla, write in the Host field the link jeodpp.jrc.ec.europa.eu and then browse to GSWE folder to get all the Global Surface Water Explorer data. Alternatively, it is possible to get the data using the link https://jeodpp.jrc.ec.europa.eu/ftp/jrc-opendata/GSWE/
Each of the downloadable files contains a colormap which will display the files in desktop GIS tools (such as QGIS or ArcGIS) using the symbology that has been used in the Global Surface Water Explorer. However, these colormaps do not contain the labels for the values. These can be added to the files by using the following symbology files. For instructions on how to use these files see the 'Using Symbology Files' section of the Data Users Guide.
Dataset | QGIS | ArcGIS |
---|---|---|
Occurrence | occurrence.qml | occurrence.tif.lyr |
Occurrence change intensity | change.qml | change.tif.lyr |
Seasonality | seasonality.qml | seasonality.tif.lyr |
Recurrence | recurrence.qml | recurrence.tif.lyr |
Transitions | transitions.qml | transitions.tif.lyr |
Maximum water extent | extent.qml | extent.tif.lyr |
There are also symbology files where the above palettes are unsuitable for users with deuteranopia colour-blindness:
Dataset | QGIS | ArcGIS |
---|---|---|
Occurrence change intensity | change_deuteranopia.qml | change_deuteranopia.tif.lyr |
Transitions | transitions_deuteranopia.qml | transitions_deuteranopia.tif.lyr |
There are no symbology files for the monthly or the yearly water history as files are encoded and must be decoded before they can be mapped.
The downloadable files do not contain any metadata information and so it is provided here for each of the datasets. You may need to right click and Download Linked file.
Dataset | ISO 19139 Metadata file |
---|---|
Occurrence | occurrence.xml |
Occurrence change intensity | change.xml |
Seasonality | seasonality.xml |
Recurrence | recurrence.xml |
Transitions | transitions.xml |
Maximum water extent | extent.xml |
The new 2021 Data are available in the Google Earth Engine data catalog
Tutorials for using the Global Surface Water Dataset in Google Earth Engine are available here.
The data can also be accessed and used in the Google Earth Engine platform - for more information see here. The following asset ids are used in Google Earth Engine:
Dataset | Asset ID 1984-2015 | Asset ID 1984-2018 | Asset ID 1984-2019 | Asset ID 1984-2020 | New Asset ID 1984-2021 |
---|---|---|---|---|---|
Map layers | JRC/GSW1_0/GlobalSurfaceWater | JRC/GSW1_1/GlobalSurfaceWater | JRC/GSW1_2/GlobalSurfaceWater | JRC/GSW1_3/GlobalSurfaceWater | JRC/GSW1_4/GlobalSurfaceWater |
Yearly Seasonality | JRC/GSW1_0/YearlyHistory | JRC/GSW1_1/YearlyHistory | JRC/GSW1_2/YearlyHistory | JRC/GSW1_3/YearlyHistory | JRC/GSW1_4/YearlyHistory |
Monthly History | JRC/GSW1_0/MonthlyHistory | JRC/GSW1_1/MonthlyHistory | JRC/GSW1_2/MonthlyHistory | JRC/GSW1_3/MonthlyHistory | JRC/GSW1_4/MonthlyHistory |
Monthly Recurrence | JRC/GSW1_0/MonthlyRecurrence | JRC/GSW1_1/MonthlyRecurrence | JRC/GSW1_2/MonthlyRecurrence | JRC/GSW1_3/MonthlyRecurrence | JRC/GSW1_4/MonthlyRecurrence |
Metadata | JRC/GSW1_0/Metadata | JRC/GSW1_1/Metadata | JRC/GSW1_2/Metadata | JRC/GSW1_3/Metadata | JRC/GSW1_4/Metadata |
The Global Surface Water data can also be used within other websites or GIS clients by using what are called 'Web Map Services'. These services provide a direct link to the cached images that are used in the Global Surface Water Explorer and are the best option if you simply want to map the data and produce cartographic products. They are not suitable for analysis as the data are represented only as RGB images.
The Web Map Services can also be used within websites using any Javascript Mapping API that supports tiled layer types. The examples below show you how to create and add the transitions layer in Leaflet v1.0 and then ArcGIS Javascript API v3.18. The layer type can be one of: transitions, occurrence, change, seasonality, recurrence or extent.
Leaflet:var transitions = new L.tileLayer("https://storage.googleapis.com/global-surface-water/tiles2021/transitions/{z}/{x}/{y}.png", { format: "image/png", maxZoom: 13, errorTileUrl : "https://storage.googleapis.com/global-surface-water/downloads_ancillary/blank.png", attribution: "2016 EC JRC/Google" }); map.addLayer(transitions);ArcGIS Javascript API:
var transitions = new WebTiledLayer("https://storage.googleapis.com/global-surface-water/tiles2021/transitions/{level}/{col}/{row}.png", { "copyright" : '2016 EC JRC/Google' }); map.addLayer(transitions);
The Web Map Services are available in the ESRI ArcGIS Online platform as a set of WMTS layers. To see a list of the datasets, search for 'GSW'.
If you have any feedback on the Global Surface Water data please contact: jrc-surfacewater@ec.europa.eu