|Documentação

Publicar os seus mapas

Carregar um projeto na sua instância

Publicar um mapa é carregar o seu projeto QGIS e os respetivos dados no espaço de ficheiros da instância. Pode fazê-lo a partir do QGIS com a extensão LizPack Publisher, ou a partir da área de cliente com o gestor de ficheiros, como se descreve abaixo.

  1. Na ficha da instância, clique em Ficheiros. O gestor de ficheiros abre na Raiz do espaço.
  2. Crie uma pasta para o projeto com o botão Nova pasta da barra de ferramentas e abra-a.
  3. Clique em Enviar: a janela Enviar propõe Carregar uma pasta, para enviar de uma só vez a pasta do projeto, ou Carregar ficheiros. Também pode arrastar ficheiros ou pastas diretamente para a lista.
  4. A janela de acompanhamento mostra o envio e depois o Processamento pelo servidor, que verifica os projetos. Feche-a quando apresentar Concluído.

O projeto deve estar guardado no formato .qgs e acompanhado do seu ficheiro de configuração Lizmap (consulte a página seguinte). Os seus dados seguem com ele: ficheiros arrumados na mesma pasta, indicados por caminhos relativos, ou tabelas na base de dados da instância. Para grandes volumes, a base de dados é preferível: a renderização é mais rápida e vários projetos leem a mesma tabela sem a copiar.

Uma camada que aponta para um ficheiro que ficou no seu computador aparecerá vazia online: o servidor não tem acesso ao seu disco. O validador de projeto deteta esses caminhos antes do carregamento.

O que o carregamento verifica

Cada projeto .qgs é examinado à chegada. Dois defeitos levam à sua recusa: ligações PostgreSQL que não apontam para a base de dados desta instância (anfitrião, base de dados, porta, utilizador e palavra-passe da ficha), e camadas que não têm todas o mesmo sistema de coordenadas, excluindo os mapas de fundo. A janela intitula-se então Carregamento incompleto e indica, em Detalhes, as camadas e os valores em causa. Os restantes ficheiros do envio ficam devidamente guardados.

Os outros defeitos não impedem a publicação. A janela anuncia Publié e indica as camadas a vigiar, as que tornarão o mapa lento.

Não precisa de alterar nada nas ligações à base de dados. O seu projeto mantém o endereço público da base de dados, o da ficha; no carregamento, fazemo-lo passar pela rede interna da instância, e um projeto transferido a partir de Ficheiros recupera o endereço público, pronto a reabrir no QGIS.

A página inicial do portal: os projetos publicados, organizados por repositório Lizmap, cada um com a sua imagem, o seu título e o botão que abre o mapa.

A página inicial do portal organiza os projetos por repositório Lizmap. Se um projeto carregado não aparecer, verifique se tem o seu ficheiro de configuração e depois, na administração do Lizmap, se a sua pasta está declarada como repositório e se a sua conta tem permissão para a ver.

O ficheiro de configuração Lizmap

Um projeto publicado assenta em dois ficheiros colocados lado a lado: o projeto QGIS, por exemplo commune.qgs, e a sua configuração Lizmap, commune.qgs.cfg. O segundo define como o mapa se comporta online: camadas visíveis à partida, ferramentas oferecidas aos visitantes, extensão da primeira visualização, mapas de fundo.

Este ficheiro é produzido no QGIS com a extensão Lizmap, quando configura o mapa web. Esta extensão não é nossa; a sua documentação descreve cada opção.

Sem ficheiro de configuração, o projeto não aparece no portal. Não é uma avaria da instância: nada indica ao portal que deve publicar esse projeto.

Após qualquer alteração no QGIS ou na extensão Lizmap, volte a carregar os dois ficheiros em conjunto. O gestor assinala os Ficheiros existentes; Substituir substitui a versão antiga, sem possibilidade de recuperação.

Se o seu projeto apresentar camadas do seu espaço GeoServer LizPack, ajustamos a configuração no carregamento: essas camadas passam pela sua instância em vez de serem chamadas diretamente pelo navegador, e as suas credenciais GeoServer não chegam aos seus visitantes.

O mapa online: grupos, caixas de visibilidade, legenda e escolha do mapa de fundo seguem a organização do projeto e da sua configuração.
A extensão LizPack Publisher envia a partir do QGIS o projeto, a sua configuração e os seus dados de uma só vez: consulte Publicar a partir do QGIS.

