Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

GIS Labels – Modo Fixo e Modo Hover com Zoom Mínimo

O recurso não é ativado por padrão e só funciona quando configurado explicitamente no parâmetro GIS_CONFIG. E também precisa estar com GIS_ENABLED == '1'.


📌 Visão Geral

O sistema agora possui dois modos de exibição de labels:

  1. Modo Fixo ("fixed")
    Os labels são exibidos permanentemente no mapa e organizados automaticamente para evitar sobreposição.

  2. Modo Hover ("hover")
    Os labels aparecem somente quando o usuário passa o mouse sobre a área.
    Também respeita um zoom mínimo configurável.

Além disso, existe a opção:

  1. Desativado ("none")
    Nenhum label é exibido nunca.

📌 Como ativar o recurso

A ativação é feita alterando o parâmetro GIS_CONFIG na tabela nfs_core_par_parametros.

Exemplo de configuração:

{
	"SHOW_LABELS": "hover", /** ou, fixed, none */
	"LABEL_MIN_ZOOM": 10
}

Opções disponíveis:

PropriedadeTipoValoresDescrição
SHOW_LABELSstring"fixed", "hover", "none"Define o modo de exibição dos labels
LABEL_MIN_ZOOMnumberqualquer númeroZoom mínimo para exibir labels (fixos ou hover)

📌 Se não configurar zoom, entra o padrão 16.


📌 Funcionamento dos Modos

🔵 Modo Fixo (SHOW_LABELS = "fixed")

  • Os labels são criados para todas as áreas.
  • Um algoritmo de anti-colisão desloca os labels para evitar sobreposição.
  • Labels aparecem somente no zoom mínimo configurado.
  • Ideal para mapas menos densos.

Demo:


🟠 Modo Hover (SHOW_LABELS = "hover")

  • Nenhum label fixo é criado.
  • Cada área possui um label “oculto”, exibido no mouseover.
  • O label aparece somente se:
    • O mouse estiver sobre a área
    • O zoom atual for ≥ LABEL_MIN_ZOOM
  • A área é destacada com borda mais espessa durante o hover.
  • Ideal para mapas com muitas áreas.

Demo:


📌 Comportamento do Zoom Mínimo

O zoom mínimo funciona igual para os dois modos:

  • Se o zoom do mapa estiver abaixo de LABEL_MIN_ZOOM:
    • No modo fixo → os labels não aparecem
    • No modo hover → o hover não exibe o label

📌 Resumo

  • O recurso não é ativado automaticamente
  • É necessário configurar explicitamente no GIS_CONFIG
  • Existem três modos: fixed, hover, none
  • O modo hover inclui highlight e zoom mínimo
  • O modo fixed inclui anti-colisão e zoom mínimo