Set up your Earth Engine enabled Cloud Project

To access the Earth Engine API without using either the Code Editor, command line tool, or Python client API (i.e., by calling ee.Authenticate()) to authenticate, you will need to have a Google Cloud Project and enable the Earth Engine API for that project. This applies to:

  • Using a service account for authentication.
  • Using a Client ID to identify your app and pass user credentials.
  • Using the REST API.
  • Creating an App Engine app that uses Earth Engine.

In order to make calls to Earth Engine in any of these situations, you may need to perform the steps described in the following sections.

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:

Apply for Earth Engine

Create a Cloud project

If you haven't already, create a Google Cloud Project. You can do so from the projects page of the Cloud Console or click 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:

Enable the Earth Engine API

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 and register a service account

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.

Create OAuth 2.0 Client ID

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 () and selecting APIs & Services > Credentials. (Choose the project if prompted).

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 JavaScript origins, for example:
    http://localhost:8080
    https://foo-ee-project.appspot.com
    
  • Specify authorized redirect URIs, for example:
    http://localhost:8080/oauth2callback
    https://foo-ee-project.appspot.com/oauth2callback
    

Learn more about authenticating users with OAuth.