Publicar un mapa Lizmap desde QGIS, paso a paso

Cómo funciona la publicación en Lizmap

Un mapa Lizmap no es una copia de su mapa: es su propio proyecto QGIS, leído por QGIS Server y mostrado en el navegador por Lizmap Web Client. Publicar significa, por tanto, colocar tres cosas en el lugar adecuado del servidor: el proyecto QGIS, sus datos (salvo los que están en PostGIS) y un archivo de configuración Lizmap que el complemento crea junto al proyecto.

Necesita una instancia Lizmap en línea. Si no la tiene, la guía Instalar Lizmap uno mismo o elegir un alojamiento presenta ambas vías. Con LizPack Map, el alojamiento Lizmap de LizPack, una instancia está lista en unos cuatro minutos, con QGIS Server y una base PostGIS ya conectados.

• QGIS Desktop, en una versión compatible con el QGIS Server de la instancia.
• El complemento Lizmap, instalado desde el administrador de complementos de QGIS.
• Una instancia Lizmap en línea y una cuenta que pueda subir proyectos a ella.
• Un proyecto QGIS que se muestre correctamente en su equipo, con sus datos en su carpeta o en PostGIS.

Paso 1: preparar el proyecto QGIS

La mayoría de los mapas que se ven mal en línea tienen un problema de preparación, no de servidor. Antes de pensar en Lizmap, revise su proyecto:

• Rutas relativas. En las propiedades del proyecto, guarde las rutas como relativas y coloque los datos en la carpeta del proyecto o sus subcarpetas. Una ruta a su disco C: no existe en el servidor.
• Sistema de coordenadas. Elija el SRC del proyecto con criterio; para superponer mapas base web, Web Mercator (EPSG:3857) es lo más sencillo.
• Formatos. Prefiera GeoPackage a Shapefile dispersos, y PostGIS para las capas editadas o voluminosas.
• Nombres. Dé a las capas nombres legibles: son los que sus visitantes verán en la leyenda.
• Versión de QGIS. Trabaje con una versión de QGIS Desktop compatible con el QGIS Server de la instancia, idealmente la misma.

Antes de pasar al complemento, haga un último control: cierre y vuelva a abrir el proyecto para comprobar que ninguna capa aparece con error, elimine las capas de trabajo innecesarias y compruebe que los mapas base externos que usa son accesibles desde Internet. Un proyecto que se abre sin problemas en otro equipo de su servicio tiene todas las posibilidades de mostrarse bien en línea.

Paso 2: configurar el mapa con el complemento Lizmap

El complemento Lizmap, desarrollado por 3Liz, se instala desde el administrador de complementos de QGIS (menú Complementos, Administrar e instalar complementos, búsqueda de Lizmap). Después aparece en el menú y la barra de herramientas Web. No instale en QGIS Desktop el complemento llamado Lizmap server: solo se usa en el servidor. Describe cómo debe comportarse el mapa en línea y guarda esos ajustes en un archivo situado junto al proyecto. En orden:

1. Abra el complemento Lizmap desde el menú Web de QGIS e indique, si el complemento lo propone, la dirección de su instancia para que compruebe las versiones.
2. Complete la información general del mapa: título, resumen, extensión inicial y escalas.
3. Configure las capas: las visibles al inicio, las consultables, los mapas base y las capas de fondo.
4. Active las herramientas útiles: búsqueda, impresión a partir de sus composiciones, medición, tabla de atributos, edición de capas PostGIS si es necesario.
5. Guarde la configuración de Lizmap y después guarde el proyecto QGIS.

El propio complemento señala los problemas que detecta (capa sin clave primaria, ruta absoluta, versión demasiado reciente). Lea sus advertencias antes de publicar: evitan la mayoría de los mapas vacíos.

Dos paneles del complemento merecen una atención especial. El panel de mapas base permite ofrecer fondos externos, como OpenStreetMap, sin añadirlos al proyecto. El panel de información emergente regula lo que ven los visitantes al hacer clic en un objeto: elija los campos útiles y oculte los demás. La documentación oficial del complemento, en docs.lizmap.com, detalla cada panel.

Paso 3: publicar el mapa Lizmap con LizPack Publisher

En una instalación clásica, se copian el proyecto, su configuración y sus datos en el directorio de proyectos del servidor. Con LizPack, el complemento gratuito LizPack Publisher hace ese trabajo desde QGIS:

1. En QGIS, menú Complementos, busque LizPack e instale LizPack Publisher desde el repositorio oficial. Se necesita QGIS 3.16 como mínimo.
2. Conéctese con su correo y su contraseña de LizPack y elija la instancia en la que trabajar.
3. Con el proyecto abierto en QGIS, lance la publicación: se valida y se envía a la instancia con sus datos.
4. Abra su portal Lizmap: el mapa aparece en él.

LizPack Publisher también sirve en el día a día: recorrer los archivos de la instancia, abrir un proyecto remoto en QGIS, enviar una carpeta completa conservando su estructura. A partir del plan Pro, permite añadir las tablas de la base PostGIS de la instancia como capas e importar una capa en ella. Cada operación queda registrada en un historial que puede copiar para el soporte.

¿Prefiere el navegador? El gestor de archivos en línea del área de cliente permite subir, organizar y sustituir proyectos y datos sin complemento.

Publicar capas PostGIS

Los archivos sirven para datos estables. En cuanto una capa cambia a menudo, se comparte entre varios proyectos o se edita en línea, PostGIS pasa a ser la opción adecuada: el mapa Lizmap lee directamente la base, sin volver a publicar, y varias personas pueden trabajar en ella a la vez.

