Google Earth Engine¶

To download the data, blackmarble-ntl-toolkit uses Xee, which makes requests to Google Earth Engine for data. To use Earth Engine, you'll need to create and register a Google Cloud project, authenticate with Google, and initialize the service.

Note

if you're having trouble creating the project, refer to the Earth Engine Authentication and Initialization guide.

1. Create a Project¶

Follow instructions in the Earth Engine Access guide to create and register a Google Cloud project.

2. Authenticate¶

With Environment Variable¶

Google needs to know who is accessing Earth Engine to determine what services are available and what permissions are granted. The goal of authentication is to establish credentials that can be used during initialization. To do that, you need to specify the project name. For that purpose we use an environment variable. You can create an .env file and inside the file, set your project ID:

# Earth Engine Project ID required for authentication and retrieval
GOOGLE_CLOUD_PROJECT="your-google-cloud-project-id"

Alternatively, you can export it directly in your terminal:

export GOOGLE_CLOUD_PROJECT="your-google-cloud-project-id"

In Python¶

You can also specify it in your python script:

import os
os.environ["GOOGLE_CLOUD_PROJECT"] = "your-google-cloud-project-id"

from blackmarble_toolkit.utils import initialize_ee
initialize_ee()