Primeiros passos com a LizPack: publicar um mapa QGIS online

Antes de começar: o que precisa

Publicar um mapa QGIS online com a LizPack exige pouca coisa, e nada que mexa num servidor. A LizPack é uma infraestrutura geoespacial de código aberto: instala e mantém por si software livre reconhecido, o Lizmap Web Client, o QGIS Server e o PostGIS, e trabalha com as ferramentas que já conhece. O guia O que faz a LizPack detalha esta divisão de papéis; aqui passamos à prática.

• QGIS Desktop, na versão 3.16 no mínimo, já que é a versão exigida pela extensão LizPack Publisher.
• O plugin Lizmap, a extensão da 3Liz que serve para configurar o mapa web. Instala-se a partir do menu Módulos do QGIS, como qualquer extensão.
• Um projeto QGIS: as suas camadas, a simbologia e as etiquetas. As camadas de ficheiro (GeoPackage, Shapefile, rasters) e as camadas PostGIS são suportadas.
• Um endereço de correio eletrónico para criar a conta LizPack. O plano Free é uma avaliação gratuita de 30 dias, sem cartão bancário.

Se o seu projeto já existe e foi configurado com o plugin Lizmap para outra instalação, é compatível tal como está: o LizPack Map aloja o mesmo Lizmap, com as mesmas funções. Se parte do zero, os passos seguintes cobrem também a preparação.

Os passos deste guia retomam os descritos nas páginas de produto LizPack Map, LizPack Publisher, Bases de dados, LizPack Field, GeoServer Cloud e LizPack Viewer. Para o detalhe ecrã a ecrã, a documentação da área de cliente é a referência.

Passo 1: criar a conta LizPack

Tudo começa com uma conta LizPack. É ela que abre a área de cliente, onde cria e acompanha as suas instâncias, e é com as suas credenciais que se liga depois a partir do QGIS. A mesma conta abre também o LizPack Field, a recolha no terreno, e o GeoServer Cloud: uma só autenticação para todos os produtos.

Ao criá-la, começa no plano Free: uma avaliação gratuita de 30 dias, sem cartão bancário. Chega para seguir todo este guia e verificar que os seus projetos aparecem como previsto. Depois escolherá um plano pago se o mapa tiver de continuar online: Basic a 10 USD por mês para uma instância, ou Pro a 20 USD por mês para duas instâncias, com acesso direto às bases a partir do QGIS e atualizações incluídas. O Enterprise é negociado mediante orçamento. A página Preços apresenta a tabela completa e atualizada.

A escolha do plano não é definitiva. Se hesita, comece pela avaliação, publique um projeto real e decida perante o resultado. O guia Ler os planos e as quotas da LizPack explica o que cada plano inclui, quota a quota.

Passo 2: criar uma instância LizPack Map

Uma instância é o seu portal cartográfico. Reúne o Lizmap Web Client, a aplicação que mostra os mapas no navegador, o QGIS Server, que desenha as camadas a partir dos seus projetos, uma base PostgreSQL/PostGIS e uma cache de mosaicos. Tudo isto é instalado e mantido pela LizPack; nunca acede ao servidor em si.

1. A partir da área de cliente, inicie a criação de uma instância LizPack Map.
2. Escolha um nome: torna-se o seu subdomínio, o endereço onde os seus mapas serão consultados.
3. Escolha a versão do QGIS Server: é escolhida na implementação. Prefira uma versão próxima da do seu QGIS Desktop.
4. Aguarde cerca de quatro minutos: a instância fica instalada, o subdomínio configurado e o certificado HTTPS colocado, sendo depois renovado automaticamente.

O nome merece um momento de reflexão, já que vai aparecer no endereço partilhado com os seus utilizadores. Um nome curto, ligado ao seu organismo ou ao seu projeto, fixa-se melhor do que uma sigla técnica.

A partir do plano Basic, cada instância tem o seu próprio QGIS Server, e a instância inclui um armazenamento de base de dados PostgreSQL/PostGIS. O guia Anatomia de uma instância Lizmap descreve cada componente e a forma como cooperam para mostrar um mapa.

Passo 3: preparar o projeto no QGIS com o plugin Lizmap

A preparação faz-se inteiramente no QGIS Desktop, como em qualquer publicação Lizmap. A LizPack não acrescenta nenhum formato nem nenhum passo próprio: é o plugin Lizmap da 3Liz que descreve o que o mapa web vai oferecer, e o QGIS Server que desenha as suas camadas exatamente como as vê no QGIS.

