Listas de ubicaciones¶

Esta página le indica cómo crear, cambiar y eliminar una lista de ubicaciones.

Una lista contiene una o más ubicaciones, por ejemplo fincas o parcelas. La aplicación analiza cada ubicación de una lista. Para leer los resultados, consulte 03-analysis-and-results.md.

En esta página, un control o una etiqueta de la aplicación está en negrita. Un mensaje de la aplicación está entre "comillas dobles".

La página de listas¶

La página de listas tiene el título Listas de ubicaciones. Muestra una tabla con una fila para cada lista.

La tabla tiene estas columnas:

Nombre: el nombre de la lista. Seleccione el nombre para abrir la lista.
Ubicaciones: el número de ubicaciones de la lista.
Producto básico: el producto básico que usted dio para la lista. Si no dio ningún producto básico, la celda muestra "—".
Análisis: los análisis que la aplicación hizo para la lista.
Último procesamiento: la fecha del último análisis.
Creado: la fecha en que usted creó la lista.
Acciones: el menú de la lista (⋯).

Para ordenar la tabla, pulse el encabezado de una columna. Pulse el mismo encabezado otra vez para cambiar el sentido del orden.

Para buscar una lista, escriba una parte de su nombre o de su producto básico en el cuadro de búsqueda (Buscar listas por nombre o producto básico…). Si ninguna lista corresponde a su texto, la tabla muestra "Ninguna lista coincide con «…»". Si no tiene listas, la página muestra "No se encontraron listas".

Etiquetas de la tabla¶

Incompleta: el análisis no terminó para todas las ubicaciones de la lista. Ponga el puntero sobre la etiqueta para ver el número de ubicaciones que la aplicación analizó.
Hay datos más recientes: un conjunto de datos que usó la lista cambió después del último análisis. Consulte "Actualizar una lista" más abajo.
Actualizando: una actualización de la lista está en curso. La tabla muestra los resultados del análisis anterior hasta que la actualización está completa.

Cargas que no están completas¶

Si una carga no está completa, un aviso se muestra en la parte superior de la página de listas. Pulse Reanudar para volver a la carga. Si la carga espera su revisión, pulse Revisar.

Crear una lista nueva¶

Para empezar, pulse + Nueva lista en la página de listas. Se muestra la página Crear una lista nueva.

La página pregunta ¿Cómo desea añadir ubicaciones?. Seleccione uno de estos dos métodos:

Cargar un conjunto de ubicaciones: cargue un archivo que contiene una o más ubicaciones. Este es el método predeterminado.
Añadir una ubicación manualmente: escriba las coordenadas de una ubicación.

NOTA: Cambie de un método al otro solo antes de empezar. Cuando cambia el método, la aplicación borra los valores que usted escribió para el otro método.

NOTA: Si la aplicación muestra "Las cargas están desactivadas", la configuración del servidor detiene todas las cargas. Una instalación nueva de Docker le permite cargar archivos. Una instalación que usted actualizó conserva su archivo de configuración antiguo. Consulte 01-install-and-start.md.

Tipos de archivo aceptados¶

La aplicación acepta estos tipos de archivo:

Tipo de archivo	Extensión del nombre de archivo
CSV	.csv
Libro de Excel	.xlsx
GeoJSON	.geojson o .json
KML	.kml
Shapefile comprimido (zip)	.zip

La aplicación no acepta otros tipos de archivo. Por ejemplo, no acepta archivos KMZ (.kmz) ni archivos antiguos de Excel (.xls). Si usted carga un tipo de archivo diferente, la aplicación muestra "Tipo de archivo no compatible". Para usar un archivo KMZ, extraiga el archivo KML del archivo KMZ. Después cargue el archivo KML.

Archivos CSV y Excel¶

Un archivo CSV o Excel contiene una ubicación en cada fila. La primera fila debe contener los encabezados de las columnas. En un libro de Excel, la aplicación lee solo la primera hoja de cálculo.

Cada fila debe tener una latitud y una longitud en grados decimales. La latitud debe estar entre -90 y 90. La longitud debe estar entre -180 y 180.

La aplicación encuentra las columnas por sus encabezados. Reconoce estos encabezados. No tiene en cuenta las mayúsculas, las minúsculas, los espacios, los guiones ni los guiones bajos:

Latitud: latitude, lat, y, ycoord, ylat.
Longitud: longitude, lon, lng, long, x, xcoord, xlon.
Nombre de la ubicación: name, id, plotid, locationid, locationname, plot.

La columna de nombre es opcional. Un archivo CSV o Excel con columnas de latitud y longitud contiene puntos. Por eso, usted debe dar un tamaño para cada punto. Consulte "Tamaño de las ubicaciones puntuales" más abajo.

