QField PostGIS: del campo al mapa web, sin exportar

La cadena campo, PostGIS, Lizmap

Tres programas libres, tres papeles. QField recolecta en el teléfono. PostgreSQL y PostGIS almacenan los datos espaciales. Lizmap, servido por QGIS Server, publica el proyecto QGIS como mapa web. El eslabón que los une es el servicio de sincronización: LizPack Field, que se basa en la misma tecnología de sincronización que QFieldCloud y funciona con la aplicación QField oficial.

1. El agente registra un dato en QField, con o sin red.
2. Al volver la red, sincroniza: los cambios suben a LizPack Field.
3. Con el plan Pro, LizPack Field escribe los datos directamente en las capas PostGIS del proyecto.
4. El mapa Lizmap que muestra esas capas PostGIS se actualiza en cada sincronización, sin intervención.

LizPack es una infraestructura geoespacial de código abierto: no es el autor de ninguno de estos programas, los aloja, los conecta y los mantiene. Vea lo que hace LizPack.

El interés de esta cadena está en que no hay ningún paso manual. Sin ella, hay que recoger los archivos de cada agente, fusionarlos, corregir duplicados y volver a importar todo en la base y republicar el mapa: otras tantas ocasiones de perder o duplicar datos, y días de desfase entre el campo y lo que ven quienes deciden.

Lo que hace falta para conectar QField y PostGIS

Con el plan Gratuito de LizPack Field, los datos quedan en los archivos del proyecto, que recupera en QGIS: la conexión PostGIS requiere el plan Pro, a 15 USD al mes en el momento de redactar. Precios vigentes en la página de precios.

Todos estos elementos se gestionan desde la misma cuenta LizPack: la base, la instancia LizPack Map y LizPack Field comparten el mismo inicio de sesión. No hace falta crear credenciales distintas para cada servicio, y la conexión entre la base y la instancia se hace desde el área de cliente, sin tocar ningún servidor.

Elegir su instancia LizPack Map

El mapa web de la cadena QField PostGIS lo sirve Lizmap. En LizPack, ese es el papel de LizPack Map: una instancia Lizmap en su subdominio, con QGIS Server, una base PostGIS y una caché de teselas, en línea en unos cuatro minutos, con un certificado HTTPS renovado automáticamente.

Hay dos montajes posibles. O los datos van a una base dedicada, creada aparte y dimensionada de 1 a 10 GB, que leen tanto la instancia como LizPack Field. O van a la base incluida con la instancia. La base dedicada tiene la ventaja de ser independiente de la instancia: puede conservarla si cambia de instancia.

Precios en el momento de redactar: LizPack Map Basic 10 USD al mes, Pro 20 USD al mes. Tarifas vigentes en la página de precios.

Preparar las capas PostGIS en el proyecto QGIS

La regla central: las capas de recolección deben ser capas PostGIS en el proyecto QGIS, no archivos locales. Son esas capas las que alimenta LizPack Field.

1. En QGIS, añada la conexión a su base PostGIS con el host, el puerto y las credenciales entregados al crearla.
2. Cree las tablas de recolección en la base, con una clave primaria autoincremental y una columna de geometría del tipo y sistema de coordenadas correctos.
3. Añada esas tablas al proyecto como capas PostGIS y configure sus formularios: listas de valores, restricciones, valores por defecto, fotos.
4. Añada los mapas base y capas de contexto útiles en campo.
5. Guarde el proyecto y publíquelo en LizPack Field desde QGIS.

• Una clave primaria fiable evita conflictos cuando varios agentes crean objetos sin conexión al mismo tiempo.
• Mantenga nombres de campo simples, sin espacios ni tildes: serán más fáciles de usar en SQL y en Lizmap.
• Pruebe un ciclo completo con un solo agente antes de abrir el proyecto a todo el equipo.

Ejemplo: una tabla de recolección lista para QField

