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:
-
Modo Fixo (
"fixed")
Os labels são exibidos permanentemente no mapa e organizados automaticamente para evitar sobreposição. -
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:
- 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:
| Propriedade | Tipo | Valores | Descrição |
|---|---|---|---|
SHOW_LABELS | string | "fixed", "hover", "none" | Define o modo de exibição dos labels |
LABEL_MIN_ZOOM | number | qualquer número | Zoom 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
hoverinclui highlight e zoom mínimo - O modo
fixedinclui anti-colisão e zoom mínimo