Publicar um mapa Lizmap a partir do QGIS, passo a passo

Como funciona a publicação no Lizmap

Um mapa Lizmap não é uma cópia do seu mapa: é o próprio projeto QGIS, lido pelo QGIS Server e mostrado no navegador pelo Lizmap Web Client. Publicar é, portanto, colocar três coisas no sítio certo do servidor: o projeto QGIS, os seus dados (exceto os que estão no PostGIS) e um ficheiro de configuração Lizmap que o plugin cria ao lado do projeto.

Precisa de uma instância Lizmap online. Se não tiver, o guia Instalar o Lizmap por conta própria ou escolher um alojamento apresenta os dois caminhos. Com o LizPack Map, o alojamento Lizmap do LizPack, uma instância fica pronta em cerca de quatro minutos, com o QGIS Server e uma base PostGIS já ligados.

• O QGIS Desktop, numa versão compatível com o QGIS Server da instância.
• O plugin Lizmap, instalado a partir do gestor de complementos do QGIS.
• Uma instância Lizmap online e uma conta que possa enviar projetos para ela.
• Um projeto QGIS que apareça corretamente no seu computador, com os dados arrumados na sua pasta ou no PostGIS.

Passo 1: preparar o projeto QGIS

A maioria dos mapas que aparecem mal online tem um problema de preparação, não de servidor. Antes de pensar no Lizmap, verifique o seu projeto:

• Caminhos relativos. Nas propriedades do projeto, guarde os caminhos como relativos e arrume os dados na pasta do projeto ou nas suas subpastas. Um caminho para o seu disco C: não existe no servidor.
• Sistema de coordenadas. Escolha o SRC do projeto com critério; para sobrepor mapas de fundo web, o Web Mercator (EPSG:3857) é o mais simples.
• Formatos. Prefira o GeoPackage a Shapefiles dispersos, e o PostGIS para camadas editadas ou volumosas.
• Nomes. Dê às camadas nomes legíveis: são os que os seus visitantes vão ver na legenda.
• Versão do QGIS. Trabalhe com uma versão do QGIS Desktop compatível com o QGIS Server da instância, de preferência a mesma.

Antes de passar ao plugin, faça uma última verificação: feche e volte a abrir o projeto para confirmar que nenhuma camada aparece com erro, elimine as camadas de trabalho desnecessárias e verifique que os mapas de fundo externos que usa estão acessíveis a partir da Internet. Um projeto que abre sem problemas noutro computador do seu serviço tem todas as hipóteses de aparecer bem online.

Passo 2: configurar o mapa com o plugin Lizmap

O plugin Lizmap, desenvolvido pela 3Liz, instala-se a partir do gestor de complementos do QGIS (menu Complementos, Gerir e instalar complementos, pesquisa de Lizmap). Aparece depois no menu e na barra de ferramentas Web. Não instale no QGIS Desktop o plugin chamado Lizmap server: só é usado no servidor. Descreve como o mapa se deve comportar online e guarda essas definições num ficheiro colocado ao lado do projeto. Por ordem:

1. Abra o plugin Lizmap a partir do menu Web do QGIS e indique, se o plugin o propuser, o endereço da sua instância para que verifique as versões.
2. Preencha as informações gerais do mapa: título, resumo, extensão inicial e escalas.
3. Configure as camadas: as visíveis no arranque, as que podem ser consultadas, os mapas de fundo e as camadas de base.
4. Ative as ferramentas úteis: pesquisa, impressão a partir das suas composições, medição, tabela de atributos, edição de camadas PostGIS se necessário.
5. Guarde a configuração Lizmap e depois guarde o projeto QGIS.

O próprio plugin assinala os problemas que deteta (camada sem chave primária, caminho absoluto, versão demasiado recente). Leia os avisos antes de publicar: evitam a maioria dos mapas vazios.

Dois painéis do plugin merecem atenção especial. O painel de mapas de fundo permite propor fundos externos, como o OpenStreetMap, sem os acrescentar ao projeto. O painel de dicas define o que os visitantes veem ao clicar num objeto: escolha os campos úteis e oculte os restantes. A documentação oficial do plugin, em docs.lizmap.com, detalha cada painel.

Passo 3: publicar o mapa Lizmap com o LizPack Publisher

Numa instalação clássica, copia-se o projeto, a sua configuração e os seus dados para a pasta de projetos do servidor. Com o LizPack, o complemento gratuito LizPack Publisher faz esse trabalho a partir do QGIS:

1. No QGIS, menu Complementos, procure LizPack e instale o LizPack Publisher a partir do repositório oficial. É preciso o QGIS 3.16 no mínimo.
2. Inicie sessão com o seu e-mail e a sua palavra-passe LizPack e escolha a instância em que vai trabalhar.
3. Com o projeto aberto no QGIS, lance a publicação: é validado e depois enviado para a instância com os seus dados.
4. Abra o seu portal Lizmap: o mapa aparece lá.

O LizPack Publisher também serve no dia a dia: percorrer os ficheiros da instância, abrir um projeto remoto no QGIS, enviar uma pasta completa mantendo a sua estrutura. A partir do plano Pro, permite adicionar as tabelas da base PostGIS da instância como camadas e importar uma camada para ela. Cada operação fica registada num diário que pode copiar para o suporte.

Prefere o navegador? O gestor de ficheiros online da área de cliente permite enviar, organizar e substituir projetos e dados sem complemento.

Publicar camadas PostGIS

Os ficheiros servem para dados estáveis. Logo que uma camada muda com frequência, é partilhada entre vários projetos ou editada online, o PostGIS passa a ser a escolha certa: o mapa Lizmap lê diretamente a base, sem nova publicação, e várias pessoas podem trabalhar nela ao mesmo tempo.

