Dokumentacja
Uwaga: Ta dokumentacja jest obecnie w przygotowaniu.

Zarządzaj mapą za pomocą lokalizacji i tras

Otwórz Ustawienia

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 w obszarze administracyjnym

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 w obszarze administracyjnym

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.