Apps de Earth Engine

Introducción

Las apps de Earth Engine son interfaces de usuario dinámicas que se pueden compartir para los análisis de Earth Engine. Con las apps, los expertos pueden usar elementos simples de la IU para aprovechar el catálogo de datos y el poder analítico de Earth Engine, tanto para expertos como para no expertos.

Se puede acceder a las apps publicadas desde Earth Engine a través de la URL específica de la aplicación que se genera en el momento de la publicación. No se requiere una cuenta de Earth Engine para ver una app publicada o interactuar con ella. Las apps que su creador selecciona como destacadas también están disponibles en una galería de apps específica del usuario (p.ej., USERNAME.users.earthengine.app).

Cómo compilar tu app

Las apps de Earth Engine pueden aprovechar la mayoría de las mismas funciones que se usan en el editor de código, con algunas excepciones. Además, diseñamos la API de la interfaz de usuario pensando en los desarrolladores de apps. Si es la primera vez que usas la API de interfaz de usuario, consulta la descripción general de la API de IU.

Cómo publicar tu app

Para publicar una app desde el editor de código, primero carga la secuencia de comandos que deseas convertir en una app y, luego, abre el panel de administración de apps, al que puedes acceder haciendo clic en el botón Apps que se encuentra sobre la sección de secuencias de comandos en el editor de código.

Botón Administrar apps
Botón Administrar apps

Luego, haz clic en el botón NUEVA APP.

Botón de la app nueva
Botón de la app nueva

En el cuadro de diálogo, elige el acceso de editor, un nombre de app, selecciona un proyecto de Google Cloud y especifica la ubicación del código fuente de la app. Restringe el acceso a esta app a un Grupo de Google en particular o mantenla accesible de forma pública con las opciones de la pestaña Restricción. En el caso de las apps de acceso público, también puedes proporcionar una imagen de vista previa personalizada para la app, así como una descripción en la pestaña Galería. Haz clic en "Destacar esta app en tu galería de apps" si quieres que aparezca en tu galería pública de apps disponible en USERNAME.users.earthengine.app. De manera opcional, puedes incluir un logotipo personalizado en la esquina superior izquierda de la app. Para ello, sube una imagen de tu elección desde la pestaña Logotipo.

Elige el acceso de edición
Elegir el acceso de edición: Elige quién puede editar la app.
Publica una app, un nombre y una URL
Publicar una app: Elige un nombre, un ID de app y un proyecto de Cloud.
Publica una app, código fuente
Publica una app: selecciona el código fuente de la app
Publica una app, detalles de la publicación
Publica una app: elige opciones como destacar la app en tu galería, restricciones de acceso y un logotipo personalizado

Administración de tus aplicaciones

Para administrar una app desde el editor de código, abre el panel de administración de apps haciendo clic en el botón Apps que se encuentra sobre la sección de secuencias de comandos en el editor de código. Desde aquí, puedes actualizar la configuración de tu app o borrarla.

Administrar aplicaciones
Administrar apps

Colabora con otras personas en apps que pertenecen al proyecto

De forma predeterminada, solo tú puedes editar las apps que publicas con tu nombre de usuario. La colaboración en las apps es posible con las apps que pertenecen al proyecto. Las apps de propiedad del proyecto son apps que pertenecen a un proyecto de Cloud y se publican en él. Cualquier persona que tenga el rol de IAM de publicador de apps de Earth Engine puede editar y borrar las apps publicadas en el proyecto de Cloud. Obtén más información sobre los roles de IAM de Earth Engine aquí.

Para habilitar las apps que pertenecen al proyecto, elige la opción Proyecto de Cloud en el paso "Elige el acceso de edición" y selecciona el proyecto de Cloud que quieras usar. Luego, finaliza el flujo de publicación de la app como de costumbre. La app se publicará en el dominio PROJECT-ID.projects.earthengine.app y cualquier persona que tenga el rol de IAM de publicador de apps de Earth Engine en el proyecto de Cloud podrá editarla.

Publica una app que pertenezca a un proyecto
Publica una app que pertenezca a un proyecto

Para ver las apps de un proyecto de Cloud, presiona el botón AGREGAR PROYECTO DE CLOUD y selecciona el proyecto de Cloud.

Agrega un proyecto de Cloud
Agregar un proyecto de Cloud

