Gerenciar um mapa com locais e rotas
Este documento fornece uma visão geral abrangente do recurso Mapa no aplicativo, explicando sua funcionalidade da perspectiva dos usuários padrão (publicadores) e dos coordenadores (administradores).
Visão geral
O recurso Mapa permite que as congregações gerenciem e exibam visualmente pontos geográficos de interesse (Locais) e áreas/caminhos (Rotas). Pode ser usado para coordenar locais de testemunho público, definir territórios específicos ou destacar áreas importantes para os publicadores.
O mapa utiliza blocos OpenStreetMap e Leaflet para renderização. Ele também oferece suporte à exibição de localizações de usuários, exibição de limites de congregações e upload de imagens para locais específicos.
Funções de usuário
- Usuários padrão (editores): Podem visualizar o mapa, locais, rotas e detalhes associados (como imagens e dicas) se o mapa for tornado visível para eles por um Coordenador.
- Coordenadores (Administradores): Tenha acesso total ao gerenciamento. Eles podem definir configurações de mapa, criar/editar/excluir locais e rotas, gerenciar imagens de localização e desenhar polígonos para rotas.
Visualização de usuário padrão (editor)
Se o Coordenador tiver ativado a configuração "Mapa visível para todos os editores", os usuários padrão poderão acessar o mapa por meio do menu de navegação (em Outros -> Mapa).
Visualizando o mapa
- Centralização automática: O mapa ajusta automaticamente seus limites para se adequar a todos os locais e rotas disponíveis. Se nenhum estiver presente, o padrão é o ponto central configurado pelo Coordenador.
- Marcadores e formas:
- Os locais são exibidos como marcadores de mapa com cores e ícones personalizados.
- Rotas são exibidas como polígonos ou linhas coloridas no mapa.
- Fronteiras da Congregação são exibidas como contornos laranja não interativos (se habilitados pelo Coordenador).
- Estilo do mapa: O mapa pode ser exibido em cores padrão ou em escala de cinza (monocromático) com base nas configurações do calendário.
Interagindo com Elementos do Mapa
Clicar em um marcador (Local) ou em um polígono (Rota) abre uma caixa de diálogo de detalhes:
- Detalhes do local:
- Exibe o nome e a descrição.
- Mostra Dicas importantes (destacadas em vermelho para visibilidade).
- Exibe uma galeria de imagens associadas. Clicar em uma miniatura abre um Lightbox em tela cheia para ampliar e navegar pelas imagens.
- Detalhes da rota:
- Exibe o nome e a descrição.
- Lista todos os locais associados a essa rota específica.
Recurso "Localize-me"
Os usuários podem clicar no botão "Mostrar minha localização" (ícone de destino no canto superior direito do mapa) para solicitar que seu navegador encontre e exiba sua posição geográfica atual no mapa. Isto é útil para encontrar os locais de testemunho mais próximos.
Visualização do Coordenador (Administrador)
Os coordenadores gerenciam o recurso Mapa na área Admin em Gerenciar Mapa (`/admin/map`). A partir daqui, eles podem definir configurações globais, gerenciar locais e gerenciar rotas.
1. Configurações do mapa
Acessado através do ícone de configurações (engrenagem) no painel Gerenciar Mapa.
Latitude e Longitude Central
- Latitude do centro
- Longitude do centro
- Escolher centro no mapa
O que faz: Define o ponto central geográfico padrão do mapa. Isso determina a visualização inicial quando o mapa é carregado.
Onde aparece/Efeito: Na visualização principal do mapa, quando qualquer usuário abre a seção do mapa, o mapa inicialmente se deslocará para essas coordenadas exatas.
Mapa visível para todos os editores
O que faz: Alterna se o recurso do mapa é restrito a administradores e coordenadores ou também acessível a usuários padrão (editores).
Onde aparece/Efeito: Controla a aparência do link do menu Mapa na navegação principal. Se ativado, todos os editores verão o item "Mapa" em seu menu e poderão visualizar os locais e rotas configurados.
Usar azulejos monocromáticos
O que faz: Altera o estilo do mapa base de colorido para tons de cinza (monocromático).
Onde aparece/Efeito: Aplica-se diretamente aos planos de fundo do mapa visualizados por todos os usuários. O fundo do mapa fica em preto e branco, o que pode ajudar as rotas coloridas personalizadas e os marcadores de localização a se destacarem com mais destaque.
Mostrar limites da congregação
O que faz: Permite o desenho de linhas de limites de congregação predefinidas no mapa.
Onde aparece/Efeito: Uma sobreposição de fronteiras será sobreposta na visualização principal do mapa para todos os usuários, delineando áreas específicas.
2. Gerenciando Locais
Os locais representam pontos específicos no mapa (por exemplo, um local de carrinho, um ponto de encontro).
Criando/Editando um Local:
Nome
O que faz: O identificador principal ou título do local.
Onde aparece/Efeito: Aparece como título quando um usuário clica no marcador de localização no mapa, na lista de locais na área de administração e em qualquer menu suspenso de associação.
Cor / Ícone
- Cor:
- O que faz: Determina a tonalidade da cor do marcador do mapa.
- Onde aparece/Efeito: O ícone de alfinete na visualização real do mapa será renderizado na cor selecionada.
- Ícone:
- O que faz: Permite a seleção de um símbolo ou glifo específico para ser colocado dentro do marcador do mapa.
- Onde aparece/Efeito: O ícone selecionado ficará visível dentro do alfinete colorido na visualização do mapa, ajudando os usuários a identificar rapidamente o tipo de local.
Coordenadas
Latitude e longitude. Uma ferramenta "Seletor de coordenadas" é fornecida para selecionar o ponto exato em um mapa.
Descrição
O que faz: Um campo rich text para fornecer informações gerais sobre o local.
Onde aparece/Efeito: Aparece no pop-up ou no painel de detalhes quando um usuário clica no marcador de localização no mapa.
Notas importantes
O que faz: Um campo rich text secundário específico para alertas, regras ou avisos críticos relacionados ao local.
Onde aparece/Efeito: Aparece em destaque no painel de detalhes do local quando clicado no mapa, geralmente com estilo para chamar a atenção do usuário.
Rotas associadas
O que faz: Vincula o local a uma ou mais rotas predefinidas.
Onde aparece/Efeito: Atualmente atua como um agrupamento lógico. Quando rotas ou locais são consultados, eles são vinculados no banco de dados, o que pode influenciar a forma como são filtrados ou exibidos juntos no mapa.
Período de validade
O que faz: Define uma data de início e término para quando este local deve ser considerado ativo.
Onde aparece/Efeito: Se a data atual estiver fora desse intervalo, o local será automaticamente ocultado da visualização do mapa público, mesmo se a opção "Ativo" estiver marcada.
Ativo
O que faz: Uma chave mestre para ativar ou desativar totalmente o local.
Onde aparece/Efeito: Se desmarcado, o marcador de localização desaparece do mapa para todos os usuários imediatamente, independentemente do seu período de validade.
Gerenciando imagens de localização:
Depois de salvar um local, os coordenadores podem fazer upload de imagens para ele.
- As imagens são redimensionadas automaticamente em versões pequenas (600 px de largura) e grandes (1600 px de largura) para carregamento otimizado na galeria frontend e lightbox.
- Os coordenadores podem fornecer um Título e uma Descrição para cada imagem.
- As imagens podem ser alternadas como Ativas ou totalmente excluídas.
3. Gerenciando Rotas
As rotas representam polígonos, linhas ou áreas específicas no mapa (por exemplo, uma zona específica de testemunho público, um caminho para caminhada).
Criando/Editando uma Rota:
Nome
O que faz: O identificador principal da rota.
Onde aparece/Efeito: Visível na lista de rotas da área de administração, nos menus suspensos da associação e como título se a rota for clicada no mapa.
Cor
O que faz: Define a cor das linhas da rota e da área de preenchimento.
Onde aparece/Efeito: A forma desenhada no mapa será renderizada nesta cor com opacidade variável.
Descrição
O que faz: Texto geral detalhando informações sobre o percurso.
Onde aparece/Efeito: Visível ao clicar na área da rota no mapa.
Gaveta de Rota (Polígonos)
Uma ferramenta de mapa interativo que permite ao Coordenador desenhar formas (polígonos) diretamente no mapa para definir os limites geográficos da rota.
Associações
- Locais associados:
- O que faz: Vincula a rota a um ou mais locais de mapa predefinidos.
- Onde aparece/Efeito: Permite que os locais sejam agrupados logicamente nesta rota. Isso pode afetar as visualizações de filtro ou agrupamento no mapa principal.
- Itens reserváveis associados:
- O que faz: Vincula a rota geográfica a itens de calendário que os usuários podem reservar.
- Onde aparece/Efeito: Isso vincula o recurso do mapa diretamente ao calendário de reservas. Quando um usuário está interagindo com um item reservável específico, esta rota pode ser referenciada ou mostrada.
- Campanhas Associadas:
- O que faz: Vincula a rota geográfica a campanhas de reserva específicas (agrupamentos lógicos de turnos).
- Onde aparece/Efeito: Ao gerenciar ou visualizar campanhas no calendário, esse contexto geográfico fornece uma representação visual de onde a campanha ocorre no mapa.