Planet order#

Order imagery from Planet Lab mosaics

This dasboard application, based on the SEPAL-UI framework, provides users with an interface to explore and download Planet Lab images.


To start this module, sign up for NICFI and connect your GEE account to SEPAL.

On the landing page of our module, in the lower left of the window, you will find three buttons:

  • : Opens the GitHub repository that is used to create this module in a new tab (our code is open-source and distributed under the MIT license).

  • : Leads to the Wiki page.

  • : Opens the Issue tracker of our GitHub repository in a new tab (you can write here if you experience bugs or if you have any feature requests; the SEPAL team will answer as quickly as possible).


In the lower-right corner, two tabs are available:

  • : Planet Lab area of interest (AOI) selection

  • : Planet Lab authentification

In the upper-left corner, three other tabs will allow you to interact with data:

  • : the Planet order manager

  • : Colour management

  • : Download pane

Select an AOI#

The application uses the same AOI selector that you will find in many other SEPAL applications (for more information, see the Module AOI section).

Planet Lab authentication#

To authenticate the user, complete the form in the second tab with either your credentials or a Planet API key, which you can find in the Settings section in your Planet profile page. Once the values are set, select Validate. If your Planet credentials are valid, the NICFI button should turn green. You can now select a mosaic from the provided list.


If you’re not yet registered to Planet, please follow the documentation for signing up for Planet Lab data.

Manage orders#

In the upper-left section, the Planet order selector is now activated. You can select any mosaic in the mosaic dropdown list above the map; use the next or prev button to go to the next or previous mosaic in the list (they are in chronological order).

Once a mosaic is selected, the module will display basemaps on the map.

Manage color combination#

Select on the upper-left side of the map, which will show the different colour combinations available, including:

  • Red-green-blue (RGB)

  • Color-infrared (CIR)

  • Normalized difference vegetation index (NDVI)

  • Normalized difference water index (NDWI)

  • Visual atmosphere resistance index (VARI)

  • Modified soil-adjusted vegetation index (MSAVI2)

  • Modified triangular vegetation index (MTVI2)

  • Triangular greenness index (TGI)

Selecting one will update the displayed basemap.


More information about band combination can be found on the Planet documentation page.

Download data#

Once you are satisfied with your mosaic selection, you can select the button, which will launch the download process of your images from the Planet server to your folders.

The images will be stored in the following folder: ~/module_results/planet-order/<aoi_name>/<mosaic_name>/.


In the parent folder (/home/<sepalID>/module_results/planet-order/<aoi_name>/), you will find a .geojson file of the Planet grid, which can be useful for other tools.


If the requested image is not available (e.g. the grid points to water area, the image was too cloudy and filtered by Planet, you don’t have the rights to download it, etc.) the image will fail.

If the image already exists in your folder, it will be skipped. This behaviour allows you to restart a process if your SEPAL connection crashes without needing to restart all downloads.

Last updated on Dec 19, 2023.