Mapa

Tipo

Referência

Para

Analista

Na tela

DataViz › Aplicação › Dashboards › Editando Widget › Mapa

O Mapa põe o dado no lugar onde ele acontece, seja um estado, uma cidade, uma coordenada de entrega ou o trajeto de um caminhão. Um mapa pode ter várias camadas, uma sobre a outra, como estados coloridos por faturamento e as lojas como pontos.

Nome e aparência seguem as opções comuns.

Camadas Base, acima das abas, escolhe o fundo: Mapa (ruas), Satélite ou os dois. Com os dois marcados, o mapa ganha um seletor para alternar entre eles. Sem nenhum, o fundo fica vazio e os estados e cidades saem com a cor cheia, em vez de semitransparentes.

Aba Dados

Em Camadas de Dados, + Camada acrescenta uma camada do tipo escolhido ao lado do botão. Cada mapa aceita uma camada UF/Cidade só; os outros tipos podem se repetir. Mover para Cima, Mover para Baixo e Excluir Camada organizam as camadas. Cada camada tem os próprios Filtros (veja Filtros).

Tipo de camada	O que desenha	Campos
UF/Cidade	Estados ou cidades pintados conforme o valor.	Coluna de UF (a sigla: SP, MG), Coluna de Cidade, Coluna de Valor, Mostrar apenas UFs quando não houver filtros (aparece quando há coluna de cidade)
Coordenadas	Um alfinete por latitude e longitude.	Mostrar Como (Pontos, Clusters, Mapa de Calor), Coluna de Latitude e Longitude, Colunas de Informações, Coluna Identificadora, Definir limitação de registros
Rotas	Linhas ligando pontos em sequência, uma por rota, cada rota numa cor.	Coluna de Latitude e Longitude, Coluna de Sequência, Coluna de Grupo de Rota, Mostrar marcadores nos pontos da rota (com ele, Coluna Identificadora do Ponto e Colunas de Informações), Definir limitação de registros
GeoJSON	Formas desenhadas a partir de arquivos GeoJSON, como territórios de venda ou bairros.	Coluna com URL do GeoJSON, Colunas de Informações, Coluna Identificadora, Definir limitação de registros

A Coluna de Latitude e Longitude é uma coluna só, com os dois números separados por vírgula: -23.5505,-46.6333. Linha com valor fora desse formato, fora da faixa válida ou em 0,0 fica fora do mapa.

Na Rotas, a Coluna de Sequência dá a ordem dos pontos dentro de cada rota e a Coluna de Grupo de Rota separa uma rota da outra, como a placa do caminhão. Na GeoJSON, cada linha do dado traz a URL de um arquivo, e cada arquivo vira uma ou mais formas.

Com UF e cidade na mesma camada e Mostrar apenas UFs quando não houver filtros ligado, o mapa mostra só os estados até alguém filtrar um; aí passa a mostrar as cidades daquele estado.

Em Coordenadas, Clusters junta os pontos próximos num círculo com a contagem, que se abre ao clicar. Mapa de Calor mostra manchas onde há mais pontos, sem balão nem clique. Para milhares de pontos, os dois leem melhor que Pontos.

Colunas de Informações são os campos que aparecem no balão ao passar o mouse sobre o ponto ou a forma, como nome da loja e faturamento. A Coluna Identificadora vira o título desse balão.

Clique no mapa

Clicar filtra o Dashboard:

Onde	Filtra por
Estado ou cidade	A UF, ou a cidade e a UF
Ponto de Coordenadas ou marcador de Rotas	A Coluna Identificadora (ou Coluna Identificadora do Ponto). Sem ela, a coordenada; na rota, o grupo de rota
Forma de GeoJSON	A Coluna Identificadora. Sem ela, a URL do arquivo

Aba Visual

Na tela	O que faz
Aparência	Padrão, Transparente ou Destacado. Veja Aparência.
Mostrar botões de zoom	Liga os botões + e −. Ligado por padrão.
Configurações Visuais	Um bloco por camada, com as opções abaixo. A camada Rotas não tem opção visual.

Na camada UF/Cidade, Tipo de Coloração decide como o estado ou a cidade ganha cor. Cor Sem Dados vale nos três modos, para o lugar sem valor.

Tipo de Coloração	Como pinta
Gradiente por Valor (padrão)	Degradê de Cor Inicial (menor valor) a Cor Final (maior).
Cor por Coluna	Em Agrupar por, uma coluna que separa os lugares em grupos, como a região. Configurar cores dá a cada valor dessa coluna um par de cores, e cada grupo vira um degradê próprio entre os seus menores e maiores valores. Sem coluna em Agrupar por, cada estado é o próprio grupo.
Faixas de Valor	Configurar faixas define intervalos de valor, cada um com uma cor; o lugar fica com a cor da primeira faixa que contém o valor. Com uma coluna em Agrupar por, cada grupo pode ter as próprias faixas, e o grupo sem faixa usa as faixas padrão.

Na camada GeoJSON, Cor Padrão pinta as formas e Colorir por Coluna dá uma cor automática a cada valor da coluna escolhida, como o nome do território. A camada Coordenadas mostra as mesmas duas opções, mas os pontos saem sempre com o alfinete padrão: as cores não mudam nada nela.

Exemplo

Faturamento por estado com as lojas por cima:

1. + Camada do tipo UF/Cidade: Coluna de UF = Clientes.UF, Coluna de Valor = Vendas.Valor (soma).
2. + Camada do tipo Coordenadas: Coluna de Latitude e Longitude = Lojas.LatLong, Mostrar Como = Pontos, Colunas de Informações = Lojas.Nome.
3. Na aba Visual, para a primeira camada, Cor Inicial clara e Cor Final escura: quem vende mais fica mais escuro.

Limites

Camada	Quantos registros lê	O que fica fora
UF/Cidade	Até 6.000 linhas.	Os lugares de menor valor.
Coordenadas	Até 10.000 pontos. Com Definir limitação de registros, o número em Limite de registros:, de 1 a 1.000.000 (padrão 1.000).	O que passa do limite.
Rotas	Igual a Coordenadas.	Os pontos do fim da sequência.
GeoJSON	Até 10.000 linhas. Definir limitação de registros não muda esse número.	O que passa do limite.

Acima de 10.000 pontos, uma camada Coordenadas em Pontos é desenhada como Clusters; acima de 100.000, em qualquer modo, como Mapa de Calor. Isso só acontece com Definir limitação de registros num número maior que 10.000.

Pelo Lumo CLI

Este widget também pode ser criado e versionado em YAML, com type: Map. Veja a referência de app.