Cómo importar datos de tablas

Cómo subir recursos de tablas

Puedes usar el Administrador de recursos o la interfaz de línea de comandos (CLI) para subir conjuntos de datos en formato Shapefile o CSV. (Consulta Cómo importar datos ráster para obtener detalles sobre cómo importar archivos ráster con el editor de código o la CLI). Los activos que subas inicialmente serán privados, pero se pueden compartir como se describe en la sección para compartir activos.

Advertencia: Todos los datos vectoriales de Earth Engine se almacenan en un sistema de coordenadas esféricas (específicamente, EPSG:4326). Cuando se suben datos, la transformación de coordenadas resultante puede tener consecuencias no deseadas, como el cambio de tipo de geometría (p.ej., de polígono a línea o punto) o la georeferenciación incorrecta. Para minimizar la posibilidad de cambios no deseados, primero vuelve a proyectar los datos vectoriales a EPSG:4326 antes de subirlos.

Sube un archivo Shapefile

Para subir un archivo Shapefile desde el editor de código, haz clic en el botón y, luego, selecciona Shape files en la sección Table Upload. Aparecerá un diálogo de carga similar al de la Figura 1. Haz clic en el botón SELECT y navega a un archivo Shapefile o ZIP que contenga un Shapefile en tu sistema de archivos local. Cuando selecciones un archivo .shp, asegúrate de seleccionar los archivos .dbf, .shx y .prj relacionados. Earth Engine usará de forma predeterminada las coordenadas WGS84 (longitud y latitud) si no se proporciona un archivo .prj. Si subes un archivo ZIP, asegúrate de que contenga solo un archivo Shapefile (conjunto de archivos .shp, .dbf, .shx, .prj, etc.) y que no haya nombres de archivo duplicados. Asegúrate de que los nombres de archivo no incluyan puntos adicionales. (Los nombres de archivo incluirán un solo punto antes de la extensión).

Asigna a la tabla un ID de activo apropiado (que aún no exista) en la carpeta del usuario. Haz clic en SUBIR para comenzar la carga.

Figura 1: Diálogo de carga de Shapefile del Administrador de recursos. Ten en cuenta que los archivos .shp, .dbf y .shx son obligatorios. Los otros archivos secundarios son opcionales. Si no se proporciona el archivo .prj, se supone que es WGS84.

Sube un archivo CSV

Para subir un archivo CSV desde el editor de código, activa la pestaña Recursos, haz clic en el botón y selecciona Archivo CSV en la sección Carga de tablas. Aparecerá un diálogo de carga similar al de la Figura 2. Haz clic en el botón SELECT y navega a un archivo .csv en tu sistema de archivos local. Asigna a la tabla un nombre de ID de activo único y relevante. Haz clic en Aceptar para comenzar la carga.

Figura 2: Diálogo de carga de archivos CSV del Administrador de recursos.

El archivo CSV debe contener una fila para cada componente y tantas columnas como propiedades o variables haya para el conjunto de componentes. Si los componentes son geoespaciales, deben tener una ubicación geográfica definida por una cadena de geometría (GeoJSON, WKT) o propiedades de posición x e y. Si el archivo CSV es una exportación de un GIS o una herramienta de datos geoespaciales, como GDAL/OGR, ya debería existir una columna de geometría con el formato y el nombre correctos. Como alternativa, se pueden definir dos columnas para las coordenadas x e y que representan las ubicaciones de los puntos en una aplicación de hoja de cálculo y exportarlas como formato CSV junto con cualquier otra variable.

Opciones avanzadas

En la sección Opciones avanzadas del diálogo de carga, consulta y cambia la configuración predeterminada. Para mejorar el rendimiento de Earth Engine, se pueden dividir las geometrías que tienen una gran cantidad de vértices. Earth Engine no permite componentes con más de 1 millón de vértices. Durante la carga de tablas, Earth Engine dividirá automáticamente las geometrías que tengan más de 1 millón de vértices. Puedes especificar un valor más bajo para mejorar el rendimiento de la renderización de vectores.

Earth Engine intentará detectar una columna de geometría principal y asumirá que la proyección de los datos es WGS84, a menos que se especifique lo contrario. El estado geodésico de las geometrías se determina según la interpretación predeterminada de los bordes de la proyección determinada (p.ej., WGS84 usa geometrías geodésicas), pero esto se puede anular en el menú de configuración avanzada. Si la geometría de tus datos son puntos definidos por columnas x e y, asegúrate de nombrar las columnas correspondientes como "longitud" y "latitud", o bien especifica los nombres de las columnas x e y en la configuración avanzada.

Nota: Las columnas de tipos de datos mixtos (p.ej., números y cadenas) se establecerán de forma predeterminada en cadena durante la transferencia. Esta es una consideración importante cuando se prepara una tabla en una aplicación de hoja de cálculo, en la que es común indicar los datos faltantes como NA, Null, None, --, etc. En el caso de los datos faltantes, deja la "celda" vacía.

Cómo hacer un seguimiento del progreso de la carga

Después de iniciar una carga de tabla, se agrega una tarea de transferencia de activos al Administrador de tareas, que se encuentra en la pestaña Tasks en el lado derecho del editor de código. Para verificar el estado de la carga, haz clic en el ?. que aparece cuando colocas el cursor sobre la tarea. Para cancelar una carga, haz clic en el ícono giratorio junto a la tarea. Una vez que se complete la transferencia, la celda de la tarea se volverá azul y el recurso aparecerá en la carpeta del usuario, en la pestaña Recursos, con un ícono .

Límites de carga de tablas

Cuando subas tablas, la cantidad máxima de componentes es de 100 millones. La cantidad máxima de propiedades en un componente es de 1,024. Estos límites garantizan que el activo resultante se pueda consultar de manera eficiente. Además, cada componente tiene una cantidad máxima de vértices, como se explica en la sección "Opciones avanzadas" anterior.

Cómo cargar un recurso de tabla en tu secuencia de comandos

Para crear un FeatureCollection en tu secuencia de comandos a partir de un recurso de tabla, impórtalo como se describe en la página Cómo administrar recursos.