Para compartir el proyecto de Cloud con otras personas, presiona el botón COMPARTIR PROYECTO. Esto te llevará a la página de IAM de la consola de Cloud del proyecto, en la que puedes otorgarles a los colaboradores el rol de IAM de publicador de apps de Earth Engine.

Activa las apps que pertenecen al proyecto
Editar y borrar apps que pertenecen al proyecto

Preguntas frecuentes

¿Cómo quito una app de mi galería de apps?
La casilla de verificación "Destacar esta app" en la página de configuración de la app controla si una app aparece o no en la página Apps destacadas. No se pueden destacar las apps con acceso restringido.
¿Mi código de Earth Engine es visible?
Sí, para cualquier persona que pueda acceder a la app. Aunque no es claramente visible cuando se publica la app, es bastante fácil para alguien ver el código JavaScript de tu app observando el tráfico de red hacia su navegador web. En Chrome, por ejemplo, el JavaScript se verá en el panel de redes de las herramientas para desarrolladores.
¿Cuáles son algunas de las posibles causas del error "Se produjo un error cuando se cargaban algunas partes del mapa" en una app publicada?
Asegúrate de que todos los recursos de imagen o tabla que se usen en tu app se compartan de forma pública o con la app. En el diálogo para compartir recursos, selecciona la opción "Cualquier persona puede leer" o elige el nombre de la app de la lista desplegable. En el caso de las apps restringidas a un Grupo de Google, compartir un recurso con ese Grupo de Google no hará que la app pueda verlo. En cambio, los recursos se deben compartir con la app o de forma pública.
¿Por qué veo una página que dice "La app aún no está lista"?
Después de crear una app, es posible que la información tarde un poco en propagarse por el sistema. Por lo general, esto se resuelve en unos minutos. Si el error persiste, comunícate con nosotros para obtener ayuda.
¿Por qué se muestran en mi app las geometrías que dibujé?
Esto facilita la visualización de geometrías de referencia en tu app y te permite crear apps en las que los usuarios pueden editar las geometrías. Si no quieres que se muestren o editen geometrías específicas, puedes ocultar o bloquear capas de geometría individuales para evitar que los usuarios las vean o editen antes de publicar tu app. Consulta la documentación de las herramientas de geometría para obtener más información.
¿Qué es la cuota de la app?
Para evitar que las secuencias de comandos erróneas o que consumen muchos recursos afecten negativamente la disponibilidad del servicio, Earth Engine tiene cuotas de uso de la app para las consultas simultáneas. Esta cuota funciona de manera similar a la cuota por usuario de Earth Engine, excepto que la cuota está vinculada a la app, en lugar de a un usuario específico.
¿Cada app que creo tiene su propia cuota?
Sí, se asocia una cuota independiente a cada app. En el caso de las apps más antiguas creadas con una clave de API, la cuota está vinculada al proyecto de Cloud desde el que generas la clave de API de la app. Si generas varias claves de API desde el mismo proyecto de Cloud, todas compartirán la misma cuota de uso.
¿Por qué se requiere una cuenta de Facturación de Cloud? ¿Se me cobrará por mis apps?
Usamos Google Cloud Platform para una variedad de tareas internas. No se te cobrará por crear una app de Earth Engine. Sin embargo, Google Cloud Storage no es gratuito, por lo que, si decides exportar los resultados de tus análisis a Google Cloud Storage, es posible que se aplique una tarifa asociada.
¿Cómo puedo comprender mejor el uso y la cuota de mis apps?

Si se supera la cuota, Earth Engine puede mostrar errores HTTP 429: Too Many Requests. Por lo general, estos errores los controla la biblioteca cliente de Earth Engine, que unifica las solicitudes en una retirada exponencial y vuelve a intentar la consulta hasta que se completa correctamente. La biblioteca cliente de Earth Engine reintentará la solicitud cinco veces.

Si tu app se vuelve tan popular que muchos usuarios reciben errores de cuota excedida, verán un mensaje de advertencia, y es posible que Earth Engine deba restringir (temporalmente) el acceso a la app.

Para evitar recibir errores 429, te recomendamos que habilites el almacenamiento en caché para tu aplicación, por ejemplo, almacenando estadísticas agregadas que se puedan almacenar en caché como recursos de tablas de Earth Engine, en lugar de calcularlas sobre la marcha.