Comece pelo projeto em si. Organize as camadas pela ordem e nos grupos que quer ver na legenda online, ajuste a simbologia e as etiquetas, e dê às camadas nomes legíveis, já que são esses que os seus utilizadores verão. Escolha um sistema de coordenadas adequado ao seu território. Guarde depois o projeto, de preferência numa pasta que contenha também os seus dados, para que tudo seja publicado de uma só vez.

Abra em seguida o plugin Lizmap. É aí que se define a experiência web: a extensão inicial do mapa, as escalas, as camadas de fundo, as ferramentas oferecidas aos visitantes, as camadas consultáveis e as suas janelas de informação e, se for caso disso, as camadas editáveis online. O plugin guarda estas definições num ficheiro de configuração colocado ao lado do projeto QGIS. Esse ficheiro e o projeto viajam juntos.

• Mantenha os dados o mais perto possível do projeto: os caminhos relativos facilitam a publicação.
• As camadas de ficheiro (GeoPackage, Shapefile, rasters) e as camadas PostGIS são suportadas.
• Um projeto leve aparece mais depressa: limite o número de camadas visíveis no arranque.
• Volte a executar a configuração do plugin Lizmap após cada alteração importante do projeto, para que o ficheiro de configuração se mantenha atualizado.

O guia Publicar um mapa Lizmap a partir do QGIS detalha estas definições uma a uma, com os erros mais frequentes.

Passo 4: publicar com o LizPack Publisher

Com o projeto pronto, é preciso enviá-lo para a instância. O mais simples é a extensão LizPack Publisher, gratuita e publicada no repositório oficial de extensões do QGIS. Liga o QGIS Desktop às suas instâncias: percorre os seus ficheiros, abre um projeto remoto, publica o projeto aberto e, a partir do plano Pro, trabalha na base PostGIS da instância, a partir de uma só janela.

1. Instalar: no QGIS, menu Módulos, procure LizPack e instale o LizPack Publisher a partir do repositório oficial.
2. Ligar-se: introduza as suas credenciais LizPack e escolha a instância em que vai trabalhar. Se quiser, as credenciais podem ficar cifradas no armazém de autenticação do QGIS.
3. Preparar o projeto: configure-o com o plugin Lizmap, como descrito no passo anterior.
4. Publicar: valide e publique o projeto aberto. Junta-se ao seu portal Lizmap com os seus dados.

No momento da publicação, o projeto aberto é primeiro validado e depois enviado para a instância com os seus dados. O mapa fica então online no Lizmap. Se o seu projeto assenta numa pasta de dados mais ampla, a extensão permite também enviar uma pasta inteira do seu computador para a instância, mantendo a estrutura.

Cada operação fica registada num diário, que se copia com um clique para o juntar a um pedido ao apoio se algo não correr como previsto. A extensão não acrescenta nenhuma biblioteca à sua instalação do QGIS.

Prefere não instalar nada? O gestor de ficheiros online da instância permite também depositar, organizar e substituir os seus projetos e dados diretamente a partir do navegador. O resultado é o mesmo: o projeto e o seu ficheiro de configuração Lizmap ficam na instância e o mapa aparece no portal.

Passo 5: definir os acessos e partilhar o mapa

O seu mapa está online. Falta decidir quem o pode ver. Esta definição faz-se na administração Lizmap da sua instância, com as ferramentas habituais do Lizmap: contas de utilizador, grupos e permissões de acesso por projeto. Um mapa pode estar aberto a todos, reservado a um grupo ou visível apenas para quem tem sessão iniciada.

Duas perguntas ajudam a decidir. O mapa contém dados que não devem sair do seu organismo? Restrinja-o então a um grupo. Destina-se a informar o público, como um plano de ordenamento ou um mapa de equipamentos? Abra-o e partilhe simplesmente o endereço do seu subdomínio.

Do lado da LizPack, a área de cliente permite também trabalhar em equipa: no plano Pro, pode convidar até cinco colaboradores. Pode ainda copiar um tema do marketplace para dar estilo aos seus mapas e acompanhar a atividade da sua conta.

Se ainda hesita sobre a forma de difundir um mapa, o guia Criar um mapa online e partilhá-lo compara várias ferramentas e os seus modos de partilha.

Manter o mapa vivo: atualizações e continuidade

