This guide helps you get your Cloud Project set up for use with Earth Engine. To make Earth Engine calls with a Google Cloud Project, you will need to have a Google account, have a Google Cloud Project and enable the Earth Engine API for that project. You need a Cloud Project enabled with Earth Engine to:
- Use a service account for authentication.
- Use the REST API.
- Use a Client ID to identify your app and pass user credentials.
- Create an App Engine app that uses Earth Engine.
Apply to use Earth Engine
In order to use Earth Engine you must be registered. If you are not already registered, apply for Earth Engine by clicking the following button:
Create a Cloud project
You can manage your Google Cloud projects from the Google Cloud Console.
Enable the Earth Engine API
To enable the Earth Engine API for your project, click the following button to go to the Earth Engine API page:
On the Earth Engine API page, click ENABLE.
You can manage your APIs for a Cloud project from the APIs & Services page of the Google Cloud Console.
Create an assets folder (optional)
You can create an Earth Engine assets folder associated with a Cloud Project
to which you have access using the
earthengine create folder
command using a path like:
earthengine create folder projects/my-ee-enabled-project-id/assets/
Create and register a service account (optional)
You may need to create a service account from your project, for example to create an app that authenticates to Earth Engine on behalf of users. Follow the instructions on this page to create, register and test a service account for use with Earth Engine.
If the service account is to make computations using the REST API, you also need to give it project level permission, specifically the Earth Engine Resource Viewer role and the Service Usage Consumer role.
Create OAuth 2.0 Client ID (optional)
You may need to create an OAuth 2.0 Client ID from the project, for example to create an app that passes user credentials to Earth Engine. You can manage credentials for your Cloud project by going to the Cloud Console menu (Credentials. (Choose the project if prompted).) and selecting APIs & Services >
To create a new Client ID for the project, click + CREATE CREDENTIALS > OAuth client ID > Web application.
In the configuration of the web application:
- Specify authorized redirect URIs, for example: