Joint Research Centre
Global Surface Water - Data Access

License

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.

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'

Data Users Guide

For a description of all of the datasets and details on how to use the data please see the Data Users Guide.

Delivery Mechanisms

All of the datasets that comprise the Global Surface Water 1984-2015 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.

Global Surface Water Explorer

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 32 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.

Data Download

Currently all of the mapped datasets are available for 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.

Download process

Individual 10°x10° files

The Global Surface Water data are available for 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.

Full dataset

The full global surface water datasets can be downloaded by using this Python script. The zip file contains the Python script and a set of instructions for using it.

Supporting files

Symbology

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 website. 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.

DatasetQGISArcGIS
Occurrenceoccurrence.qmloccurrence.tif.lyr
Occurrence change intensitychange.qmlchange.tif.lyr
Seasonalityseasonality.qmlseasonality.tif.lyr
Recurrencerecurrence.qmlrecurrence.tif.lyr
Transitionstransitions.qmltransitions.tif.lyr
Maximum water extentextent.qmlextent.tif.lyr

There are also symbology files where the above palettes are unsuitable for users with deuteranopia colour-blindness:

DatasetQGISArcGIS
Occurrence change intensitychange_deuteranopia.qmlchange_deuteranopia.tif.lyr
Transitionstransitions_deuteranopia.qmltransitions_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.

Metadata

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.

DatasetISO 19139 Metadata file
Occurrenceoccurrence.xml
Occurrence change intensitychange.xml
Seasonalityseasonality.xml
Recurrencerecurrence.xml
Transitionstransitions.xml
Maximum water extentextent.xml

Google Earth Engine

Tutorials for using the Global Surface Water Dataset in Google Earth Engine are available here.

Asset ids

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:

DatasetAsset ID
Map layersJRC/GSW1_0/GlobalSurfaceWater
Yearly SeasonalityJRC/GSW1_0/YearlyHistory
Monthly HistoryJRC/GSW1_0/MonthlyHistory
Monthly RecurrenceJRC/GSW1_0/MonthlyRecurrence
MetadataJRC/GSW1_0/Metadata

Web Map Services

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.

Desktop GIS

Websites

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/maptiles/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/maptiles/transitions/{level}/{col}/{row}.png",
    { "copyright" : '2016 EC JRC/Google' });
    map.addLayer(transitions);
    

ArcGIS Online

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'.

Contact

If you have any feedback on the Global Surface Water data please contact: jrc-surfacewater@ec.europa.eu