La aplicación también puede leer un polígono de una columna con el encabezado geometry, geom, wkt, thegeom o shape. Esta columna debe contener la forma como texto WKT, por ejemplo POLYGON((...)).

Archivos GeoJSON, KML y shapefile¶

Estos tipos de archivo contienen la forma de cada ubicación en el archivo. La página muestra "La geometría se leerá del propio archivo." Usted no define las columnas de coordenadas para estos archivos.

Un shapefile comprimido es un archivo .zip que contiene las partes del shapefile (.shp, .shx, .dbf y, si lo tiene, .prj). El archivo .zip debe contener un archivo .shp. No debe contener más de 256 archivos.

Puntos y polígonos¶

Una ubicación puede ser un polígono o un punto.

Un polígono muestra el límite de la ubicación. La aplicación analiza la superficie dentro del límite.
Un punto es una posición GPS. Para analizar una superficie alrededor de un punto, la aplicación debe conocer el tamaño de la superficie. Después, la aplicación crea un círculo alrededor del punto.

Un archivo puede contener puntos y polígonos juntos. Un tamaño tiene efecto solo en los puntos.

Cargar un archivo¶

Pulse Elegir archivo.
Seleccione el archivo en su equipo.
Asegúrese de que la página muestra el nombre correcto después de Archivo seleccionado.
Opcional: escriba un nombre en Nombre de la lista. Si no escribe un nombre, la aplicación usa el nombre del archivo.
Opcional: escriba un producto básico en Producto básico, por ejemplo "cacao".
Examine la sección Revise la asignación de campos. Consulte "Relacionar las columnas" más abajo.
Si el archivo contiene puntos, dé un tamaño. Consulte "Tamaño de las ubicaciones puntuales" más abajo.
Pulse Cargar y analizar.

NOTA: El botón Cargar y analizar no está disponible hasta que la página tiene todos los datos necesarios. Lea los mensajes de la página para saber qué es necesario.

Relacionar las columnas¶

Después de seleccionar un archivo, la aplicación relaciona las columnas de su archivo con los datos que necesita. Si la aplicación está segura de todas las relaciones, muestra "Hemos relacionado las columnas de su archivo con los campos que necesitamos. Revíselas antes de analizar."

Para ver o cambiar las relaciones, pulse Cambiar la asignación de campos. La tabla tiene estas columnas:

Necesitamos: los datos que necesita la aplicación, por ejemplo Latitud (norte–sur) y Longitud (este–oeste).
Columna de su archivo: la columna que contiene estos datos. Si la relación no es correcta, seleccione una columna diferente.
Valores de ejemplo: valores de su archivo.
Cómo se relacionó: por ejemplo Relacionada por el nombre, Relacionada con un alias conocido o Usted la eligió.

Si la aplicación no está segura de una relación, la etiqueta revise este campo se muestra junto a ella. Examine esa relación antes de continuar.

Si algunos ejemplos de latitud o de longitud están fuera del intervalo, la aplicación muestra una advertencia. Por ejemplo: "Algunos ejemplos de latitud están fuera de −90 a 90. Revise esta asignación." Normalmente, esto significa que las columnas de latitud y de longitud están en las posiciones incorrectas. Seleccione las columnas correctas.

Si un campo necesario no tiene columna, la aplicación muestra "Asigne los campos obligatorios antes de continuar:" y los nombres de los campos. Seleccione una columna para cada campo.

Cuando todos los campos necesarios tienen una columna, la aplicación muestra "Todos los campos obligatorios están asignados".

Si la aplicación no puede leer las columnas, muestra "No pudimos cargar la asignación de campos para este archivo." Pulse Reintentar. También puede pulsar Cargar y analizar sin una comprobación de las columnas.

Tamaño de las ubicaciones puntuales¶

Si el archivo contiene columnas de latitud y longitud, la aplicación muestra ¿Qué tamaño tiene cada ubicación?. Usted debe dar un tamaño antes de poder cargar.

Para un archivo GeoJSON, KML o shapefile, el tamaño es opcional. Pulse Mostrar opciones de tamaño para dar un tamaño. Si el archivo contiene puntos y usted no da un tamaño, la aplicación no crea círculos. Cada ubicación se queda como un punto.

PRECAUCIÓN: Asegúrese de que selecciona correctamente Superficie o Radio. Si selecciona el valor incorrecto, el círculo tiene un tamaño incorrecto y los resultados no son correctos.

En ¿Cómo se define el tamaño de cada ubicación?, seleccione uno de estos dos valores:
El mismo para todas las filas: un valor para todos los puntos.
Desde una columna del archivo: cada fila tiene su propio valor en una columna.
En ¿Se trata de una superficie o de un radio?, seleccione Superficie o Radio.
Si seleccionó El mismo para todas las filas, escriba el valor en Valor.
Si seleccionó Desde una columna del archivo, seleccione la columna en Columna.
Opcional: para analizar un anillo alrededor de cada ubicación, seleccione Añadir un anillo de amortiguación alrededor de cada ubicación.
Si seleccionó el anillo de amortiguación, escriba el ancho del anillo en Amortiguación.

