Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
Stay organized with collections
Save and categorize content based on your preferences.
Welcome to the Google Earth Engine tutorial for working with the global surface water (GSW)
dataset. This dataset is described in the Nature letter
High-resolution mapping of global surface water and its long-term changes.
This tutorial provides examples of how to use Earth Engine to visualize data layers
available in the GSW dataset, and presents some typical visualizations and analyses.
The tutorial is broken up into sections. Within each section, code will be built up
gradually with short code snippets and explanatory text. At the end of each section, the
complete working script will be presented.
The GSW data described in this tutorial were produced under the
Copernicus Programme and
are provided free of charge, without restriction of use. For the full license information
see the Copernicus Regulation.
If you are using the data as a layer in a published map, please include the following
attribution text:
Get access to Earth Engine
Access to Earth Engine is free, but requires signup. To get access, please fill out our
Earth Engine signup form
to apply for an Evaluator account. Those granted access will receive an email within
a few business days with further instructions.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2021-05-26 UTC."],[[["\u003cp\u003eThis tutorial demonstrates how to use Google Earth Engine to work with the Global Surface Water (GSW) dataset, enabling visualization and analysis of surface water data.\u003c/p\u003e\n"],["\u003cp\u003eThe tutorial is structured in sections with gradual code snippets and explanations, culminating in complete working scripts for each section.\u003c/p\u003e\n"],["\u003cp\u003eUsers are expected to have prior experience with the Earth Engine Code Editor and API, as outlined in the prerequisites.\u003c/p\u003e\n"],["\u003cp\u003eThe GSW dataset, produced under the Copernicus Programme, is freely available with proper attribution to "Source: EC JRC/Google" when used in published maps.\u003c/p\u003e\n"],["\u003cp\u003eAccess to Earth Engine requires a free signup process through the provided form for an Evaluator account.\u003c/p\u003e\n"]]],["This tutorial demonstrates using Google Earth Engine to work with the global surface water (GSW) dataset. It provides examples for visualizing GSW data layers, and performing analyses, using code snippets and explanations in sections. The GSW data, created under the Copernicus Programme, is freely available. Users are instructed to use the Earth Engine Code Editor. Attribution \"Source: EC JRC/Google\" is required for published maps using the data. Access requires signup via the Earth Engine form.\n"],null,["Welcome to the Google Earth Engine tutorial for working with the global surface water (GSW)\ndataset. This dataset is described in the Nature letter\n[High-resolution mapping of global surface water and its long-term changes](https://www.nature.com/articles/nature20584.epdf?author_access_token=C5JSvooRop4jWxyp_qRPLNRgN0jAjWel9jnR3ZoTv0MqBuzCNsmw_DFxRd7sX93nfPzcbm_xTiPLlZMl7XrUhadm6EiT9cGdDNgn1s6EWrPWH3IeadLUjApplBoaS6xH).\nThis tutorial provides examples of how to use Earth Engine to visualize data layers\navailable in the GSW dataset, and presents some typical visualizations and analyses.\n\nThe tutorial is broken up into sections. Within each section, code will be built up\ngradually with short code snippets and explanatory text. At the end of each section, the\ncomplete working script will be presented.\n\nReferences\n\n- [High-resolution mapping of global surface water and its\n long-term changes](http://rdcu.be/nDd2) (online viewer)\n- [Get water governance on the global agenda](http://www.nature.com/news/get-water-governance-on-the-global-agenda-1.21104) (Nature editorial)\n- [Global Surface Water Explorer](https://global-surface-water.appspot.com/) (web application)\n- [Data Users Guide (v2)](https://storage.googleapis.com/global-surface-water/downloads_ancillary/DataUsersGuidev2.pdf)\n\nAudience\n\nThis tutorial assumes you are familiar with concepts presented in the\n[Earth Engine Code Editor](/earth-engine/guides/playground)\ndocumentation pages and have worked through the [Earth Engine API tutorial](https://developers.google.com/earth-engine/tutorial_api_01).\n\nLicense and Attribution\n\nThe GSW data described in this tutorial were produced under the\n[Copernicus Programme](http://www.copernicus.eu/) and\nare provided free of charge, without restriction of use. For the full license information\nsee the [Copernicus Regulation.](http://www.copernicus.eu/main/data-access/)\n\nIf you are using the data as a layer in a published map, please include the following\nattribution text:\n| **Attribution text:** \"Source: EC JRC/Google\"\n\nGet access to Earth Engine\n\nAccess to Earth Engine is free, but requires signup. To get access, please fill out our\n[Earth Engine signup form](https://earthengine.google.com/signup)\nto apply for an Evaluator account. Those granted access will receive an email within\na few business days with further instructions.\n\nOnce you're familiar with the Code Editor, [get started on the tutorial](/earth-engine/tutorials/tutorial_global_surface_water_02)!"]]