# Zarządzaj mapą za pomocą lokalizacji i tras

[Otwórz Ustawienia](https://calendar.pw-tools.net/admin/map/settings)

Ten dokument zawiera kompleksowy przegląd funkcji Mapa w aplikacji, wyjaśniając jej funkcjonalność zarówno z perspektywy Użytkowników standardowych (Wydawcy), jak i Koordynatorów (Administratorzy).

## Przegląd

Funkcja mapy umożliwia zborom wizualne zarządzanie i wyświetlanie interesujących miejsc geograficznych (Lokalizacje) oraz obszarów/ścieżek (Trasy). Można go używać do koordynowania miejsc świadczenia publicznego, określania konkretnych terytoriów lub wyróżniania obszarów ważnych dla głosicieli.

Mapa wykorzystuje do renderowania kafelki OpenStreetMap i ulotkę. Obsługuje także pokazywanie lokalizacji użytkowników, wyświetlanie granic zborów i przesyłanie zdjęć dla określonych lokalizacji.

## Role użytkowników

*   **Użytkownicy standardowi (wydawcy):** Może wyświetlać mapę, lokalizacje, trasy i powiązane szczegóły (takie jak obrazy i wskazówki), jeśli mapa została im udostępniona przez koordynatora.
*   **Koordynatorzy (Administratorzy):** Miej pełny dostęp do zarządzania. Mogą konfigurować ustawienia mapy, tworzyć/edytować/usuwać lokalizacje i trasy, zarządzać obrazami lokalizacji i rysować wielokąty dla tras.

* * *

## Widok standardowy użytkownika (wydawcy).

Jeżeli Koordynator włączył opcję „Mapa widoczna dla wszystkich wydawców”, Użytkownicy Standardowi mogą uzyskać dostęp do mapy poprzez menu nawigacyjne (pod **Inne** -> **Mapa**).

  

### Przeglądanie mapy

*   **Automatyczne centrowanie:** Mapa automatycznie dostosowuje swoje granice, aby dopasować je do wszystkich dostępnych lokalizacji i tras. Jeżeli nie ma żadnego, domyślnie ustawiony jest punkt środkowy skonfigurowany przez Koordynatora.
*   **Markery i kształty:**
    *   **Lokalizacje** są wyświetlane jako znaczniki mapy z niestandardowymi kolorami i ikonami.
    *   **Trasy** są wyświetlane na mapie jako kolorowe wielokąty lub linie.
    *   **Granice zgromadzeń** są wyświetlane jako nieinteraktywne pomarańczowe kontury (jeśli zostały włączone przez Koordynatora).
*   **Styl mapy:** Mapa może być wyświetlana w standardowych kolorach lub w skali szarości (monochromatycznie) w zależności od ustawień kalendarza.

  

### Interakcja z elementami mapy

Kliknięcie znacznika (Lokalizacja) lub wielokąta (Trasa) otwiera okno dialogowe ze szczegółami:

*   **Szczegóły lokalizacji:**
    *   Wyświetla nazwę i opis.
    *   Pokazuje **Ważne wskazówki** (podświetlone na czerwono dla lepszej widoczności).
    *   Wyświetla galerię powiązanych obrazów. Kliknięcie miniatury otwiera pełnoekranowy **Lightbox** umożliwiający powiększanie i poruszanie się po obrazach.
*   **Szczegóły trasy:**
    *   Wyświetla nazwę i opis.
    *   Wyświetla listę wszystkich lokalizacji powiązanych z tą konkretną trasą.

  

### Funkcja „Zlokalizuj mnie”.

Użytkownicy mogą kliknąć przycisk „Pokaż moją lokalizację” (ikona celu w prawym górnym rogu mapy), aby poprosić przeglądarkę o znalezienie i wyświetlenie ich aktualnej pozycji geograficznej na mapie. Przydaje się to do znajdowania najbliższych miejsc świadczenia.

* * *

## Widok koordynatora (administratora).

Koordynatorzy zarządzają funkcją Mapa z obszaru administracyjnego w obszarze **Zarządzaj mapą** (\`/admin/map\`). Stąd mogą konfigurować ustawienia globalne, zarządzać lokalizacjami i trasami.

  

### 1\. Ustawienia mapy

Dostęp do niego można uzyskać za pomocą ikony ustawień (koła zębatego) na panelu Zarządzaj mapą.

### Środkowa szerokość i długość geograficzna

*   Szerokość geograficzna środka
*   Długość geograficzna środka
*   Wybierz środek na mapie

**Co robi:** Ustawia domyślny geograficzny punkt środkowy mapy. Określa to początkowy widok po załadowaniu mapy.

**Gdzie się pojawia / Efekt:** Gdy w głównym widoku mapy dowolny użytkownik otworzy sekcję mapy, mapa zostanie początkowo przesunięta w stronę tych dokładnych współrzędnych.

### Mapa widoczna dla wszystkich wydawców

**Co robi:** Przełącza, czy funkcja mapy jest dostępna tylko dla administratorów i koordynatorów, czy też jest dostępna również dla standardowych użytkowników (wydawców).

**Gdzie się pojawia / Efekt:** Steruje wyglądem łącza menu Mapa w głównej nawigacji. Jeśli ta opcja jest włączona, wszyscy wydawcy widzą w swoim menu pozycję „Mapa” i mogą przeglądać skonfigurowane lokalizacje i trasy.

### Używaj monochromatycznych kafelków

**Co robi:** Zmienia styl mapy podstawowej z pełnego koloru na skalę szarości (monochromatyczny).

**Gdzie się pojawia / Efekt:** Dotyczy bezpośrednio tła map oglądanych przez wszystkich użytkowników. Tło mapy stanie się czarno-białe, dzięki czemu niestandardowe kolorowe trasy i znaczniki lokalizacji będą bardziej widoczne.

### Pokaż granice zboru

**Co robi:** Umożliwia rysowanie na mapie predefiniowanych linii granic zboru.

**Gdzie się pojawia / Efekt:** Na główny widok mapy dla wszystkich użytkowników zostanie nałożona nakładka z granicami, wyznaczająca określone obszary.

  

### 2\. Zarządzanie lokalizacjami

[Otwórz Ustawienia](https://calendar.pw-tools.net/admin/map)

Lokalizacje reprezentują określone punkty na mapie (np. lokalizację wózka, miejsce spotkania).

#### Tworzenie/edytowanie lokalizacji:

### Nazwa

**Co robi:** Podstawowy identyfikator lub tytuł lokalizacji.

**Gdzie się pojawia / Efekt:** Pojawia się jako tytuł, gdy użytkownik kliknie znacznik lokalizacji na mapie, na liście lokalizacji w obszarze administracyjnym oraz w rozwijanych listach powiązań.

### Kolor / Ikona

*   **Kolor:**
    *   **Co robi:** Określa odcień koloru znacznika mapy.
    *   **Gdzie się pojawia / Efekt:** Ikona pinezki w rzeczywistym widoku mapy będzie renderowana w wybranym kolorze.
*   **Ikona:**
    *   **Co robi:** Umożliwia wybranie określonego symbolu lub glifu, który ma zostać umieszczony wewnątrz znacznika mapy.
    *   **Gdzie się pojawia / Efekt:** Wybrana ikona będzie widoczna wewnątrz kolorowej pinezki w widoku mapy, co pomoże użytkownikom szybko i szybko zidentyfikować typ lokalizacji.

### Współrzędne

Szerokość i długość geograficzna. Dostępne jest narzędzie „Wybór współrzędnych”, umożliwiające wybranie dokładnego punktu na mapie.

### Opis

**Co robi:** Bogate pole tekstowe umożliwiające podanie ogólnych informacji o lokalizacji.

**Gdzie się pojawia / Efekt:** Pojawia się w wyskakującym okienku lub panelu szczegółów, gdy użytkownik kliknie znacznik lokalizacji na mapie.

### Ważne wskazówki

**Co robi:** Dodatkowe pole tekstu sformatowanego przeznaczone specjalnie dla krytycznych alertów, reguł lub ostrzeżeń związanych z lokalizacją.

**Gdzie się pojawia / Efekt:** Po kliknięciu na mapie pojawia się w widocznym miejscu w panelu szczegółów lokalizacji, często stylizowany tak, aby przyciągnąć uwagę użytkownika.

### Powiązane trasy

**Co robi:** Łączy lokalizację z jedną lub większą liczbą predefiniowanych tras.

**Gdzie się pojawia / Efekt:** Obecnie pełni funkcję grupy logicznej. Kiedy sprawdzane są trasy lub lokalizacje, są one łączone w bazie danych, co może mieć wpływ na sposób ich filtrowania lub wspólnego wyświetlania na mapie.

### Okres ważności

**Co robi:** Określa datę początkową i końcową, kiedy ta lokalizacja powinna być uważana za aktywną.

**Gdzie się pojawia / Efekt:** Jeśli bieżąca data wypada poza ten zakres, lokalizacja zostanie automatycznie ukryta w widoku mapy publicznej, nawet jeśli zaznaczona jest opcja „Aktywny”.

### Aktywne

**Co robi:** Przełącznik główny umożliwiający całkowite włączenie lub wyłączenie lokalizacji.

**Gdzie się pojawia / Efekt:** Jeśli odznaczone, znacznik lokalizacji znika natychmiast z mapy dla wszystkich użytkowników, niezależnie od okresu jego ważności.

#### Zarządzanie obrazami lokalizacji:

Po zapisaniu lokalizacji Koordynatorzy mogą przesyłać do niej zdjęcia.

*   Rozmiar obrazów jest automatycznie zmieniany na małą (szerokość 600 pikseli) i dużą (szerokość 1600 pikseli) w celu zoptymalizowania ładowania w galerii frontendowej i lightboksie.
*   Koordynatorzy mogą podać **tytuł** i **opis** każdego obrazu.
*   Obrazy można przełączać jako **Aktywne** lub całkowicie usuwać.

  

### 3\. Zarządzanie trasami

[Otwórz Ustawienia](https://calendar.pw-tools.net/admin/map)

Trasy reprezentują wielokąty, linie lub określone obszary na mapie (np. określoną strefę świadczenia publicznego, ścieżkę spacerową).

#### Tworzenie/edycja trasy:

### Nazwa

**Co robi:** Podstawowy identyfikator trasy.

**Gdzie się pojawia / Efekt:** Widoczne w obszarze administracyjnym na liście tras, w listach rozwijanych skojarzeń oraz jako tytuł, jeśli trasa zostanie kliknięta na mapie.

### Kolor

**Co robi:** Ustawia kolor linii trasy i obszar wypełnienia.

**Gdzie się pojawia / Efekt:** Kształt narysowany na mapie będzie renderowany w tym kolorze z różnym stopniem krycia.

### Opis

**Co robi:** Tekst ogólny zawierający szczegółowe informacje o trasie.

**Gdzie się pojawia / Efekt:** Widoczne po kliknięciu obszaru trasy na mapie.

### Szuflada tras (wielokąty)

Interaktywne narzędzie mapowe, które umożliwia Koordynatorowi rysowanie kształtów (wielokątów) bezpośrednio na mapie w celu określenia granic geograficznych trasy.

### Wspomnienia

*   **Powiązane lokalizacje:**
    *   **Co robi:** Łączy trasę z jedną lub większą liczbą predefiniowanych lokalizacji na mapie.
    *   **Gdzie się pojawia / Efekt:** Umożliwia logiczne pogrupowanie lokalizacji w tę trasę. Może to mieć wpływ na widoki filtrów lub grupowanie na mapie głównej.
*   **Powiązane pozycje podlegające rezerwacji:**
    *   **Co robi:** Łączy trasę geograficzną z pozycjami kalendarza, które użytkownicy mogą rezerwować.
    *   **Gdzie się pojawia / Efekt:** Wiąże to funkcję mapy bezpośrednio z kalendarzem rezerwacji. Gdy użytkownik wchodzi w interakcję z konkretnym przedmiotem, który można zarezerwować, można odwoływać się do tej trasy lub ją wyświetlać.
*   **Powiązane kampanie:**
    *   **Co robi:** Łączy trasę geograficzną z konkretnymi kampaniami rezerwacji (logiczne grupowanie zmian).
    *   **Gdzie się pojawia / Efekt:** Podczas zarządzania kampaniami lub przeglądania ich w kalendarzu ten kontekst geograficzny zapewnia wizualną reprezentację miejsca, w którym odbywa się kampania na mapie.