Las unidades son:

Tamaño	Unidad	Límites
Superficie	hectáreas (ha)	Más de cero.
Radio	kilómetros (km)	Como mínimo 0.001 km (1 m). No más de 500 km.
Amortiguación	metros (m)	Un número entero, como mínimo 1 m. No más de 500,000 m.

La aplicación le indica el resultado del tamaño. Por ejemplo: "círculo 1.00 ha → radio ≈ 56.4 m". La aplicación no deduce la unidad ni el tipo de tamaño a partir del nombre de una columna.

NOTA: El anillo de amortiguación no incluye la propia ubicación. La aplicación analiza solo el anillo alrededor de la ubicación. Un anillo de amortiguación tiene efecto en los polígonos y en los puntos.

Proyección cartográfica¶

La aplicación necesita coordenadas en latitud y longitud WGS 84. Si las coordenadas parecen de un mapa proyectado, la aplicación muestra ¿Qué proyección cartográfica?. Entonces haga estos pasos:

En ¿Qué proyección usa este archivo?, seleccione la proyección de su archivo. La aplicación puede mostrar una proyección con el texto sugerida (coincide con sus coordenadas).
Pulse Cargar y analizar otra vez.

La aplicación usa su selección solo para esta carga. Puede seleccionar una de estas proyecciones: EPSG:4326, OGC:CRS84, EPSG:3857 y EPSG:24818.

Análisis y revisión¶

Después de cargar el archivo, la aplicación analiza cada ubicación. La página muestra "Analizando carga…" y el número de ubicaciones que la aplicación analizó.

Mientras el análisis está en curso, puede hacer una de estas acciones:

Pulse Cancelar para detener la carga. La aplicación no conserva la lista.
Pulse Detener y confirmar para detener el análisis. La aplicación conserva solo las ubicaciones que analizó. Si la aplicación no analizó todas las ubicaciones, la lista tiene la etiqueta Incompleta.

Cuando el análisis está completo, se muestra la página Revisar registros analizados. Muestra el número de Ubicaciones, Analizado correctamente y Errores. La tabla muestra cada ubicación con su Estado. Para una ubicación con el estado Error, la columna Explicación le indica la causa.

Examine la tabla.
Para conservar la lista, pulse Confirmar lista.
Para no conservar la lista, pulse Descartar.

Cuando la aplicación guarda la lista, se muestra la página Lista creada. Pulse Ver lista para abrir la lista, o pulse ← Volver a listas.

Añadir una ubicación manualmente¶

Seleccione Añadir una ubicación manualmente.
Escriba un nombre en Nombre. La aplicación usa este nombre para la lista y para la ubicación.
En ¿Cómo definirá la ubicación?, seleccione Punto GPS único o Límite poligonal (3 o más puntos).
Escriba las coordenadas. Consulte los pasos siguientes.
Pulse Crear ubicación.

Para un punto, haga estos pasos:

Escriba la Latitud y la Longitud en grados decimales (WGS 84).
En ¿Se trata de una superficie o de un radio?, seleccione Superficie o Radio.
Escriba el valor del tamaño.

Para un polígono, haga estos pasos:

Escriba la latitud y la longitud de cada punto del límite. La página empieza con tres puntos.
Para añadir un punto más, pulse Añadir punto.
Para quitar un punto, pulse Eliminar punto en ese punto. Un polígono debe conservar como mínimo tres puntos.

Usted no escribe el primer punto otra vez al final. La aplicación cierra el límite automáticamente.

Después, la aplicación analiza la ubicación de la misma forma que un archivo cargado.

Mensajes de error¶

Si la carga falla, la página muestra un título de error, una causa y una acción. Para ver los datos técnicos, pulse Detalles técnicos.