1. Crie no QGIS uma ligação à base PostGIS da sua instância. Com o LizPack Map, cada instância tem a sua base PostgreSQL e PostGIS; a partir do plano Pro, liga-se a ela a partir do QGIS Desktop ou do pgAdmin, com ligação cifrada.
2. Importe as suas camadas para a base. A partir do plano Pro, o LizPack Publisher permite importar uma camada para a base da instância e diagnosticá-la, e depois acrescentar as tabelas como camadas do projeto.
3. Verifique que cada tabela tem uma chave primária e um índice espacial: sem chave primária, a consulta e a edição falham; sem índice, o mapa fica mais lento.
4. Substitua no projeto as camadas de ficheiros pelas camadas PostGIS, defina os estilos, guarde e volte a publicar.

Use no projeto uma ligação que funcione também a partir do servidor. Uma camada PostGIS que aponta para uma base instalada no seu próprio computador não aparecerá online.

Organize a base desde o início: um esquema por tema ou por serviço, nomes de tabelas em minúsculas e sem espaços, e nomes de colunas explícitos. Estas convenções evitam muitos erros entre o QGIS, o Lizmap e os outros programas que vão ler a mesma base, e facilitam o trabalho de quem retomar o projeto depois de si. Registe também o que contém cada tabela e qual é a sua fonte.

Permitir a edição online

O Lizmap permite introduzir e alterar dados diretamente no navegador, sem QGIS. É útil para uma participação de ocorrência, um inventário de terreno simples ou a atualização de um estado por um serviço que não usa SIG. A configuração faz-se no painel de edição do plugin Lizmap:

1. Prepare a camada no PostGIS, com uma chave primária e tipos de campo adequados.
2. No QGIS, configure o formulário de atributos da camada: ordem dos campos, listas de valores, campos obrigatórios, valores por omissão. O Lizmap reutiliza este formulário online.
3. No plugin Lizmap, acrescente a camada à edição e escolha as ações permitidas: criar, alterar atributos, alterar geometria, eliminar.
4. Limite a edição aos grupos de utilizadores em causa.
5. Guarde a configuração, guarde o projeto, volte a publicar e teste com uma conta do grupo autorizado.

Comece com poucos campos e listas de valores fechadas, e teste o formulário com as pessoas que o vão realmente preencher: dados bem introduzidos desde o início valem mais do que um formulário exaustivo que ninguém preenche. Para uma recolha offline no telemóvel, a aplicação QField é mais adequada; o LizPack Field liga-a à mesma base PostGIS.

Impressão e atlas

Os visitantes de um portal Lizmap podem imprimir o mapa a partir das composições de impressão que criou no QGIS. O modelo, os logótipos, a legenda, a escala e os textos vêm, portanto, do QGIS: o que vê no compositor é o que os seus utilizadores obtêm.

• Preveja poucas composições, bem nomeadas: por exemplo uma A4 vertical e uma A3 horizontal, em vez de uma dezena de variantes.
• Use textos dinâmicos (data, título do projeto) em vez de textos fixos que será preciso corrigir.
• Verifique a resolução: uma impressão em alta resolução custa tempo de cálculo ao servidor.
• Pense no atlas: o plugin Lizmap tem um painel dedicado ao atlas, útil para percorrer uma série de objetos, por exemplo uma ficha por concelho ou por parcela.

Passo 4: definir as permissões e partilhar

Decida primeiro quem deve ver o mapa. Na administração do Lizmap, define para cada pasta de projetos os grupos que a podem consultar e cria as contas dos seus utilizadores. Um mapa público não exige autenticação; um mapa interno fica reservado a um grupo.

Para ir mais longe, os módulos Lizmap acrescentam funções ao portal, como painéis compostos no QGIS. O guia Criar um painel Lizmap explica como.

1. Na administração do Lizmap, crie os grupos que correspondem aos seus públicos: por exemplo, um grupo por serviço.
2. Crie as contas dos utilizadores e associe cada uma ao seu grupo ou grupos.
3. Para cada pasta de projetos, conceda aos grupos o direito de ver os projetos, e apenas a eles.
4. Inicie sessão com uma conta de teste de cada grupo para verificar o que vê.

Atualizar um mapa Lizmap já publicado

Um mapa publicado evolui: acrescenta-se uma camada, corrige-se um estilo, muda-se um mapa de fundo. A regra é simples: altera-se sempre no QGIS, nunca no servidor, e depois volta-se a publicar. O projeto do seu computador continua a ser a referência.

1. Abra o projeto no QGIS e faça as alterações.
2. Se acrescentou ou mudou o nome de camadas, volte a abrir o plugin Lizmap para as configurar e guarde a sua configuração.
3. Guarde o projeto QGIS.
4. Volte a publicar: o projeto, a sua configuração e os dados alterados substituem as versões anteriores na instância.
5. Recarregue o mapa no navegador para verificar o resultado.

As camadas guardadas no PostGIS são a exceção: os seus dados são lidos diretamente na base. Uma linha acrescentada ou alterada na tabela aparece no mapa sem voltar a publicar o projeto. É uma das melhores razões para passar as suas camadas vivas para o PostGIS em vez de ficheiros. Só as alterações de estrutura, de estilo ou de configuração exigem uma nova publicação.

Os problemas mais frequentes

Para procurar a causa de um problema, comece pelos avisos do plugin Lizmap no QGIS e depois pelo diário de operações do LizPack Publisher, que regista cada envio e se copia com um clique para um pedido ao suporte. Verifique por fim o mapa numa janela de navegação privada: verá o que vê um visitante sem sessão iniciada.

Perguntas frequentes