1. Cree en QGIS una conexión a la base PostGIS de su instancia. Con LizPack Map, cada instancia tiene su base PostgreSQL y PostGIS; a partir del plan Pro, se conecta a ella desde QGIS Desktop o pgAdmin, con conexión cifrada.
2. Importe sus capas en la base. A partir del plan Pro, LizPack Publisher permite importar una capa en la base de la instancia y diagnosticarla, y luego añadir las tablas como capas del proyecto.
3. Compruebe que cada tabla tiene una clave primaria y un índice espacial: sin clave primaria, la consulta y la edición fallan; sin índice, el mapa se ralentiza.
4. Sustituya en el proyecto las capas de archivos por las capas PostGIS, ajuste los estilos, guarde y vuelva a publicar.

Use en el proyecto una conexión que también funcione desde el servidor. Una capa PostGIS que apunta a una base instalada en su propio equipo no se mostrará en línea.

Organice la base desde el principio: un esquema por tema o por servicio, nombres de tablas en minúsculas y sin espacios, y nombres de columnas explícitos. Estas convenciones evitan muchos errores entre QGIS, Lizmap y los demás programas que leerán la misma base, y facilitan el trabajo de quien retome el proyecto después de usted. Deje también constancia de lo que contiene cada tabla y de su fuente.

Permitir la edición en línea

Lizmap permite introducir y modificar datos directamente en el navegador, sin QGIS. Es útil para un aviso de incidencia, un inventario de campo sencillo o la actualización de un estado por un servicio que no usa SIG. La configuración se hace en el panel de edición del complemento Lizmap:

1. Prepare la capa en PostGIS, con una clave primaria y tipos de campo adecuados.
2. En QGIS, configure el formulario de atributos de la capa: orden de los campos, listas de valores, campos obligatorios, valores por defecto. Lizmap reutiliza este formulario en línea.
3. En el complemento Lizmap, añada la capa a la edición y elija las acciones permitidas: crear, modificar atributos, modificar geometría, eliminar.
4. Limite la edición a los grupos de usuarios afectados.
5. Guarde la configuración, guarde el proyecto, vuelva a publicar y pruebe con una cuenta del grupo autorizado.

Empiece con pocos campos y listas de valores cerradas: unos datos bien introducidos desde el principio valen más que un formulario exhaustivo que nadie rellena. Para una captura sin conexión en el teléfono, la aplicación QField es más adecuada; LizPack Field la vincula a la misma base PostGIS.

Impresión y atlas

Los visitantes de un portal Lizmap pueden imprimir el mapa a partir de las composiciones de impresión que haya creado en QGIS. La plantilla, los logotipos, la leyenda, la escala y los textos proceden, por tanto, de QGIS: lo que ve en el diseñador es lo que obtienen sus usuarios.

• Prevea pocas composiciones, bien nombradas: por ejemplo una A4 vertical y una A3 horizontal, en lugar de una decena de variantes.
• Use textos dinámicos (fecha, título del proyecto) en lugar de textos fijos que habrá que corregir.
• Compruebe la resolución: una impresión en alta resolución cuesta tiempo de cálculo al servidor.
• Piense en el atlas: el complemento Lizmap tiene un panel dedicado al atlas, útil para recorrer una serie de objetos, por ejemplo una ficha por municipio o por parcela.

Paso 4: ajustar los permisos y compartir

Decida primero quién debe ver el mapa. En la administración de Lizmap, se define para cada directorio de proyectos qué grupos pueden consultarlo y se crean las cuentas de sus usuarios. Un mapa público no requiere conexión; un mapa interno se reserva a un grupo.

Para ir más lejos, los módulos Lizmap añaden funciones al portal, como tableros compuestos en QGIS. La guía Crear un tablero Lizmap explica cómo.

1. En la administración de Lizmap, cree los grupos que correspondan a sus públicos: por ejemplo, un grupo por servicio.
2. Cree las cuentas de los usuarios y asigne cada una a su grupo o grupos.
3. Para cada directorio de proyectos, conceda a los grupos el derecho a ver los proyectos, y solo a ellos.
4. Conéctese con una cuenta de prueba de cada grupo para comprobar lo que ve.

Actualizar un mapa Lizmap ya publicado

Un mapa publicado evoluciona: se añade una capa, se corrige un estilo, se cambia un mapa base. La regla es sencilla: se modifica siempre en QGIS, nunca en el servidor, y luego se vuelve a publicar. El proyecto de su equipo sigue siendo la referencia.

1. Abra el proyecto en QGIS y haga sus cambios.
2. Si ha añadido o renombrado capas, vuelva a abrir el complemento Lizmap para configurarlas y guarde su configuración.
3. Guarde el proyecto QGIS.
4. Vuelva a publicar: el proyecto, su configuración y los datos modificados sustituyen a las versiones anteriores en la instancia.
5. Recargue el mapa en el navegador para comprobar el resultado.

Las capas almacenadas en PostGIS son la excepción: sus datos se leen directamente de la base. Una fila añadida o modificada en la tabla aparece en el mapa sin volver a publicar el proyecto. Es una de las mejores razones para pasar sus capas vivas a PostGIS en lugar de archivos. Solo los cambios de estructura, de estilo o de configuración requieren una nueva publicación.

Los problemas más frecuentes

Para buscar la causa de un problema, empiece por las advertencias del complemento Lizmap en QGIS y luego por el historial de operaciones de LizPack Publisher, que registra cada envío y se copia con un clic para una solicitud al soporte. Compruebe por último el mapa en una ventana de navegación privada: verá lo que ve un visitante no conectado.

Preguntas frecuentes