管理包含位置和路线的地图
本文檔全面概述了應用程式中的地圖功能，從標準使用者（發布者）和協調員（管理員）的角度解釋了其功能。
概述
地圖功能允許會眾直觀地管理和顯示地理興趣點（位置）和區域/路徑（路線）。它可用於協調公眾見證地點、定義特定區域或為發布者突出顯示重要區域。
此地圖利用 OpenStreetMap 切片和 Leaflet 進行渲染。它還支援顯示用戶位置、顯示會眾邊界以及上傳特定位置的圖像。
使用者角色
- 標準使用者（發布者）: 如果協調員使地圖對他們可見，則可以查看地圖、位置、路線和相關詳細資訊（例如圖像和提示）。
- 協調員（管理員）: 擁有完全的管理權限。他們可以配置地圖設定、建立/編輯/刪除位置和路線、管理位置影像以及繪製路線的多邊形。
標準使用者（發布者）視圖
如果協調員啟用了「地圖對所有發布者可見」設置，則標準使用者可以透過導航選單（在 其他 -> 地圖 下）存取地圖。
查看地圖
- 自動居中: 地圖會自動調整其邊界以適合所有可用的位置和路線。如果不存在，則預設為協調器配置的中心點。
- 標記和形狀:
- 位置顯示為具有自訂顏色和圖示的地圖標記。
- 路線在地圖上顯示為彩色多邊形或線條。
- 會眾邊界顯示為非互動式橙色輪廓（如果協調員啟用）。
- 地圖樣式: 根據日曆的設置，地圖可以以標準顏色或灰階（單色）顯示。
與地圖元素交互
點選標記（位置）或多邊形（路線）將開啟詳細資料對話方塊：
- 地點詳情:
- 顯示名稱和描述。
- 顯示重要提示（以紅色突出顯示以提高可見度）。
- 顯示關聯影像的圖庫。點擊縮圖可開啟全螢幕燈箱，用於縮放和瀏覽圖像。
- 路線詳情:
- 顯示名稱和描述。
- 列出與該特定路線關聯的所有位置。
“定位我”功能
使用者可以點擊「顯示我的位置」按鈕（地圖右上角的目標圖示）來提示瀏覽器在地圖上尋找並顯示他們目前的地理位置。這對於尋找最近的目擊地點很有用。
協調員（管理員）視圖
協調員從管理區域的管理地圖 (`/admin/map`) 下管理地圖功能。從這裡，他們可以配置全域設定、管理位置和管理路線。
1. 地圖設置
透過「管理地圖」儀表板上的設定（齒輪）圖示進行存取。
中心緯度和經度
- 中心緯度
- 中心經度
- 在地圖上選擇中心
它的作用： 設定地圖的預設地理中心點。這決定了載入地圖時的初始視圖。
出現的地方/效果： 在主地圖視圖上，當任何使用者打開地圖部分時，地圖最初將平移到這些精確座標。
地圖對所有發行商可見
它的作用： 切換地圖功能是否僅限於管理員和協調員，或是否也可供標準使用者（發布者）存取。
出現的地方/效果： 控制主導航中地圖選單連結的外觀。如果啟用，所有發布者都會在其選單中看到「地圖」項，並且可以查看配置的位置和路線。
使用單色圖塊
它的作用： 將底圖樣式從全彩改為灰階（單色）。
出現的地方/效果： 直接應用於所有使用者查看的地圖背景。地圖背景變成黑白，這可以幫助自訂彩色路線和位置標記更加突出。
顯示會眾邊界
它的作用： 允許在地圖上繪製預先定義的聚集邊界線。
出現的地方/效果： 邊界覆蓋層將疊加到所有使用者的主地圖視圖上，概述特定區域。
2. 管理地點
位置表示地圖上的特定點（例如，購物車位置、集合點）。
建立/編輯位置：
名稱
它的作用： 位置的主要標識符或標題。
出現的地方/效果： 當使用者點擊地圖上、管理區域的位置清單以及任何關聯下拉清單中的位置標記時，顯示為標題。
顏色 / 圖標
- 顏色:
- 它的作用： 確定地圖標記的色調。
- 出現的地方/效果： 實際地圖視圖上的圖釘圖示將以所選顏色呈現。
- 圖標:
- 它的作用： 允許選擇要放置在地圖標記內的特定符號或字形。
- 出現的地方/效果： 所選圖示將在地圖視圖上的彩色圖釘內可見，幫助使用者一目了然地快速識別位置類型。
座標
緯度和經度。提供「座標選擇器」工具來選擇地圖上的精確點。
描述
它的作用： 用於提供有關位置的一般資訊的富文本欄位。
出現的地方/效果： 當使用者點擊地圖上的位置標記時，出現在彈出視窗或詳細資料面板中。
重要提示
它的作用： 專門用於與位置相關的關鍵警報、規則或警告的輔助富文本欄位。
出現的地方/效果： 單擊地圖時，會在位置詳細資訊面板中突出顯示，其樣式通常旨在吸引使用者的注意。
關聯路線
它的作用： 將位置連結到一條或多條預定義路線。
出現的地方/效果： 目前充當邏輯分組。當查詢路線或位置時，它們在資料庫中連結在一起，這可能會影響它們在地圖上的過濾或顯示方式。
有效期
它的作用： 定義此位置應被視為活動的開始日期和結束日期。
出現的地方/效果： 如果當前日期超出此範圍，即使選取「活動」開關，該位置也會自動從公共地圖視圖中隱藏。
積極地
它的作用： A master switch to enable or disable the location entirely.
出現的地方/效果： 如果未選中，位置標記會立即從所有使用者的地圖上消失，無論其有效期限為何。
管理位置影像：
儲存位置後，協調員可以將圖像上傳到該位置。
- 影像會自動調整為小版本（600 像素寬度）和大版本（1600 像素寬度），以優化前端圖庫和燈箱中的載入。
- 協調員可以為每個圖像提供 標題 和 描述。
- 影像可以切換為活動或完全刪除。
3. 管理路線
路線代表地圖上的多邊形、線條或特定區域（例如，特定的公共見證區域、步行路徑）。
建立/編輯路線：
姓名
它的作用： 路線的主要識別碼。
出現的地方/效果： 在管理區域的路線清單中、關聯下拉清單中可見，如果在地圖上按一下路線，則作為標題可見。
顏色
它的作用： 設定路線線條和填滿區域的顏色。
出現的地方/效果： 地圖上繪製的形狀將以這種顏色渲染，並具有不同的不透明度。
描述
它的作用： 詳細說明路線資訊的一般文字。
出現的地方/效果： 點選地圖上的路線區域時可見。
路線抽屜（多邊形）
互動式地圖工具，允許協調員直接在地圖上繪製形狀（多邊形）以定義路線的地理邊界。
協會
- 關聯地點:
- 它的作用： 將路線連結到一個或多個預先定義的地圖位置。
- 出現的地方/效果： 允許位置按邏輯分組到此路線。它可能會影響主地圖上的篩選視圖或分組。
- 相關可預約項目:
- 它的作用： 將地理路線連結到使用者可以預訂的日曆項目。
- 出現的地方/效果： 這將地圖功能直接與預訂日曆連結起來。當使用者與特定可預訂項目互動時，可以引用或顯示該路線。
- 相關活動:
- 它的作用： 將地理路線連結到特定的預訂活動（班次的邏輯分組）。
- 出現的地方/效果： 在日曆中管理或查看活動時，此地理環境會提供活動在地圖上發生位置的直覺表示。