Earth Engine se ejecuta en Google Cloud y requiere proyectos de Cloud para el acceso y la administración de la API. Todas las llamadas a Earth Engine (ya sea desde el Editor de código, las bibliotecas cliente, las Apps o la API de REST) se enrutan a través de un proyecto de Cloud, lo que permite el control de acceso, la administración de recursos y la supervisión del uso en la consola de Cloud.
Obtén acceso a Earth Engine
Para usar Earth Engine, necesitarás acceso a un proyecto de Cloud que cumpla con los siguientes requisitos:
- Tiene habilitada la API de Earth Engine.
- está registrado para uso comercial o no comercial
- te otorga (o le otorga al usuario) los roles y permisos correctos.
Crea un proyecto
Visita la página de registro para crear y registrar un proyecto de Cloud nuevo o registrar uno existente.
Los proyectos creados durante el proceso de registro se pueden administrar en la consola de Google Cloud. Puedes activar o desactivar la API de Earth Engine desde la página de la API de Earth Engine en la consola de Cloud.
Pasos manuales (automatizados por la página de registro)
Crea un proyecto de Cloud
Si aún no lo hiciste, crea un proyecto de Google Cloud. Puedes hacerlo desde la página de proyectos de Cloud Console o hacer clic en el siguiente botón:
Crea un proyecto de CloudHabilita la API de Earth Engine
Para habilitar la API de Earth Engine en tu proyecto, haz clic en el siguiente botón para ir a la página de la API de Earth Engine:
Habilita la API de Earth EngineEn la página de la API de Earth Engine, asegúrate de haber seleccionado tu proyecto y haz clic en el botón HABILITAR.
Registra el proyecto para uso comercial o no comercial
Edita la siguiente URL para tu proyecto, visita la página y completa el flujo de registro.
https://code.earthengine.google.com/register?project=my-project
Crea una carpeta de recursos (opcional)
Puedes crear una carpeta de recursos de Earth Engine asociada a un proyecto de Cloud al que tengas acceso con el comando
earthengine create folder usando una ruta de acceso como se describe aquí.
Por ejemplo:
earthengine create folder projects/my-project/assets/También puedes crear una carpeta de recursos para un proyecto en el Editor de código agregando el proyecto en el panel Recursos.
No es necesario que crees esta carpeta, a menos que planees almacenar recursos en el proyecto.
Usa un proyecto existente
Consulta al personal de TI de tu organización sobre los proyectos de Cloud existentes configurados para Earth Engine. Asegúrate de que la Cuenta de Google que usarás para acceder a los servicios de Earth Engine tenga los roles y permisos correctos en el proyecto.
Especifica un proyecto
En las siguientes secciones, se describe cómo especificar un proyecto para las distintas interfaces de los servicios de Earth Engine.
Bibliotecas cliente (Python y JavaScript)
La función ee.Initialize() se usa para especificar un proyecto para las solicitudes de Earth Engine que se originan en las bibliotecas cliente de Python y JavaScript. Existen varias formas de configurar la especificación del proyecto. Consulta la página de autenticación e inicialización para obtener más detalles.
Editor de código
Haz clic en el ícono de perfil en la esquina superior derecha del Editor de código y selecciona "Cambiar proyecto de Cloud" en el menú. Elige un proyecto en el diálogo de selección.
Apps de Earth Engine
Cuando publiques una app de Earth Engine, se te pedirá que selecciones un proyecto a través del cual enrutar las solicitudes. Sigue las instrucciones del diálogo de publicación.
Herramienta de línea de comandos
Para asociar las llamadas de Earth Engine desde la herramienta de línea de comandos con un proyecto de Cloud, usa el parámetro --project en tu llamada a earthengine o usa set_project para establecer un proyecto predeterminado.
API de REST
Para asociar las llamadas a la API de REST con un proyecto de Cloud, emite llamadas HTTP autenticadas en las que oauth2 controla la autenticación. En un entorno local, puedes usar el comando gcloud. También puedes usar una cuenta de servicio asociada a un proyecto de Cloud. Consulta la Guía de inicio rápido de la API de REST para ver un ejemplo del uso de google.oath.service_account.Credentials.from_service_account_file() para autenticarse con una cuenta de servicio.
Configura el acceso al proyecto
En las siguientes secciones, se describe cómo configurar proyectos habilitados para Earth Engine para que los usen otras personas y cuentas de servicio.
Cuentas de servicio
Las cuentas de servicio tienen acceso automáticamente una vez que se registra su proyecto principal y se habilita la API de Earth Engine. También deben tener los permisos correctos dentro del proyecto. Se puede configurar cualquier cantidad de cuentas de servicio en un proyecto para usar Earth Engine. Visita la página de cuentas de servicio para obtener más información sobre el uso de cuentas de servicio con Earth Engine.
Cuentas de Google
Los proyectos de Cloud usan Cloud IAM para administrar roles y permisos. Para que otras personas puedan acceder a Earth Engine a través de tu proyecto, deberás usar la consola de Cloud para otorgarles los roles y permisos correctos.
ID de cliente de OAuth 2.0
Es posible que debas crear un ID de cliente de OAuth 2.0 desde un proyecto, por ejemplo, para crear una app que pase credenciales de usuario a Earth Engine. Para administrar las credenciales de tu proyecto de Cloud, ve al menú de la consola de Cloud () y selecciona APIs y servicios > Credenciales. (Elige el proyecto si se te solicita).
Para crear un ID de cliente nuevo para el proyecto, haz clic en + CREAR CREDENCIALES > ID de cliente de OAuth > Aplicación web.
En la configuración de la aplicación web, haz lo siguiente:
- Especifica orígenes de JavaScript autorizados, por ejemplo:
http://localhost:8080
https://foo-ee-project.appspot.com
- Especifica los URIs de redireccionamiento autorizados, por ejemplo:
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback
Obtén más información para autenticar usuarios con OAuth.
Situaciones comunes
Estoy dando una clase educativa…
¡Genial! Si registras un proyecto no comercial, no se requiere ninguna configuración de facturación. Luego, puedes agregar a tus estudiantes al proyecto.
Soy parte de un equipo operativo o de una organización comercial…
¡Genial! Puedes registrar un proyecto para uso comercial y agregar a tus colaboradores. También presta atención al límite de licencias en la suscripción a Earth Engine que selecciones.
Eliminación de datos de Earth Engine
Eliminación a nivel de la cuenta
La eliminación a nivel de la cuenta quitará todos los datos de Earth Engine de tu cuenta.
Si tu cuenta forma parte de una organización de Google Workspace, tu administrador controla los datos de la cuenta. Cuando un administrador borra una Cuenta de Google, todos los datos asociados de Earth Engine se borran en un plazo de aproximadamente 30 días.
El equipo de Earth Engine no puede recuperar los datos una vez que se borran.
Proyectos de Cloud
Cuando se borra un proyecto de Cloud, se activa el borrado de los datos de Earth Engine asociados a ese proyecto (incluidos, por ejemplo, los recursos almacenados en la raíz del proyecto, las EE Apps a nivel del proyecto, los datos de supervisión, etc.). Este proceso puede ser reversible durante un máximo de 30 días, pero nunca es posible recuperar esos datos después de ese plazo.
Recursos
El método más sencillo para borrar tus recursos es usar la pestaña "Recursos" del editor de código para ver y borrar manualmente tus recursos de Earth Engine.
Para borrar de forma programática un activo con el ID projects/{project-id}/assets/{asset-id} (p.ej., projects/my-project/assets/my-asset):
Cliente de Python
ee.data.deleteAsset('projects/my-project/assets/my-asset')
Cliente de JavaScript
Ten en cuenta que el sandbox de seguridad del editor de código impide que esta llamada funcione en ese entorno.
ee.data.deleteAsset('projects/my-project/assets/my-asset')
Herramienta de línea de comandos
Usa el comando rm:
earthengine rm projects/my-project/assets/my-assetSecuencias de comandos del editor de código
Para borrar tus secuencias de comandos del editor de código de Earth Engine, haz lo siguiente:
Editor de código
En la pestaña"Scripts" del editor de código, selecciona una secuencia de comandos o un repositorio y bórralo. Una vez que un repositorio se marca como eliminado, no se puede recuperar en un plazo de 30 días.
Usa Git
Los usuarios avanzados pueden usar Git para administrar sus secuencias de comandos. Consulta https://earthengine.googlesource.com/ para ver la lista de repositorios que puedes consultar.
Apps de Earth Engine
Para borrar tus Apps de Earth Engine, usa el botón"Apps" en el editor de código para administrarlas.
Referencias de "Obtener vínculo"
Usa la página Administrar vínculos para ver y borrar tus vínculos de "Obtener vínculo" del editor de código. Para encontrar esta página, navega a la opción"Administrar vínculos" en el menú desplegable junto al botón "Obtener vínculo".
Cómo configurar el acceso no comercial
Para configurar el acceso no comercial (sin cargo) a Earth Engine para tu proyecto, deberás completar el cuestionario de registro en la consola de Cloud para confirmar la elegibilidad de tu proyecto.
Verificación
Dado que Earth Engine otorga acceso sin cargo a una gran cantidad de recursos de procesamiento, Google requiere la verificación de cada proyecto registrado para el acceso no comercial. El proceso de verificación se realiza como parte del registro. Si completas el cuestionario de verificación y se determina que tu proyecto es comercial, no podrás usar Earth Engine sin pagar.
A partir del 26 de septiembre de 2025, todos los proyectos no comerciales deberán haber completado el cuestionario en Cloud Console. Te recomendamos que completes el proceso de verificación lo antes posible. Si no tomas medidas antes del 26 de septiembre de 2025, se pausará el acceso de tu proyecto a Earth Engine hasta que completes el proceso de verificación.
Nueva verificación
Todos los proyectos con acceso no comercial deberán volver a verificarse periódicamente para mantener el acceso.
Configura el acceso comercial
Para configurar el acceso comercial (pagado) a Earth Engine para tu proyecto, deberás configurarlo en la página de registro y elegir un plan en la cuenta de facturación.
Finalización del acceso comercial
Si eres cliente directo de Earth Engine y quieres dejar de usarlo en un contexto pagado, debes realizar varios cambios para dejar de generar cargos:
Cómo detener los cargos de suscripción
- Para cancelar la suscripción a Earth Engine en tu cuenta de facturación, debes usar la página "Administrar planes" (a la que se puede acceder desde el menú desplegable de configuración del usuario en la esquina superior derecha del editor de código cuando usas un proyecto de Cloud registrado y vinculado a esa cuenta de facturación).
También puedes acceder directamente a la página "Administrar planes" de una cuenta de facturación:
https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_IDSi eliges el plan "Limitado", se detendrán los cargos en tu cuenta de facturación por las suscripciones a la plataforma de Earth Engine después de tu ciclo de facturación actual.
Cómo detener los cargos de procesamiento
- Para evitar cargos nuevos relacionados con el procesamiento (tiempo de EECU), inhabilita la API de Earth Engine en tus proyectos de Cloud. Ten en cuenta que esto no finaliza las solicitudes en curso ni borra los objetos almacenados, por lo que es posible que sigas incurriendo en cargos de Earth Engine incluso con la API inhabilitada.
- Consulta la Ayuda de la Consola de APIs para obtener información sobre cómo inhabilitar APIs.
Cómo detener los cargos de almacenamiento
- Los recursos almacenados de Earth Engine siguen generando costos incluso si la API está inhabilitada. Borrar tus recursos evita que incurras en más cargos por almacenamiento de EE.