Puedes usar el Administrador de recursos o la interfaz de línea de comandos (CLI) para subir imágenes o otros conjuntos de datos de ráster georeferenciados en formato GeoTIFF o TFRecord. (Consulta Cómo importar datos vectoriales para obtener detalles sobre cómo importar vectores con el editor de código).
Sube recursos de imagen
GeoTIFF
En el editor de código, puedes subir archivos de imagen GeoTIFF de hasta 10 GB de tamaño a tu carpeta de usuario de Earth Engine. (Para archivos más grandes, usa la opción de carga de línea de comandos).
Para subir un GeoTIFF con el editor de código, selecciona la pestaña Recursos en la esquina superior izquierda, haz clic en el botón y, luego, selecciona Subir imagen. Earth Engine presenta un diálogo de carga que debería ser similar al de la Figura 1. Haz clic en el botón SELECT y navega a un GeoTIFF en tu sistema de archivos local.
Asigna a la imagen un ID de activo adecuado (que aún no exista) en la carpeta del usuario. Si deseas subir la imagen a una carpeta o colección existente, antepone el ID del recurso con el ID de la carpeta o colección, por ejemplo, projects/myproject/folder-or-collection-id/new-asset
.
Haz clic en SUBIR para comenzar la carga.

Una vez que hayas iniciado la carga, aparecerá una tarea de "Transferencia de activos" en la pestaña Tasks, en el lado derecho del editor de código. Si colocas el cursor sobre la tarea en el Administrador de tareas, se muestra un ícono de ?. que puedes usar para verificar el estado de la carga. Para cancelar una carga, haz clic en el ícono giratorio junto a la tarea. Una vez que se complete la transferencia, el activo aparecerá en tu carpeta de usuario con un ícono .
Compresión GeoTIFF
Los archivos GeoTIFF se pueden comprimir con DEFLATE, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP o ZSTD.
Recomendaciones para obtener la mejor experiencia de carga de archivos grandes:
- Mejor opción: ZSTD ofrece un buen equilibrio entre velocidad y compresión.
- Evitar: LZMA puede ser muy lento a pesar de una buena compresión.
- Archivos sin comprimir: Se generarán archivos más grandes y tiempos de carga más largos.
- Compresión con pérdida (p.ej., JPEG): Puede alterar los valores de píxeles. Usa compresión sin pérdida (p.ej., DEFLATE, LZMA, LZW, ZSTD) en lugar de con pérdida, a menos que comprendas el posible impacto en tus datos.
TFRecord
Para subir una imagen desde un archivo TFRecord, debes tener el archivo del mezclador asociado que se generó cuando exportaste las imágenes en las que realizaste la inferencia. Consulta la página de exportación para obtener detalles sobre el archivo del mezclador. Más precisamente, para importar predicciones (como una imagen) realizadas en imágenes exportadas,
- Exporta imágenes a uno o más archivos TFRecord.
- Realiza inferencias en las imágenes (es decir,
model.predict()
). - Escribe el resultado de
model.predict()
en un archivo TFRecord. Las predicciones deben estar en el mismo orden que las exportaciones de imágenes en las que realizaste la inferencia. El orden se puede aplicar mediante una clasificación de los nombres de archivo que genera la exportación. Consulta la sección de exportaciones de archivos grandes para obtener más detalles. - Sube los archivos TFRecord y el mezclador asociado a Earth Engine.
Edición de propiedades
Para editar los metadatos de activos, especifica una o más propiedades de metadatos. En el menú Properties, haz clic en Add property para definir un nombre y un valor de propiedad (Figura 2). El valor puede ser una cadena o un número.
Ingresa cadenas sin comillas. Para dar formato a un número como una cadena, ingresa una comilla simple ('
) antes del número.
De forma predeterminada, se agrega una propiedad system:time_start
sin valor. Earth Engine usa esta propiedad cuando aplica los filtros de fecha ImageCollection
. Ingresa una fecha en el formato que se muestra en la Figura 2 o un número que represente los milisegundos desde el 1 de enero de 1970. (consulta
el glosario para obtener más información sobre las marcas de tiempo en Earth Engine).
El Administrador de recursos interpreta un número ingresado como el valor de una propiedad llamada system:time_start
o system:time_end
como milisegundos y le aplica el formato de fecha.
Haz clic en el ícono
para quitar una propiedad.Opciones avanzadas
En el menú Advanced, elige la política de piramidización y el modo de enmascaramiento para tus datos.
La política de piramidización especifica cómo Earth Engine genera versiones de resolución más baja de la imagen. Obtén más información sobre cómo Earth Engine controla varias resoluciones en el documento de escala. Elige una política de piramidización "Promedio", "Mínimo" o "Máximo" para calcular los niveles de resolución más bajos de la pirámide de imágenes como el promedio, el mínimo o el máximo de cada grupo de 2 × 2 de píxeles de resolución más alta. Esta es una opción adecuada para imágenes de valor continuo. Para datos categóricos (p.ej., cobertura de la tierra) o de control de calidad, elige una política de piramidización de "Muestra" (el píxel superior izquierdo) o "Modo" (el valor que se produce con mayor frecuencia, o una muestra si no hay un modo).
El modo de enmascaramiento indica cómo se enmascara la imagen subida (si es que se enmascara). Para especificar un valor sin datos, selecciona "Valor sin datos" y, luego, ingresa el valor. Los píxeles con este valor se enmascararán en la imagen que se subió. Este valor se aplica a cada banda de la imagen de forma independiente. Para usar la última banda de la imagen como una máscara para las otras bandas de la imagen, selecciona "Usar última banda como banda alfa". La banda alfa debe ser una banda de 8 bits sin firmar en la que 0 es la máscara de datos (completamente transparente) y 255 es completamente opaco.
Cargas en mosaico
Para subir una sola imagen como varias tarjetas, en las que cada tarjeta se almacena en un archivo fuente diferente, haz clic en Agregar otro archivo para agregar archivos adicionales a la carga. Earth Engine combinará las tarjetas para crear una sola imagen en tu carpeta de usuario.
Hay algunas restricciones en los tipos de archivos que se pueden subir a un activo de imagen. En particular:
- Las imágenes deben tener la misma cantidad de bandas, profundidad de bits, proyección, resolución y valores de relleno.
- El desplazamiento de un archivo al siguiente debe ser un múltiplo entero del tamaño del píxel.
- Los espacios entre las tarjetas se rellenarán con píxeles enmascarados en la imagen final, por lo que, lo ideal es que las tarjetas sean adyacentes y no estén distribuidas de forma dispersa. No se transferirán las imágenes con espacios que ocupen más del 99% del área de la imagen.