Reutilizar os seus mapas noutros locais

Cada projeto publicado é também servido pelos protocolos normalizados da cartografia online. Outros programas podem assim apresentar ou consultar as suas camadas sem copiar os dados.

  • WMS: o mapa sob a forma de imagens, para o apresentar noutro programa ou noutro site.
  • WFS: os próprios objetos, com os seus atributos, para os consultar ou analisar.
  • WMTS: mosaicos em escalas fixas, para uma visualização rápida.

O endereço de um projeto segue sempre o mesmo modelo: https://o-seu-nome.lizpack.com/index.php/lizmap/service?repository=repositorio&project=projeto, em que repositorio é o repositório Lizmap e projeto o nome do ficheiro sem .qgs. No QGIS, adicione-o como ligação WMS/WMTS ou WFS. O cartão QGIS Server da ficha da instância indica o endereço da instância e os Protocolos disponibilizados.

Um projeto público consome-se sem credenciais. Um projeto restrito exige uma conta do seu portal, com as respetivas permissões.

Um projeto público expõe por WFS os seus dados tal como estão, atributos incluídos. Se alguns não puderem sair, restrinja o acesso ao projeto: não conte com o facto de ninguém encontrar o endereço.

Validar um projeto antes de o publicar

O validador examina um projeto QGIS sem o publicar: nada é guardado, nada é colocado online. Lê o projeto e consulta as tabelas que utiliza na base de dados da instância. Serve antes de um carregamento, ou para perceber porque é que um mapa já publicado se apresenta mal.

A validação: escolha um projeto já carregado, ou carregue um ficheiro do seu computador. Nada é publicado.
  1. No gestor de ficheiros da instância (Ficheiros na sua ficha), abra Mais ações, os três pontos da barra de ações, e escolha Validar o projeto.
  2. Se a pasta aberta contiver um único projeto .qgs, a análise começa imediatamente. Caso contrário, a página Validação de projeto pergunta Que projeto pretende analisar?: escolha um projeto da instância, ou carregue um ficheiro .qgs do seu computador.
  3. Aguarde alguns segundos durante a análise: a página mostra a etapa em curso.

Só são aceites ficheiros .qgs. Um projeto .qgz analisado a partir do seu computador tem de ser primeiro guardado novamente no formato .qgs no QGIS.

Ler o relatório

Se as ligações do projeto não apontarem para a base de dados da instância, uma faixa anuncia-o no topo: Ce projet serait refusé au dépôt, com a lista das ligações com erro. Segue-se uma fila de filtros: Todos e depois um filtro por gravidade com o seu número de avisos. Clicar num filtro mostra apenas essa gravidade; clicar de novo, ou em Todos, repõe a lista completa.

O relatório: uma fila de filtros e depois uma secção por tipo de aviso, com as suas camadas, a sua consequência e a solução a copiar.
GravidadeO que significaExemplos
BloqueanteA camada ou o mapa não será apresentado corretamente, ou de todo.Camada temporária, caminho do seu computador, tabela inexistente na base de dados, sistema de coordenadas em falta, camadas em projeções diferentes, demasiados layouts de impressão.
ImportanteO mapa pode ficar lento ou dar erro.Tabela sem chave primária inteira, expressão que consulta outras camadas para cada objeto, sistema de coordenadas diferente do da base de dados, extensão nula.
ObservaçãoNada falha hoje, mas a visualização ficará mais lenta com o volume.Camada grande desenhada em todas as escalas, estatísticas de tabela nunca calculadas, polígonos muito detalhados.

Os avisos da mesma natureza ficam reunidos numa só secção: a tabela das camadas em causa, o que se constata em cada uma, a Consequência e a Solução a aplicar no QGIS ou na base de dados. Acima de cinco camadas, uma ligação por baixo da lista mostra as restantes. Quando a solução é um comando, Copiar copia-o, para todas as camadas de uma vez. Corrija primeiro as secções Bloqueante, guarde o projeto e volte a executar a análise. Quando não restar nada, a página apresenta Nenhum defeito detetado.

Exportar em CSV e Exportar em JSON guardam o relatório no seu computador. O CSV abre numa folha de cálculo; anexe-o à sua mensagem se escrever ao suporte a propósito deste projeto. Voltar aos ficheiros leva-o de volta ao gestor de ficheiros.