Documentação HorusBI
Buscar K

Aparência

Mapa ​

O Widget de Mapa é uma ferramenta geoespacial completa que permite visualizar dados através de múltiplas camadas sobrepostas. Ele suporta desde mapas simples de vendas por estado até rotas de logística complexas ou mapas de calor baseados em coordenadas precisas.

🌍 Funcionalidades Principais ​

  • Multicamadas: É possível adicionar várias camadas de dados diferentes no mesmo mapa (uma camada de calor para densidade populacional e uma camada de pontos para lojas)
  • Motor de Renderização: Utiliza Leaflet (OpenSource), leve e rápido. Suporta camadas base de Mapa e Satélite
  • Clusterização e Calor: Agrupa automaticamente pontos muito próximos ou gera mapas de calor para alta densidade

🗂️ Tipos de Camada ​

1. UF / Cidade ​

Colore estados ou cidades geográficas com base em um valor.

  • Dados: Requer uma coluna com a sigla do estado (UF) e/ou nome da Cidade
  • Visualização: O mapa é colorido gradualmente (Escala de Cor) baseada no valor da métrica
  • Drill-down Automático: Se configurado com UF e Cidade, ao clicar em um estado, o mapa foca e mostra as cidades daquela região selecionada

2. Coordenadas (Lat/Long) ​

Plota pontos exatos no mapa usando latitude e longitude.

  • Dados: Requer uma coluna com coordenadas (formato lat, long ou colunas separadas, dependendo da fonte)
  • Modos de Exibição:
    • Pontos: Marcadores individuais
    • Cluster: Agrupa pontos próximos (evita poluição visual)
    • Mapa de Calor: Cria manchas de calor baseadas na densidade de pontos

3. Rotas ​

Desenha caminhos sequenciais entre pontos. Ideal para logística e rastreamento.

  • Dados Necessários:
    • Lat/Long: Posição dos pontos
    • Sequência: Coluna de ordem dos pontos para traçar a linha corretamente (Textual, Numérica ou Data e Hora)
    • Grupo de Rota: Identificador da rota (Placa do Caminhão), para separar linhas diferentes
  • Marcadores: Opcionalmente, exibe "alfinetes" em cada parada da rota

4. GeoJSON ​

Renderiza formas geométricas personalizadas a partir de uma URL ou arquivo GeoJSON.

  • Uso: Mapas customizados (planta de um shopping, divisões de territórios de vendas não-padrão, bairros específicos)
  • Vinculação: Permite colorir as formas baseando-se em dados da Aplicação (pelo ID da forma)

🎨 Configuração Visual ​

Aparência ​

  • Aparência: Padrão, Transparente, Destacado
  • Camadas Base: Escolha entre visualização Mapa (vetorial/ruas) ou Satélite (fotos reais)
  • Controles: Opção para mostrar/ocultar botões de Zoom

Configuração por Camada (Layer) ​

Cada camada adicionada tem configurações independentes na aba Visual:

  • Limitação de Registros: Define um teto de pontos (1000) para garantir performance em hardwares mais modestos
  • Cores:
    • UF/Cidade: Gradiente de cor (Início -> Fim) e sem cor para "Sem Dados"
    • Pontos/GeoJSON: Cor única ou coloração dinâmica baseada em uma coluna de dimensão

Opções Avançadas de Coordenadas ​

Para camadas de Lat/Long, é possível escolher o modo de exibição:

  • Pontos: Marcadores individuais
  • Cluster: Agrupa pontos próximos em um círculo numérico que se expande ao clicar. Ideal para milhares de pontos
  • Mapa de Calor (Heatmap): Manchas de densidade baseadas na concentração de pontos

💡 Dicas de Otimização ​

TIP

Performance e Otimização Automática: Para garantir a fluidez do Dashboard, o Widget aplica regras automáticas baseadas no volume de dados na camada de Coordenadas:

  • Acima de 10.000 pontos: O modo é alterado automaticamente para Cluster para evitar travamentos.
  • Acima de 100.000 pontos: O modo é alterado automaticamente para Mapa de Calor.