NICFI Basemaps in GEE

last updated: September 09, 2021

Overview

The Planet & NICFI Basemaps for Tropical Forest Monitoring Google Earth Engine (GEE) Integration directly hosts the NICFI Basemaps in GEE so that you can access them just as you access other GEE datasets.

Access NICFI Basemaps in GEE

To access the NICFI Basemaps in Google Earth Engine, you must:

  1. Have a GEE account. You can use this form to apply for a GEE account if you don’t already have one.
  2. Have signed up & agreed to the terms for NICFI at planet.com/nicfi

If you are a new NICFI user, you should be able to apply for NICFI access & GEE access using the additional field “What is your GEE identity” at planet.com/nicfi.

If you are already a NICFI user and would like to access the Basemaps in GEE, you can apply for access using this sign up page.

Note that it may take up to one week for you to be granted access to the data in GEE after you submit your application. You will receive a welcome email once access has been granted.

FAQ

Which NICFI Basemaps are available in GEE?

PlanetScope Tropical Normalized Analytic Biannual and PlanetScope Tropical Normalized Analytic Monthly series Basemaps.

The Planet & NICFI Basemaps are available via data description pages below.

https://developers.google.com/earth-engine/datasets/catalog/projects_planet-nicfi_assets_basemaps_africa

https://developers.google.com/earth-engine/datasets/catalog/projects_planet-nicfi_assets_basemaps_asia

https://developers.google.com/earth-engine/datasets/catalog/projects_planet-nicfi_assets_basemaps_americas

How are the Basemaps organized in GEE?

The NICFI Basemaps are organized by the major rainforest regions (Amazon, Congo, and Indonesia) into 3 regional Image Collections: Tropical Americas, Tropical Africa, and Tropical Asia.

Bi-annuals and monthlies are included in the same regional Image Collections

projects/planet-nicfi/assets/basemaps/africa
projects/planet-nicfi/assets/basemaps/asia
projects/planet-nicfi/assets/basemaps/americas

To add a single mosaic from the collection to your map:

var imageCollection = ee.ImageCollection('projects/planet-nicfi/assets/basemaps/africa');

Map.addLayer(imageCollection.first(), {gain: 0.15, bands:["R", "G", "B"]})

How can I filter the Basemaps by date?

The PlanetScope Tropical Normalized Analytic Monthly series Basemaps are stored as images in the Image Collections representing a single month in time. That means, e.g., the July 2021 Normalized Analytic Basemap has a start date of 2021-07-01 and an end date on the first of the following month: 2021-08-01. Running a date filter for a specific time period within this month, will not return any results (e.g., between 2021-08-02 and 2021-08-19). Also remember the the filterDate options makes use of the start date and checks if it is within the date range provided

The key is that the start of the month must be included in your query. Here’s another example:

var filter_collection = planet_collection.filterDate
('2020-09-02', '2020-10-02')

Will only return the Basemap for October. To return both September and October, your filter should be formatted like:

var filter_collection = planet_collection.filterDate
('2020-09-01', '2020-10-02')

Where can I find additional information about the NICFI Basemaps?

Please reference the NICFI User Guide FAQ, or check out the links on our Resource Center.

How quickly will new NICFI Basemaps be available in GEE?

NICFI Basemaps may not reach GEE as quickly as they reach the Planet Platform. Planet expects new monthly or bi-annual Basemaps to reach GEE within one week of publication on the Planet Platform.

Can I share this Basemap with others colleagues within or outside of my organization?

Users are permitted to share data in compliance with the NICFI end user licensing agreement (EULA) terms. Direct access to the NICFI Basemap Image Collections in GEE is gated by Planet so that we can ensure users who gain access have signed the NICFI EULA as such these collections will not appear while searching the Public Catalog.

Planet will soon open a public form for users to request access to the Basemaps and verify that they’ve signed the NICFI license.

Can I access the Basemap Source Scenes in GEE?

The source scenes are not directly accessible within GEE, however, Planet does have a scene delivery integration that NICFI users are welcome to use to directly deliver their imagery scenes to GEE.

To identify which scene intersects a specific point in a Planet Basemap, you can use the inspector tool in Planet’s GIS integrations (ArcGIS & QGIS) or use the Basemap API or the Planet Basemap viewer.

Where do I go if I have a question or need support?

For questions you can reach out to Planet here nicfi-basemaps-gee@planet.com

Find help and additional tools for using GEE here.

How to Video