Um mapa mostra onde; um painel diz quanto. Este guia destina-se aos serviços de SIG, às autarquias e aos gabinetes de estudos que querem acrescentar indicadores e gráficos ao seu portal. Apresenta as três formas de construir um painel Lizmap, da mais simples à mais completa, como as configurar e os erros que tornam um painel inútil.
Porquê um painel Lizmap
Eleitos, direções e parceiros raramente leem um mapa em pormenor. O que pedem cabe muitas vezes em poucos números: processos por freguesia, metros de rede renovados, área por tipo de ocupação, evolução de um ano para o outro. Se esses números forem calculados à parte, numa folha de cálculo, depressa divergem dos dados do mapa, e acaba-se a apresentar numa reunião duas versões da mesma realidade.
Um painel Lizmap resolve este problema: os indicadores são calculados a partir das mesmas camadas do mapa, no mesmo portal, com as mesmas permissões de acesso. Quando o dado muda, o número muda. O técnico de SIG deixa de ter de refazer um quadro a cada pedido, e todos consultam a mesma fonte.
- Acompanhar um programa: avanço das obras, orçamento comprometido, objetos tratados no ano.
- Prestar contas: números-chave para uma reunião de câmara, um comité de acompanhamento ou um relatório anual.
- Identificar: zonas onde se concentram as ocorrências, equipamentos que acumulam avarias.
- Comparar: um ano com o anterior, um setor com outro.
Existem três ferramentas, que não respondem à mesma necessidade: os gráficos Dataviz integrados no Lizmap, o módulo de painéis proposto pelo LizPack e o MapBuilder, que permite aos utilizadores compor os seus próprios mapas. As secções seguintes detalham-nas uma a uma.
Nível 1: os gráficos Dataviz do Lizmap
O Lizmap Web Client sabe mostrar gráficos sem instalar mais nada. Configuram-se no painel Dataviz do plugin Lizmap do QGIS Desktop. Segundo a documentação oficial do Lizmap, estes gráficos assentam no Plotly, o mesmo motor do plugin DataPlotly do QGIS, e são propostos nove tipos:
- dispersão, barras, circular e histograma, para as necessidades correntes;
- diagrama de caixa, para comparar distribuições;
- histograma bidimensional e diagrama polar, para análises mais finas;
- diagrama em raios de sol (sunburst), para dados hierárquicos;
- um tipo HTML, que mostra valores calculados num modelo escrito por si, prático para um número-chave.
Os gráficos aparecem num painel do portal, colocado conforme a definição do projeto: à esquerda, em baixo ou à direita do mapa. Podem também aparecer nas janelas de informação: para uma camada ligada a outra por uma relação, o Lizmap pode mostrar na ficha de um objeto pai um gráfico limitado aos seus objetos filhos, por exemplo as intervenções num único equipamento.
- Vantagens: nada a instalar, configuração no QGIS, gráficos interativos, possibilidade de mostrar um gráfico apenas quando a sua camada está visível.
- Limites: cada gráfico descreve uma camada; compor uma página de números-chave, tabelas dinâmicas e gráficos ligados entre si exige outra coisa.
- Ideal para: ilustrar uma camada com um ou dois gráficos, ou enriquecer as fichas de informação.
Vale a pena conhecer o tipo HTML: calcula valores sobre a camada, por exemplo um total ou uma média, e insere-os num pequeno modelo redigido por si. Obtém-se assim um número-chave legível, acompanhado de uma frase, sem gráfico. Combinado com alguns gráficos de barras, basta muitas vezes para um primeiro painel simples.
Configurar um gráfico Dataviz passo a passo
Primeiro, a camada tem de ser publicada em WFS e a sua chave primária publicada nas propriedades da camada: é um pré-requisito indicado pela documentação do Lizmap. Depois:
- No QGIS, abra o plugin Lizmap a partir do menu Web e depois o painel Dataviz.
- Acrescente um gráfico e escolha o tipo; o formulário adapta-se ao tipo escolhido.
- Dê-lhe um título claro e, se necessário, uma descrição: aceita HTML para uma frase explicativa ou uma fonte.
- Escolha a camada, o campo do eixo X e uma ou várias séries de valores.
- Para barras ou gráficos circulares, escolha a agregação: soma, média, contagem, mediana, desvio-padrão, mínimo, máximo, primeiro ou último valor.
- Defina a apresentação da legenda e, se quiser, a apresentação nas fichas da camada pai.
- Guarde a configuração Lizmap, guarde o projeto e volte a publicá-lo.
A formatação avançada (cores, eixos, margens) passa por uma definição de layout em formato JSON que segue a referência do Plotly. Comece sem ela: as definições por omissão são legíveis, e poderá afinar o aspeto mais tarde, quando o gráfico tiver ,do a sua utilidade.
Preparar dados que deem bons indicadores
Um painel vale o que valem os seus dados. Os mesmos defeitos repetem-se em quase todos os projetos, e corrigem-se na base, não no gráfico:
- Categorias coerentes. Rede viária, rede viária e REDE VIÁRIA escritas de três formas dão três barras diferentes. Use listas de valores fechadas nos formulários de introdução e corrija o que já existe.
- Datas verdadeiras. Uma data guardada como texto não se ordena nem se agrupa por mês. Use um verdadeiro campo de data.
- Unidades explícitas. Indique no título ou na descrição se um número está em metros, em hectares ou em número de objetos.
- Vistas em vez de cópias. Se um indicador exigir um cálculo (uma junção, um agrupamento), crie uma vista no PostGIS em vez de uma tabela copiada: a vista fica sempre atualizada.
- Índices. Numa tabela grande, um índice nos campos filtrados ou agrupados acelera muito a apresentação.
- Valores em falta tratados. Um campo vazio não é zero nem uma categoria: decida como o contar e diga-o na descrição do indicador.
Se os seus dados ainda estão em ficheiros, é o momento de os passar para o PostGIS, onde vistas, índices e edição partilhada se tornam possíveis. O guia Publicar um mapa Lizmap a partir do QGIS explica como publicar camadas PostGIS e porque evitam voltar a publicar o projeto a cada atualização.
Nível 2: o módulo de painéis
Para uma verdadeira página de indicadores, o LizPack, uma infraestrutura geoespacial de código aberto que aloja e mantém o Lizmap, propõe um módulo de painéis que se acrescenta a um portal Lizmap. Os painéis são compostos no QGIS e depois publicados ao lado do seu projeto. Reúnem:
- indicadores, ou seja, números-chave;
- gráficos;
- tabelas dinâmicas;
- listas.
Os elementos filtram-se uns aos outros: uma seleção num restringe os restantes. São recalculados a cada visualização, a partir de dados atualizados. Assim, prepara o painel onde já prepara o mapa, no QGIS, e publica-o da mesma forma, por exemplo com o complemento LizPack Publisher.
Os módulos instalam-se numa instância LizPack Map iniciada, em Lizmap 3.9. Cada módulo indica as versões do Lizmap com que funciona.
A diferença em relação aos gráficos Dataviz é de escala: o Dataviz acrescenta gráficos a um mapa, enquanto o módulo compõe uma página inteira dedicada aos números, onde os elementos se respondem. Pode usar os dois no mesmo portal: gráficos nas fichas de informação para o pormenor e um painel para a visão de conjunto.
Nível 3: MapBuilder para compor mapas a pedido
O MapBuilder responde a outra necessidade: deixar que os seus utilizadores componham eles próprios um mapa a partir das camadas publicadas, sem passar pelo QGIS, e o guardem. É um módulo livre desenvolvido pela 3Liz, o editor do Lizmap, publicado sob licença MPL 2.0 no GitHub.
- Combinar projetos. A documentação do módulo dá o exemplo de um projeto OpenStreetMap e de um projeto de plano de urbanização reunidos no mesmo mapa.
- Imprimir. O mapa composto exporta-se para PDF diretamente a partir do navegador.
- Administrar. O módulo configura-se a partir da administração do Lizmap.
- Acompanhar as versões. Cada versão do MapBuilder corresponde a uma versão do Lizmap Web Client: atualizam-se em conjunto, e o README do módulo indica qual vai com qual.
O MapBuilder é útil quando cada serviço quer a sua própria vista sobre os mesmos dados de referência sem pedir um novo mapa à equipa de SIG. Associado ao módulo de painéis, dá um portal onde se consultam números atualizados e se constroem mapas próprios, sem sair dos dados de referência.
O MapBuilder não cria dados: reutiliza as camadas já publicadas no portal. A qualidade dos mapas compostos depende, portanto, da qualidade dos projetos QGIS de origem, dos seus estilos e dos nomes das suas camadas. Dados de referência bem nomeados e bem organizados tornam o MapBuilder útil de imediato; um projeto com camadas mal nomeadas torna-o confuso.
Pôr em funcionamento um painel Lizmap com o LizPack Map
- Na área de cliente, abra a ficha da instância iniciada, separador de módulos.
- Escolha o módulo: cada um apresenta o que acrescenta, a sua versão e a sua documentação.
- Ative-o: o módulo instala-se em menos de um minuto, sem interromper o portal.
- Componha o painel no QGIS e publique-o ao lado do seu projeto.
- Abra o portal: o painel está disponível, ao lado do seu projeto.
Desativar o módulo retira-o da instância sem tocar nos seus projetos nem nos seus dados. Os módulos acrescentados fazem parte da configuração da instância, guardada e reposta com ela, de modo que uma reposição recupera os painéis juntamente com os mapas.
Ainda não tem instância? O LizPack Map põe uma online em cerca de quatro minutos, com o QGIS Server e uma base PostGIS já ligados, e um teste gratuito de 30 dias.
Antes de anunciar o painel, abra-o com uma conta de cada grupo de utilizadores em causa: verifique que os números aparecem, que os filtros respondem e que ninguém vê dados que não lhe são destinados.
As regras de um painel útil
Um painel não é um catálogo de todos os números disponíveis na base de dados ou nas folhas de cálculo do serviço. Os mais úteis respeitam algumas regras simples:
- Partir de uma pergunta. Em que ponto está o programa de renovação? dá um painel melhor do que mostremos os dados da rede viária.
- Poucos indicadores. Cinco a oito elementos bem escolhidos leem-se; vinte passam-se os olhos.
- Uma definição por número. O que se conta, desde quando, com que fonte: uma frase sob cada indicador evita discussões nas reuniões.
- O gráfico certo. Barras para comparar categorias, uma linha para uma evolução, gráficos circulares apenas para algumas partes de um todo.
- As permissões certas. Um painel interno deve ficar reservado aos grupos em causa, tal como o mapa que o acompanha.
- Um responsável. Alguém tem de verificar regularmente que os dados estão atualizados e que os números continuam certos, e ser a pessoa a contactar quando um número parece errado.
Pense também no desempenho. Como os elementos são recalculados a cada visualização, uma consulta pesada a uma tabela grande torna todo o painel mais lento. Prepare os cálculos complexos em vistas PostGIS, indexe os campos filtrados e teste a apresentação com o volume real de dados antes de apresentar o painel.
Exemplos de utilização
Algumas situações típicas, para imaginar o que cada ferramenta traz:
| Situação | O que se mostra | Ferramenta adequada |
|---|---|---|
| Um município acompanha a iluminação pública. | Número de pontos de luz por freguesia, avarias comunicadas por mês. | Módulo de painéis, sobre uma camada PostGIS atualizada pelos técnicos. |
| Uma entidade gestora de água apresenta a sua rede. | Extensão por material e por década de instalação. | Gráficos Dataviz de barras, sobre a camada da rede. |
| Um serviço de urbanismo instrui processos. | Na ficha de uma parcela, o histórico dos seus processos. | Gráfico Dataviz filtrado nas fichas da camada pai. |
| Vários serviços partilham dados de referência. | Cada serviço compõe o seu próprio mapa temático. | MapBuilder. |
Em cada um destes casos, o procedimento é o mesmo: partir da pergunta dos utilizadores, verificar que o dado necessário existe e está limpo, escolher a ferramenta mais simples que lhe responde e mostrar uma primeira versão às pessoas em causa antes de a enriquecer. Um painel constrói-se por etapas, não de uma só vez, e a primeira versão raramente é a última.
Estes exemplos ilustram as funções descritas acima; não são referências de clientes.
Que ferramenta para que necessidade
| Necessidade | Ferramenta adequada | Onde se configura |
|---|---|---|
| Um gráfico para ilustrar uma camada. | Gráficos Dataviz do Lizmap. | Plugin Lizmap, no QGIS. |
| Uma página de indicadores, gráficos e quadros ligados. | Módulo de painéis. | QGIS, depois publicação ao lado do projeto. |
| Mapas compostos pelos próprios utilizadores. | MapBuilder. | No portal, pelo utilizador; definições na administração do Lizmap. |
Está a comparar estas ferramentas com painéis proprietários? O guia Lizmap ou ArcGIS Online aborda esta escolha para uma autarquia, e o guia O que faz o LizPack recorda aquilo de que o LizPack trata em torno do Lizmap.
Perguntas frequentes
O Lizmap permite criar painéis?
Sim. O Lizmap mostra nativamente gráficos Dataviz configurados no plugin Lizmap. Para páginas completas de indicadores, gráficos e quadros ligados, o LizPack propõe um módulo de painéis.
Como acrescentar um gráfico no Lizmap?
Publique a camada em WFS com a sua chave primária, abra o painel Dataviz do plugin Lizmap, configure o gráfico, guarde a configuração e volte a publicar o projeto.
Que tipos de gráficos propõe o Lizmap?
Nove tipos, baseados no Plotly: dispersão, circular, histograma, caixa, barras, histograma bidimensional, polar, sunburst e HTML.
O que é o MapBuilder no Lizmap?
Um módulo livre da 3Liz que permite aos utilizadores compor um mapa a partir das camadas publicadas, sem QGIS, guardá-lo e exportá-lo para PDF.
É preciso uma instância LizPack Map para o módulo de painéis?
Sim. Instala-se numa instância LizPack Map iniciada, em Lizmap 3.9, a partir do separador de módulos da instância.
Soluções citadas
- LizPack MapLizmap, QGIS Server, PostGIS e cache de mosaicos. DNS e SSL automáticos.
- LizPack PublisherPublique os seus projetos QGIS na sua instância Lizmap, gira os seus ficheiros e a sua base PostGIS sem sair do QGIS.
- Módulos LizmapPainéis, composição de mapas a pedido: módulos ativados num clique na sua instância Lizmap.