Skip to content
A repository for MapBiomas data accessing in Google Earth Engine
JavaScript QML
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
misc transitions table description Nov 8, 2019
LICENSE Initial commit Aug 29, 2019 transitions table description Nov 8, 2019
mapbiomas-user-toolkit-download-municipios.js fix region bug export to drive Nov 13, 2019
mapbiomas-user-toolkit-download-uc-ti-bacias.js update transitions periods Nov 8, 2019
mapbiomas-user-toolkit-download.js fix region bug export to drive Nov 13, 2019

MapBiomas User Toolkit

João Siqueira


User Toolkit to download MapBiomas data with Google Earth Engine. This tutorial is about the script mapbiomas-user-toolkit-download.js

Release History

  • 1.0.0
    • Access and download data using user's vector
  • 1.1.0
    • Updated to collection 4.0
  • 1.1.1
    • Updated assets
  • 1.1.2
    • New transitions periods

Video tutorial (pt-br)

MapBiomas Brasil | Solved Scholar | Luis Sadeck

How to use

1. Getting the code

Access the repository directly in Google Earth Engine. The repository will appear at Reader Session of your scripts tab.

Markdown Monster icon

2. Create a MAPBIOMAS folder

  • Go to the Assets tab and click on the New menu. Then choose the Folder option.
  • Select your primary account if you have others linked to your structure. In this example, we see the mapbiomas account, but your structure will apper like this: users/MYACCOUNT. Examples: users/mary/, users/joao/, users/john/, users/tyler/.
  • Create a MAPBIOMAS folder (all capital letters) in your assets structure.

Markdown Monster icon

3. Upload a new table asset

  • In GEE vectors are called tables.
  • Access the menu New > Table upload to add a table.
  • Press the SELECT button to choose your shapefile. Browse to the file on your computer.
  • Remember to use files with the extension .shp, .shx, .prj, and .dbf. Alternatively, you can compress them into a zip file to upload.
  • Note that you must enter the MAPBIOMAS folder name to add the file directly within this folder.
  • Click on OK to start the upload task.

Markdown Monster icon

  • The table will appear inside the MAPBIOMAS folder. Press the refresh button to view all your new files.
  • You can also move/copy a table asset from elsewhere in your structure into the MAPBIOMAS folder.

Markdown Monster icon

4. Accessing the data

  • Run the script now. Open it in Code Editor and click the Run button.

Markdown Monster icon

  • Select a table or choose one of the default tables.

Markdown Monster icon

  • The table (vector) will be loaded on the map.
  • In the Properties menu, select the attribute (column name) that will identify each of the vector polygons.

Markdown Monster icon

  • In the Features menu, select the polygon name you want to work with.

Markdown Monster icon

  • The toolkit will zoom into the selected polygon.
  • It is possible to apply a buffer between 1 and 5 km. This buffer will only have effect on data export.

Markdown Monster icon

  • Select from the Layers menu the years you want to view and export. Layers are active in the menu and appear in the default list of layers in the Code Editor.

Markdown Monster icon

5. Exporting data

  • To export the data to your Google Drive, click the Export images to Google Drive button. Go to Tasks tab and click the RUN button.

Markdown Monster icon

  • A confirmation box will pop up. Choose the Drive option and click the Markdown Monster icon button.

Markdown Monster icon

  • Now just wait for the images to be saved to your Google Drive.
  • A MAPBIOMAS-EXPORT folder will be created in your Google Drive root and all the mapbiomas data that you exported will be there.

6. Apply the MapBiomas color palette.

7. Transitions dates.


You can’t perform that action at this time.