Skip to content


Switch branches/tags

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-lulc.js

Release History

  • 1.0.0
    • Access and download data using user's vector
  • 1.1.0
    • Updated for collection 4.0
  • 1.1.1
    • Updated assets
  • 1.1.2
    • New transitions periods
  • 1.1.3
    • Updated for collection 4.1
  • 1.3.0
    • Updated for collection 5.0
    • Export a csv file with areas per classe and year
  • 1.3.1
    • Loads mapbiomas-chaco collection 2.0
  • 1.3.2
    • Loads mapbiomas-brazil collection 5.0 quality
  • 1.4.0
    • Loads mapbiomas-atlantic-forest collection 1.0
  • 1.5.0
    • Loads mapbiomas-pampa collection 1.0
  • 1.6.0
    • Loads mapbiomas-brazil collection 6.0
  • 1.7.0
    • Loads mapbiomas-amazon collection 3.0

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.




A repository for MapBiomas data accessing in Google Earth Engine






No packages published