Título del error	Causa	Acción
"Tipo de archivo no compatible"	La aplicación no acepta este tipo de archivo.	Cargue un archivo CSV, .xlsx, GeoJSON, KML o shapefile .zip.
"Archivo demasiado grande"	El archivo es mayor de 10 MiB (10,485,760 bytes), o el archivo .zip contiene más de 256 archivos.	Divida el archivo en archivos más pequeños. Cargue cada archivo como una lista.
"Hoja de cálculo demasiado ancha"	Una fila del archivo de Excel tiene más de 512 columnas.	Quite las columnas que no necesita.
"Demasiadas ubicaciones"	El archivo tiene más de 5,000 ubicaciones.	Divida el archivo en archivos más pequeños. Cargue cada archivo como una lista.
"No se encontraron ubicaciones"	El archivo no tiene filas de datos.	Asegúrese de que el archivo tiene filas.
"No se pudo abrir el archivo comprimido"	El archivo .zip está dañado, o no tiene ningún archivo .shp.	Exporte el archivo otra vez. Cárguelo otra vez.
"No encontramos las columnas de ubicación"	La aplicación no puede encontrar las columnas de coordenadas.	Defina las relaciones de las columnas. Cargue otra vez.
"Esa columna no está en su archivo"	Las relaciones de las columnas usan una columna que no está en el archivo.	Examine las relaciones de las columnas.
"No hay ubicaciones válidas"	Ninguna ubicación del archivo tiene coordenadas válidas.	Examine las coordenadas.
"No se pudo leer el KML/KMZ"	El archivo KML no es un archivo KML válido.	Exporte el archivo otra vez. Cárguelo otra vez.
"Las ubicaciones necesitan un tamaño"	El archivo tiene solo puntos y ningún tamaño.	Dé un tamaño para los puntos.
"Elija una unidad"	Un tamaño no tiene unidad.	Seleccione Superficie o Radio.
"Columna no encontrada"	La columna de tamaño no está en el archivo.	Asegúrese de que el encabezado de la columna es correcto.
"No se puede usar el valor de tamaño"	Algunos valores de tamaño están vacíos, son cero o son demasiado grandes.	Examine los valores de tamaño de esas filas.
"¿Qué proyección cartográfica?"	Las coordenadas no son latitud y longitud WGS 84.	Seleccione la proyección del archivo.
"Proyección no reconocida"	La aplicación no puede usar la proyección para este archivo.	Seleccione una proyección diferente.
"Carga vencida"	Usted no confirmó la carga a tiempo.	Cargue el archivo otra vez.
"Carga interrumpida"	La carga se detuvo antes de estar completa.	Cargue el archivo otra vez.
"No se puede contactar con el servidor"	La aplicación no puede conectarse al servidor.	Asegúrese de que el contenedor está en ejecución. Después, inténtelo otra vez.

NOTA: Los límites de 10 MiB, 512 columnas y 5,000 ubicaciones son los valores predeterminados. La configuración del servidor puede cambiarlos.

NOTA: Un error en una ubicación no detiene la carga. La tabla de revisión muestra las ubicaciones que tienen un error.

Para más problemas y sus acciones correctivas, consulte 07-troubleshooting.md.

Cambiar el nombre de una lista¶

En la página de listas, pulse ⋯ en la fila de la lista.
Seleccione Renombrar.
Escriba el nombre nuevo.
Pulse Enter para guardar el nombre, o pulse Esc para cancelar.

El nombre puede tener un máximo de 200 caracteres. Un nombre vacío no cambia la lista. Si la aplicación no puede guardar el nombre, muestra "No se pudo cambiar el nombre".

Eliminar una lista¶

ADVERTENCIA: Asegúrese de que selecciona la lista correcta. No puede recuperar una lista después de eliminarla.

En la página de listas, pulse ⋯ en la fila de la lista.
Seleccione Eliminar.
En el mensaje de confirmación, pulse OK.

Si la aplicación no puede eliminar la lista, muestra "No se pudo eliminar" y conserva la lista.

Actualizar una lista¶

Usted no puede añadir ubicaciones a una lista ni quitar ubicaciones de una lista. Para usar un grupo diferente de ubicaciones, cree una lista nueva.

Puede analizar una lista otra vez con los conjuntos de datos actuales. Use esta acción cuando la lista tiene la etiqueta Hay datos más recientes.

ADVERTENCIA: Lea el costo antes de pulsar Volver a ejecutar. Si el cuadro de diálogo muestra "Se lee de WRI en línea, con cargo a su cuenta de AWS", el análisis causa un cargo en su cuenta de AWS. Usted debe seleccionar Entiendo que esta ejecución se cobra a mi cuenta de AWS. antes de pulsar Volver a ejecutar.

En la página de listas, pulse ⋯ en la fila de la lista.
Seleccione Volver a ejecutar con datos actuales.
Lea los conjuntos de datos que cambiaron después del último análisis.
En ¿Cómo se debe aplicar la nueva ejecución?, seleccione uno de estos dos valores:
Actualizar esta lista: la aplicación reemplaza los resultados de la lista. El nombre, las notas y las fechas de la lista no cambian.
Crear una copia nueva: la aplicación crea una lista nueva con las mismas ubicaciones. La lista inicial no cambia.
Pulse Volver a ejecutar.

Si la actualización falla, la aplicación conserva los resultados anteriores. También puede iniciar esta acción desde la página de la lista. Para más datos sobre los costos, consulte 03-analysis-and-results.md.

El menú ⋯ también tiene Exportar. Exportar descarga los resultados de la lista como un archivo CSV. Puede pulsar Exportar solo cuando el análisis de la lista está completo. Para las exportaciones, consulte 05-exports.md.