Skip to content

Earth Engine account

Bea-Cazorla edited this page Nov 18, 2026 · 1 revision

Versión en español

How to create your Google Earth Engine account

Step by step: from the Google account to your first script, in some 10–15 minutes.

Google Earth Engine (GEE) is a Google platform to analyse satellite images and other geospatial data in the cloud (Landsat, Sentinel, MODIS, elevation models, climate…). To use it you need a Google account and a Google Cloud project registered in Earth Engine.

Do you need it to use MonitorEO? No: without an account of your own, MonitorEO computes with its shared account, and the Earth Engine app is used in the browser without an account. With yours, the computations count against the quota of your project, you can export to Google Drive and you keep computing when you have spent your research EECUs of the shared account (Getting started). You also need it to write your own Earth Engine scripts.

1. Before you start

What you need

  • A Google account. A Gmail account works, or a Google account created with your institutional email (at https://accounts.google.com/signup → «Use my current email address instead»). If you work in a public administration, Google requires the institutional Google account of your body.
  • An up-to-date browser. Chrome works best with the Earth Engine code editor.

Non-commercial and commercial use

When you register, Google asks what use you will make of it:

Use For Price
Non-commercial Teaching, learning and research (bachelor's and master's theses, PhD theses, papers…), NGOs, personal non-profit use Free
Commercial Paid work for companies, consulting, selling products and services Paid

This guide registers a non-commercial project, that of research and teaching. A public administration can use Earth Engine for free only for academic research: operational management, internal testing and commissioned work need a commercial project (Google's terms; more in Getting started).

Two concepts you will see

  • Google Cloud project: the «container» your access to Earth Engine, your computing quota and your data belong to.
  • Project ID: its unique name, for example ee-namesurname. You will use it in your code and in MonitorEO, and it cannot be changed later.

2. Registration step by step

The screens are usually in English and Google changes them from time to time: if you see something slightly different, look for the equivalent option.

  1. Go to the registration page. Open https://code.earthengine.google.com/register and sign in with your Google account. If you have several accounts open in the browser, check at the top right that you are in the right one, or use an incognito window.

  2. Choose the non-commercial use. When it asks how you will use Earth Engine, choose Unpaid usage (Noncommercial) and, as the type of project, the academic or research one (for example, Academia & Research).

  3. Create your Google Cloud project. Choose Create a new Google Cloud Project and type a project ID: 6 to 30 characters, only lower-case letters, digits and hyphens, starting with a letter (for example, ee-namesurname). Accept the terms of service and continue.

    Write down the ID of your project: you will need it in the code (ee.Initialize(project='…')) and in MonitorEO.

    Some institutional accounts cannot create projects: if you get a permission error, ask the Google administrator of your body to let you create them or to create the project; for your personal use or as a student, a personal Google account works.

  4. Confirm the registration. Check the summary and click Confirm. The Earth Engine API is enabled in your project by itself, and access is granted at once.

  5. Fill in the verification questionnaire. Google asks every non-commercial project for a short questionnaire (type of institution, intended use…). If it does not appear at the end of the registration, fill it in at https://console.cloud.google.com/earth-engine/configuration. The verification is renewed once a year: when it is due, Google will tell you to confirm it again.

  6. Keep the Community quota tier. If it asks for the quota tier, choose Community (the default one): it is free, needs no card and gives 150 EECU-hours of computing a month, enough to start. If you need more later, you can move to Contributor (1000 EECU-hours a month), which asks for a billing account although Google does not charge for non-commercial use (Concepts).

  7. Check that everything works.

    • In the Code Editor (JavaScript). Open https://code.earthengine.google.com, click the icon of your profile (top right) → Change Cloud Project and choose your project. Paste this code in a new script and click Run:

      // Quick test: the SRTM digital elevation model
      var dem = ee.Image('USGS/SRTMGL1_003');
      Map.setCenter(-3.31, 37.05, 11);   // Sierra Nevada (Granada)
      Map.addLayer(dem, {min: 1000, max: 3400}, 'Elevation (m)');
      print('Earth Engine works!');

      If you see the elevation map and the message in the console, you are done.

    • From Python. Install the library with pip install earthengine-api (it comes with MonitorEO) and run:

      import ee
      ee.Authenticate()                            # only the first time: the browser opens
      ee.Initialize(project='your-project-id')     # the ID you wrote down in step 3
      print(ee.String('Earth Engine works!').getInfo())

      ee.Authenticate() saves your credentials on the computer; after that, ee.Initialize(project='…') at the start of each script is enough.

3. Your project in MonitorEO

The credentials are saved once per computer and work for every tool (Getting started):

  • QGIS: type the ID in Project and click Authenticate…, which opens the browser to sign in (QGIS plugin).
  • Assistant for managers: in the settings, Use my Google account and the ID in Your project (optional) (Assistant).
  • Python and R: mo.init('your-project-id') or mo_init("your-project-id"), after earthengine authenticate (Python package, R package).
  • Command line and MCP: --project your-project-id or the environment variable EE_PROJECT (Step-by-step installation).
  • Earth Engine app: it does not need it; it always computes with the project of MonitorEO.

4. Troubleshooting

Problem What to do
It does not let me create a project (permission error) Your institutional account has restrictions: ask the Google administrator of your body for permission or, for your personal use or as a student, use a personal account.
«Not signed up for Earth Engine or project is not registered» Register the project at https://code.earthengine.google.com/register?project=YOUR-ID.
In Python, ee.Initialize() gives a project error Always give your project: ee.Initialize(project='your-project-id').
The Code Editor uses another project Profile icon → Change Cloud Project → choose yours.
At the end of the month everything is very slow You have spent the monthly quota and the project computes more slowly; it is renewed on the 1st of each month (Concepts).

More problems of MonitorEO in Troubleshooting.

Useful links

Guide written from the official documentation of Google Earth Engine, read in November 2026. Google may change the process: if something does not match, the official documentation prevails.

Clone this wiki locally