Esta es una tabla de puntos de agua tal como puede crearse en la base, desde el administrador de bases de datos de QGIS o pgAdmin. Aplica las reglas de la sección anterior.

CREATE SCHEMA IF NOT EXISTS recoleccion;

CREATE TABLE recoleccion.puntos_agua (
  id serial PRIMARY KEY,
  tipo_obra text NOT NULL,
  estado text NOT NULL,
  fecha_registro timestamptz DEFAULT now(),
  agente text,
  foto text,
  validado boolean DEFAULT false,
  geom geometry(Point, 4326) NOT NULL
);

CREATE INDEX ON recoleccion.puntos_agua USING gist (geom);

CREATE VIEW recoleccion.puntos_agua_validados AS
  SELECT * FROM recoleccion.puntos_agua WHERE validado;

• id serial: una clave primaria numerada automáticamente por la base, lo que evita colisiones entre agentes.
• NOT NULL en el tipo y el estado: la base rechaza un registro incompleto, además de las restricciones del formulario.
• DEFAULT now(): la fecha de captura se rellena sola.
• geometry(Point, 4326): un tipo y un sistema de coordenadas explícitos, que QGIS y Lizmap leen sin ambigüedad.
• El índice espacial acelera la visualización en QGIS y en el mapa Lizmap cuando crece el número de registros.
• La vista de registros validados alimenta el mapa público: solo aparecen los objetos marcados como validados por el responsable.

Después, añada la tabla al proyecto QGIS como capa PostGIS, configure su formulario y añada la vista al proyecto publicado en Lizmap. Adapte el sistema de coordenadas a su país si sus datos de referencia usan otro.

Mostrar los datos en Lizmap

Para el mapa web, publique en su instancia Lizmap un proyecto QGIS que lea las mismas capas PostGIS. Puede ser el propio proyecto de recolección o un proyecto de consulta distinto, con otros estilos y sin los campos internos. Súbalo desde el navegador o desde QGIS con la extensión LizPack Publisher, como se describe en publicar un proyecto QGIS en línea.

Como Lizmap lee directamente la base, no hay nada que volver a publicar tras una campaña: cada sincronización de QField actualiza la base y el mapa muestra el estado actual en la siguiente carga. Las capas PostGIS servidas por Lizmap también pueden editarse en línea, desde la oficina.

Para compartir los datos por enlace sin proyecto Lizmap, LizPack Viewer, incluido con LizPack Field, compone un mapa con las capas de sus proyectos. Vea crear un mapa en línea y compartirlo.

Si personal de oficina debe corregir datos desde el mapa web, active la edición de la capa en la configuración Lizmap del proyecto, con el plugin Lizmap de QGIS, y limítela a los grupos de usuarios correspondientes. Las correcciones se escriben en la misma tabla PostGIS que los datos de QField.

Comprobar que la cadena funciona

Antes de abrir la campaña a todo el equipo, haga un ciclo completo y controle cada eslabón. Si un dato no llega al final, esta lista ayuda a encontrar dónde se detiene.

1. En un teléfono, registre un objeto de prueba en QField y sincronice.
2. En el panel de LizPack Field, compruebe que el cambio aparece entre los cambios recibidos y en el registro de procesos.
3. En QGIS Desktop, abra la tabla PostGIS y busque el objeto por su fecha o su agente.
4. Abra el mapa Lizmap y recargue la página: el objeto debe aparecer, o aparecer solo en la vista pública una vez validado.
5. Borre el objeto de prueba y compruebe que el borrado se refleja en todas partes.

• El cambio no aparece en LizPack Field: la sincronización no terminó; revise la red del teléfono y vuelva a lanzarla.
• Aparece en LizPack Field pero no en PostGIS: compruebe que la cuenta está en plan Pro y que la capa del proyecto es realmente una capa PostGIS, no un archivo local.
• Está en PostGIS pero no en el mapa: compruebe que el proyecto Lizmap lee la misma tabla o la vista correcta, y que el objeto cumple el filtro de la vista.

