Repository navigation
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.
- 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.
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).
- 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.
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.
-
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.
-
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).
-
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.
-
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.
-
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.
-
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).
-
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.
-
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')ormo_init("your-project-id"), afterearthengine authenticate(Python package, R package). -
Command line and MCP:
--project your-project-idor the environment variableEE_PROJECT(Step-by-step installation). - Earth Engine app: it does not need it; it always computes with the project of MonitorEO.
| 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.
- Registration in Earth Engine: https://code.earthengine.google.com/register
- Code Editor: https://code.earthengine.google.com
- Project configuration: https://console.cloud.google.com/earth-engine/configuration
- Official access guide: https://developers.google.com/earth-engine/guides/access
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.
MonitorEO es un resultado del Proyecto EVEREST (PID2023-151939OB-I00), financiado por MICIU/AEI 10.13039/501100011033 y cofinanciado por FEDER – Unión Europea, y del Proyecto NevadEO (C-EXP-074-UGR23), cofinanciado por el Programa FEDER 2014-2020 y la Consejería de Economía, Conocimiento, Empresa y Universidades de la Junta de Andalucía. Es también un resultado del Proyecto PRESINMED (Preserving the singularity of Mediterranean high-mountain biodiversity hotspots: a NBS approach, PCI 2025-163175) de la convocatoria Biodiversa+ NBS 2023.
MonitorEO is an output of the EVEREST Project (PID2023-151939OB-I00), funded by MICIU/AEI 10.13039/501100011033, and co-funded by ERDF – European Union, as well as of the NevadEO Project (C-EXP-074-UGR23), co-funded by the ERDF 2014-2020 Program and the Regional Ministry of Economy, Knowledge, Enterprise, and Universities of the Regional Government of Andalusia. It is also an output of the PRESINMED Project (Preserving the singularity of Mediterranean high-mountain biodiversity hotspots: a NBS approach, PCI 2025-163175) of the Biodiversa+ NBS 2023 call.
OBSNEV, Universidad de Granada · GPL-3.0-or-later



Empezar
Herramientas
Ayuda
Start
Tools
- Earth Engine app
- QGIS plugin
- MCP: Claude and other assistants
- Python package
- R package
- Results viewer
Help