# Gestisci una mappa con posizioni e percorsi

[Apri Impostazioni](https://calendar.pw-tools.net/admin/map/settings)

Questo documento fornisce una panoramica completa della funzionalità Mappa all'interno dell'applicazione, spiegandone le funzionalità dal punto di vista sia degli utenti standard (editori) che dei coordinatori (amministratori).

## Panoramica

La funzione Mappa consente alle congregazioni di gestire e visualizzare visivamente punti di interesse geografici (Posizioni) e aree/percorsi (Percorsi). Può essere usato per coordinare i luoghi della testimonianza pubblica, definire territori specifici o evidenziare aree importanti per i proclamatori.

La mappa utilizza i riquadri OpenStreetMap e il Leaflet per il rendering. Supporta inoltre la visualizzazione delle posizioni degli utenti, la visualizzazione dei confini della congregazione e il caricamento di immagini per posizioni specifiche.

## Ruoli utente

*   **Utenti standard (editori):** Può visualizzare la mappa, le posizioni, i percorsi e i dettagli associati (come immagini e suggerimenti) se la mappa gli viene resa visibile da un Coordinatore.
*   **Coordinatori (amministratori):** Avere accesso completo alla gestione. Possono configurare le impostazioni della mappa, creare/modificare/eliminare posizioni e percorsi, gestire immagini di posizioni e disegnare poligoni per i percorsi.

* * *

## Visualizzazione Utente standard (editore).

Se il Coordinatore ha abilitato l'impostazione "Mappa visibile a tutti gli editori", gli Utenti Standard possono accedere alla mappa tramite il menu di navigazione (sotto **Altro** -> **Mappa**).

  

### Visualizzazione della mappa

*   **Centratura automatica:** La mappa regola automaticamente i suoi confini per adattarsi a tutte le posizioni e i percorsi disponibili. Se non è presente nessuno, il valore predefinito è il punto centrale configurato dal Coordinatore.
*   **Marcatori e forme:**
    *   Le **Posizioni** vengono visualizzate come indicatori sulla mappa con colori e icone personalizzati.
    *   I **Percorsi** vengono visualizzati come poligoni o linee colorati sulla mappa.
    *   I **Bordi della congregazione** vengono visualizzati come contorni arancioni non interattivi (se abilitati dal Coordinatore).
*   **Stile della mappa:** La mappa può essere visualizzata in colori standard o in scala di grigi (monocromatica) in base alle impostazioni del calendario.

  

### Interazione con gli elementi della mappa

Facendo clic su un indicatore (Posizione) o su un poligono (Percorso) si apre una finestra di dialogo dei dettagli:

*   **Dettagli sulla posizione:**
    *   Visualizza il nome e la descrizione.
    *   Mostra **Suggerimenti importanti** (evidenziati in rosso per maggiore visibilità).
    *   Visualizza una galleria di immagini associate. Facendo clic su una miniatura si apre un **Lightbox** a schermo intero per lo zoom e la navigazione tra le immagini.
*   **Dettagli del percorso:**
    *   Visualizza il nome e la descrizione.
    *   Elenca tutte le posizioni associate a quel percorso specifico.

  

### Funzione "Localizzami".

Gli utenti possono fare clic sul pulsante "Mostra la mia posizione" (icona di destinazione nell'angolo in alto a destra della mappa) per richiedere al browser di trovare e visualizzare la loro posizione geografica corrente sulla mappa. Ciò è utile per trovare i luoghi di testimonianza più vicini.

* * *

## Visualizzazione Coordinatore (amministratore).

I coordinatori gestiscono la funzione Mappa dall'area di amministrazione in **Gestisci mappa** (\`/admin/map\`). Da qui possono configurare le impostazioni globali, gestire le posizioni e i percorsi.

  

### 1\. Impostazioni della mappa

Accessibile tramite l'icona delle impostazioni (ingranaggio) nella dashboard Gestisci mappa.

### Centro latitudine e longitudine

*   Center latitude
*   Center longitude
*   Pick center on map

**Cosa fa:** Imposta il punto centrale geografico predefinito della mappa. Ciò determina la visualizzazione iniziale quando la mappa viene caricata.

**Dove appare / Effetto:** Nella visualizzazione della mappa principale, quando un utente apre la sezione della mappa, la mappa verrà inizialmente spostata su queste coordinate esatte.

### Mappa visibile per tutti gli editori

**Cosa fa:** Determina se la funzionalità della mappa è riservata ad amministratori e coordinatori o se è accessibile anche agli utenti standard (editori).

**Dove appare / Effetto:** Controlla l'aspetto del collegamento del menu Mappa nella navigazione principale. Se abilitato, tutti gli editori vedranno la voce "Mappa" nel proprio menu e potranno visualizzare le località e i percorsi configurati.

### Usa tessere monocromatiche

**Cosa fa:** Modifica lo stile della mappa di base da a colori a scala di grigi (monocromatica).

**Dove appare / Effetto:** Si applica direttamente agli sfondi della mappa visualizzati da tutti gli utenti. Lo sfondo della mappa diventa bianco e nero, il che può aiutare i percorsi colorati personalizzati e gli indicatori di posizione a risaltare in modo più evidente.

### Mostra i confini della congregazione

**Cosa fa:** Abilita il disegno di linee di confine di congregazione predefinite sulla mappa.

**Dove appare / Effetto:** Una sovrapposizione di confini verrà sovrapposta alla visualizzazione della mappa principale per tutti gli utenti, delineando aree specifiche.

  

### 2\. Gestione delle posizioni

[Apri Impostazioni](https://calendar.pw-tools.net/admin/map)

Le posizioni rappresentano punti specifici sulla mappa (ad esempio, la posizione di un carrello, un punto di incontro).

#### Creazione/modifica di una posizione:

### Nome

**Cosa fa:** L'identificatore principale o il titolo della posizione.

**Dove appare / Effetto:** Viene visualizzato come titolo quando un utente fa clic sull'indicatore di posizione sulla mappa, nell'elenco delle posizioni nell'area di amministrazione e in qualsiasi menu a discesa di associazione.

### Colore / Icon

*   **Colore:**
    *   **Cosa fa:** Determina la tinta del colore dell'indicatore della mappa.
    *   **Dove appare / Effetto:** L'icona della puntina sulla visualizzazione della mappa effettiva verrà visualizzata nel colore selezionato.
*   **Icon:**
    *   **Cosa fa:** Consente la selezione di un simbolo o glifo specifico da posizionare all'interno dell'indicatore della mappa.
    *   **Dove appare / Effetto:** L'icona selezionata sarà visibile all'interno della puntina colorata nella visualizzazione mappa, aiutando gli utenti a identificare rapidamente il tipo di posizione a colpo d'occhio.

### Coordinate

Latitudine e longitudine. Viene fornito uno strumento "Seleziona coordinate" per selezionare il punto esatto su una mappa.

### Descrizione

**Cosa fa:** Un campo di testo ricco per fornire informazioni generali sulla posizione.

**Dove appare / Effetto:** Viene visualizzato nel popup o nel pannello dei dettagli quando un utente fa clic sull'indicatore di posizione sulla mappa.

### Important hints

**Cosa fa:** Un campo di testo RTF secondario specifico per avvisi, regole o avvisi critici relativi alla posizione.

**Dove appare / Effetto:** Appare in primo piano nel pannello dei dettagli della posizione quando si fa clic sulla mappa, spesso con uno stile tale da attirare l'attenzione dell'utente.

### Associated routes

**Cosa fa:** Collega la posizione a uno o più percorsi predefiniti.

**Dove appare / Effetto:** Attualmente funge da raggruppamento logico. Quando vengono interrogati percorsi o posizioni, questi vengono collegati insieme nel database, il che può influenzare il modo in cui vengono filtrati o visualizzati insieme sulla mappa.

### Validity period

**Cosa fa:** Definisce una data di inizio e di fine in cui questa posizione deve essere considerata attiva.

**Dove appare / Effetto:** Se la data corrente non rientra in questo intervallo, la posizione verrà automaticamente nascosta dalla visualizzazione della mappa pubblica, anche se è selezionata l'opzione "Attivo".

### attivo

**Cosa fa:** Un interruttore principale per abilitare o disabilitare completamente la posizione.

**Dove appare / Effetto:** Se deselezionato, l'indicatore di posizione scompare immediatamente dalla mappa per tutti gli utenti, indipendentemente dal periodo di validità.

#### Gestione delle immagini della posizione:

Dopo aver salvato una posizione, i coordinatori possono caricarvi immagini.

*   Le immagini vengono ridimensionate automaticamente nelle versioni piccola (larghezza 600 px) e grande (larghezza 1600 px) per un caricamento ottimizzato nella galleria frontend e nella lightbox.
*   I coordinatori possono fornire un **Titolo** e una **Descrizione** per ciascuna immagine.
*   Le immagini possono essere impostate come **Attive** o eliminate completamente.

  

### 3\. Gestione dei percorsi

[Apri Impostazioni](https://calendar.pw-tools.net/admin/map)

I percorsi rappresentano poligoni, linee o aree specifiche sulla mappa (ad esempio, una zona specifica di testimonianza pubblica, un percorso pedonale).

#### Creazione/modifica di un percorso:

### Nome

**Cosa fa:** L'identificatore primario per il percorso.

**Dove appare / Effetto:** Visibile nell'elenco dei percorsi dell'area di amministrazione, nei menu a discesa delle associazioni e come titolo se si fa clic sul percorso sulla mappa.

### Colore

**Cosa fa:** Imposta il colore delle linee del percorso e dell'area di riempimento.

**Dove appare / Effetto:** La forma disegnata sulla mappa verrà renderizzata in questo colore con opacità variabile.

### Descrizione

**Cosa fa:** Testo generale che dettaglia le informazioni sul percorso.

**Dove appare / Effetto:** Visibile cliccando sull'area del percorso sulla mappa.

### Cassetto percorso (poligoni)

Uno strumento cartografico interattivo che consente al Coordinatore di disegnare forme (poligoni) direttamente sulla mappa per definire i confini geografici del percorso.

### Associazioni

*   **Associated locations:**
    *   **Cosa fa:** Collega il percorso a una o più posizioni predefinite sulla mappa.
    *   **Dove appare / Effetto:** Consente di raggruppare logicamente le posizioni in questo percorso. Potrebbe influire sulle visualizzazioni filtrate o sul raggruppamento sulla mappa principale.
*   **Articoli prenotabili associati:**
    *   **Cosa fa:** Collega il percorso geografico agli elementi del calendario che gli utenti possono prenotare.
    *   **Dove appare / Effetto:** Ciò collega la funzionalità della mappa direttamente al calendario delle prenotazioni. Quando un utente interagisce con un elemento prenotabile specifico, è possibile fare riferimento o mostrare questo percorso.
*   **Campagne associate:**
    *   **Cosa fa:** Collega il percorso geografico a specifiche Campagne di prenotazione (raggruppamenti logici di turni).
    *   **Dove appare / Effetto:** Quando si gestiscono o si visualizzano le campagne all'interno del calendario, questo contesto geografico fornisce una rappresentazione visiva di dove si svolge la campagna sulla mappa.