# Gerenciar um mapa com locais e rotas

[Abra Configurações](https://calendar.pw-tools.net/admin/map/settings)

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

[Abra Configurações](https://calendar.pw-tools.net/admin/map)

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

[Abra Configurações](https://calendar.pw-tools.net/admin/map)

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.