Earth Engine se ejecuta en Google Cloud y requiere proyectos de Cloud para el acceso y la administración de APIs. 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 habilita 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 a ti (o al usuario) los roles y permisos correctos.
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 (la página de registro los automatiza)
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 la consola de Cloud 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 ENABLE.
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 con un proyecto de Cloud
al que tienes acceso con el comando
earthengine create folder
mediante 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. Para ello, agrega el proyecto en el panel Recursos.
No es necesario que crees esta carpeta, a menos que planees almacenar recursos en el proyecto.
Consulta con el 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 diversas 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 provienen de las bibliotecas cliente de Python y JavaScript. Existen varias formas de configurar la especificación del proyecto. Para obtener más información, consulta la página de autenticación e inicialización.
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 del diálogo de selección.
Apps de Earth Engine
Cuando publiques una app de Earth Engine, se te pedirá que selecciones un proyecto para enrutar las solicitudes. Sigue las instrucciones que aparecen en el 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 llamadas a la API de REST con un proyecto de Cloud, emite llamadas HTTP autenticadas en las que oauth2 controle la autenticación. En un entorno local, puedes usar el comando gcloud. También puedes usar una cuenta de servicio
asociada con 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.
Cómo configurar el acceso al proyecto
En las siguientes secciones, se describe cómo configurar proyectos compatibles con 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 su proyecto superior está registrado y tiene habilitada la API de Earth Engine. También necesitan 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 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 accedan 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 a partir de 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ú Cloud Console () y selecciona APIs y servicios > Credenciales. (Elige el proyecto si se te solicita).
Para crear un nuevo ID de cliente para el proyecto, haz clic en + CREATE CREDENTIALS > OAuth client ID > Web application.
En la configuración de la aplicación web, haz lo siguiente:
- Especifica los orígenes autorizados de JavaScript, 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 dictando una clase educativa…
¡Genial! Si registras un proyecto no comercial, no es necesario que configures la 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, el administrador controla los datos de tu cuenta. Cuando un administrador borra una Cuenta de Google, todos los datos asociados de Earth Engine se borran en un plazo aproximado de 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 la eliminación de los datos de Earth Engine asociados con ese proyecto (incluidos, por ejemplo, los recursos almacenados en la raíz del proyecto, las apps de EE a nivel del proyecto, los datos de supervisión, etcétera). Este proceso puede revertirse 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” en el editor de código para ver y borrar manualmente tus recursos de Earth Engine.
Para la eliminación programática de un recurso con el ID projects/{project-id}/assets/{asset-id} (p.ej., projects/my-project/assets/my-asset):
ee.data.deleteAsset('projects/my-project /assets/my-asset ')
Ten en cuenta que la zona de pruebas de seguridad del Editor de código impide que esta llamada funcione en ese entorno.
ee.data.deleteAsset('projects/my-project /assets/my-asset ')
Usa el comando rm:
earthengine rm projects/my-project /assets/my-asset Secuencias de comandos del editor de código
Para borrar tus secuencias de comandos del editor de código de Earth Engine, haz lo siguiente:
En la pestaña “Secuencias de comandos” del editor de código, selecciona una secuencia de comandos o un repositorio y bórralos. Una vez que un repositorio se marca como borrado, no se puede recuperar en un plazo de 30 días.
Los usuarios avanzados pueden usar Git para administrar sus secuencias de comandos. Consulta https://earthengine.googlesource.com/ para ver una lista de los repositorios que puedes ver.
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 los vínculos "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".
Rescisió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 por 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 puedes acceder desde el menú desplegable de configuración del usuario en la parte superior derecha del editor de código cuando usas un proyecto de Cloud registrado 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_ID Si eliges el plan “Limitado”, se evita que tu cuenta de facturación incurra en más cargos de suscripción a la plataforma de Earth Engine después de tu ciclo de facturación actual.
Cómo dejar de calcular los cargos
- 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 debas pagar cargos de Earth Engine incluso con la API inhabilitada.
- Consulta la Ayuda de la Consola de API para obtener información sobre cómo inhabilitar las APIs.
Cómo detener los cargos de almacenamiento
- Los recursos almacenados de Earth Engine siguen generando costos, incluso si la API está inhabilitada. Si borras tus recursos, evitarás generar más tarifas de almacenamiento de EE.