Publicar um mapa QGIS online é apenas o começo: um mapa útil evolui. Para o atualizar, altere o projeto no QGIS, volte a executar o plugin Lizmap se for preciso e publique de novo com o LizPack Publisher ou substitua os ficheiros a partir do gestor online. Se os seus dados estão numa base PostGIS, o mapa mostra diretamente o seu estado atual, sem nova publicação.

O próprio software também evolui. A atualização do Lizmap e do QGIS Server lança-se com um clique; está incluída a partir do plano Pro e custa 10 USD por componente nos planos Free e Basic. O certificado HTTPS renova-se automaticamente.

Por fim, se uma subscrição expirar, a instância para, mas os seus projetos, ficheiros e base são conservados durante 60 dias. Renove dentro desse prazo para a reencontrar tal como estava. Três mensagens de correio eletrónico avisam-no antes de qualquer eliminação.

Os seus projetos continuam a ser projetos QGIS configurados com o plugin Lizmap, e os seus dados continuam em formatos abertos. Reinstalam-se em qualquer outra instalação do Lizmap.

Ir mais longe: PostGIS, LizPack Field, GeoServer Cloud, LizPack Viewer

Um primeiro mapa online abre muitas vezes outras necessidades: centralizar os dados, recolhê-los no terreno, difundi-los para outros programas, compor mapas no momento. Cada produto LizPack responde a uma delas, com o mesmo software livre e a mesma conta.

Trabalhar numa base PostGIS. A partir do plano Pro, liga-se à base PostGIS da instância a partir do QGIS Desktop ou do pgAdmin, com ligação cifrada, e o LizPack Publisher permite acrescentar as suas tabelas como camadas, importar uma camada para ela e diagnosticá-la. Para volumes maiores, o produto Bases de dados propõe bases dedicadas com PostgreSQL 17 e PostGIS 3.5, de 1 a 10 GB, faturadas por GB. Os seus passos: criar a base escolhendo o tamanho, obter o anfitrião, a porta e as credenciais, carregar os dados a partir do QGIS e ligar a base à sua instância Lizmap para que as suas camadas sejam servidas e editáveis online.

Recolher no terreno. O LizPack Field envia um projeto QGIS para os telemóveis das suas equipas com a aplicação QField, em Android e iOS, com ou sem rede. Os passos: preparar o projeto de recolha no QGIS, publicá-lo no LizPack Field, recolher com o QField e deixar as alterações subirem automaticamente. Com o plano Pro, a 15 USD por mês, os levantamentos são escritos na sua base PostGIS, e o mapa Lizmap que mostra essas camadas é atualizado a cada sincronização. O plano Gratuito inclui 200 MB e um projeto.

Difundir como serviços OGC. O GeoServer Cloud abre um espaço GeoServer isolado, incluído na sua conta, gratuito até 200 MB e 10 camadas. Ative o espaço a partir do painel, envie um Shapefile, um GeoPackage ou um GeoTIFF, ou ligue num clique a base PostGIS de uma instância, publique cada camada em WMS, WFS ou WMTS e acrescente o endereço do serviço no QGIS, no Lizmap, no ArcGIS ou na sua aplicação.

Compor mapas sem projeto. O LizPack Viewer, incluído com o LizPack Field, parte de um mapa vazio no navegador: acrescenta as camadas dos seus projetos ou serviços online pelo seu endereço, guarda-o em « Os meus mapas » com o seu estilo e depois escolhe quem o pode abrir e copia a sua ligação ou o seu código de integração.

Para ver como estes produtos se encaixam num mesmo dispositivo, o guia Como as soluções LizPack se completam põe-nos em perspetiva.

Resumo: da criação da conta ao primeiro mapa online

Eis o caminho completo, resumido. Cada linha corresponde a um passo descrito acima, com a ferramenta utilizada e o que produz.

No total, a parte técnica, a que antes consistia em instalar um servidor, o Lizmap, o QGIS Server e uma base, e configurar um nome de domínio e um certificado, reduz-se à criação da instância. O resto do tempo passa-se onde tem valor: no QGIS, nos seus dados e no próprio mapa.

Se quiser comparar esta abordagem com uma instalação do Lizmap no seu próprio servidor, o guia Instalar o Lizmap por conta própria ou escolher um alojamento gerido põe as duas opções lado a lado, e a página LizPack Map detalha o que inclui uma instância.

Perguntas frequentes