Trabajar varios agentes sobre la misma base

En cuanto varios agentes recolectan en las mismas capas PostGIS, algunas reglas evitan conflictos y datos incoherentes. Se deciden al preparar el proyecto, no después de la primera campaña.

• Crear en lugar de modificar. Las creaciones de objetos se combinan sin dificultad: cada agente añade sus propios puntos. Las modificaciones de un mismo objeto por dos agentes son más delicadas; asigne sectores para que un objeto existente solo lo toque una persona.
• Registrar el origen de cada dato. Añada campos para el autor y la fecha de captura, rellenados automáticamente por una expresión. Sirven para el control de calidad y las estadísticas de seguimiento.
• Separar recolección y difusión. Los agentes escriben en las tablas de recolección; el mapa público lee una vista que solo muestra los datos validados. El responsable valida en la oficina cambiando un campo de estado.
• Mantener las capas de referencia en solo lectura. Límites administrativos, catastro o redes existentes sirven de contexto en campo y no tienen por qué modificarse desde QField.

Otro punto a prever: la evolución del modelo de datos. Añadir un campo a una tabla PostGIS en plena campaña es posible, pero entonces hay que actualizar el proyecto QGIS y volver a publicarlo en LizPack Field, y los agentes deben descargar la nueva versión antes de seguir. Agrupe estos cambios y hágalos entre dos campañas, avisando al equipo.

Por último, piense en el volumen. Las fotos tomadas en campo ocupan rápidamente más espacio que los propios datos. Vigile el espacio de su plan de LizPack Field y de su base, y elija una resolución de foto razonable en el formulario.

Antes de cada nueva campaña, haga un repaso rápido con el equipo: qué capas están abiertas a la captura, qué sectores tiene asignados cada uno, qué campos han cambiado. Cinco minutos de coordinación evitan horas de limpieza en la base, y el mapa Lizmap publicado sigue siendo coherente para quienes lo consultan.

Aprovechar la base QField PostGIS

Una vez en PostGIS, los datos son accesibles para todas sus herramientas sin exportar: QGIS Desktop, pgAdmin, DBeaver, sus scripts y GeoServer si publica servicios OGC con GeoServer Cloud.

• Consultas SQL de seguimiento: objetos levantados por día, por agente, por zona.
• Vistas para el mapa público que ocultan los campos internos.
• Controles de calidad: geometrías no válidas, campos obligatorios vacíos, duplicados.
• Vigilancia del espacio: correos le avisan en cuanto la base alcanza el 60 % de su volumen, y luego al 75, 80, 90 y 95 %.

Para la preparación del proyecto y el trabajo de los agentes en campo, vea la guía de recolección de datos en campo con QField.

Como la base es una base PostgreSQL estándar, también puede recuperar su contenido en cualquier momento con las herramientas habituales de PostgreSQL, para un archivo o una transferencia.

Errores frecuentes en la cadena QField PostGIS

• Recolectar en un GeoPackage pensando llenar PostGIS. Solo las capas PostGIS del proyecto se escriben en la base; una capa de archivo se queda en los archivos del proyecto.
• Una tabla sin clave primaria. QGIS a veces la carga en solo lectura o la trata mal; añada siempre una clave primaria antes de publicar.
• Un sistema de coordenadas distinto entre la tabla y el proyecto. Los objetos aparecen en el lugar equivocado o no aparecen; fíjelo al crear la tabla.
• Cambiar la estructura en plena campaña sin volver a publicar. Los agentes trabajan con la versión antigua del proyecto y algunos campos no suben.
• Publicar la tabla en bruto en el mapa público. Los datos sin revisar y los campos internos quedan visibles; use una vista.

Ninguno de estos errores es grave si se detecta en la prueba descrita más arriba. Por eso el ciclo completo con un solo agente sigue siendo el paso más rentable de toda la puesta en marcha.

Preguntas frecuentes