# 管理包含位置和路线的地图

[開啟設定](https://calendar.pw-tools.net/admin/map/settings)

本文檔全面概述了應用程式中的地圖功能，從標準使用者（發布者）和協調員（管理員）的角度解釋了其功能。

## 概述

地圖功能允許會眾直觀地管理和顯示地理興趣點（位置）和區域/路徑（路線）。它可用於協調公眾見證地點、定義特定區域或為發布者突出顯示重要區域。

此地圖利用 OpenStreetMap 切片和 Leaflet 進行渲染。它還支援顯示用戶位置、顯示會眾邊界以及上傳特定位置的圖像。

## 使用者角色

*   **標準使用者（發布者）:** 如果協調員使地圖對他們可見，則可以查看地圖、位置、路線和相關詳細資訊（例如圖像和提示）。
*   **協調員（管理員）:** 擁有完全的管理權限。他們可以配置地圖設定、建立/編輯/刪除位置和路線、管理位置影像以及繪製路線的多邊形。

* * *

## 標準使用者（發布者）視圖

如果協調員啟用了「地圖對所有發布者可見」設置，則標準使用者可以透過導航選單（在 **其他** -> **地圖** 下）存取地圖。

  

### 查看地圖

*   **自動居中:** 地圖會自動調整其邊界以適合所有可用的位置和路線。如果不存在，則預設為協調器配置的中心點。
*   **標記和形狀:**
    *   **位置**顯示為具有自訂顏色和圖示的地圖標記。
    *   **路線**在地圖上顯示為彩色多邊形或線條。
    *   **會眾邊界**顯示為非互動式橙色輪廓（如果協調員啟用）。
*   **地圖樣式:** 根據日曆的設置，地圖可以以標準顏色或灰階（單色）顯示。

  

### 與地圖元素交互

點選標記（位置）或多邊形（路線）將開啟詳細資料對話方塊：

*   **地點詳情:**
    *   顯示名稱和描述。
    *   顯示**重要提示**（以紅色突出顯示以提高可見度）。
    *   顯示關聯影像的圖庫。點擊縮圖可開啟全螢幕**燈箱**，用於縮放和瀏覽圖像。
*   **路線詳情:**
    *   顯示名稱和描述。
    *   列出與該特定路線關聯的所有位置。

  

### “定位我”功能

使用者可以點擊「顯示我的位置」按鈕（地圖右上角的目標圖示）來提示瀏覽器在地圖上尋找並顯示他們目前的地理位置。這對於尋找最近的目擊地點很有用。

* * *

## 協調員（管理員）視圖

協調員從管理區域的**管理地圖** (\`/admin/map\`) 下管理地圖功能。從這裡，他們可以配置全域設定、管理位置和管理路線。

  

### 1\. 地圖設置

透過「管理地圖」儀表板上的設定（齒輪）圖示進行存取。

### 中心緯度和經度

*   中心緯度
*   中心經度
*   在地圖上選擇中心

**它的作用：** 設定地圖的預設地理中心點。這決定了載入地圖時的初始視圖。

**出現的地方/效果：** 在主地圖視圖上，當任何使用者打開地圖部分時，地圖最初將平移到這些精確座標。

### 地圖對所有發行商可見

**它的作用：** 切換地圖功能是否僅限於管理員和協調員，或是否也可供標準使用者（發布者）存取。

**出現的地方/效果：** 控制主導航中地圖選單連結的外觀。如果啟用，所有發布者都會在其選單中看到「地圖」項，並且可以查看配置的位置和路線。

### 使用單色圖塊

**它的作用：** 將底圖樣式從全彩改為灰階（單色）。

**出現的地方/效果：** 直接應用於所有使用者查看的地圖背景。地圖背景變成黑白，這可以幫助自訂彩色路線和位置標記更加突出。

### 顯示會眾邊界

**它的作用：** 允許在地圖上繪製預先定義的聚集邊界線。

**出現的地方/效果：** 邊界覆蓋層將疊加到所有使用者的主地圖視圖上，概述特定區域。

  

### 2\. 管理地點

[開啟設定](https://calendar.pw-tools.net/admin/map)

位置表示地圖上的特定點（例如，購物車位置、集合點）。

#### 建立/編輯位置：

### 名稱

**它的作用：** 位置的主要標識符或標題。

**出現的地方/效果：** 當使用者點擊地圖上、管理區域的位置清單以及任何關聯下拉清單中的位置標記時，顯示為標題。

### 顏色 / 圖標

*   **顏色:**
    *   **它的作用：** 確定地圖標記的色調。
    *   **出現的地方/效果：** 實際地圖視圖上的圖釘圖示將以所選顏色呈現。
*   **圖標:**
    *   **它的作用：** 允許選擇要放置在地圖標記內的特定符號或字形。
    *   **出現的地方/效果：** 所選圖示將在地圖視圖上的彩色圖釘內可見，幫助使用者一目了然地快速識別位置類型。

### 座標

緯度和經度。提供「座標選擇器」工具來選擇地圖上的精確點。

### 描述

**它的作用：** 用於提供有關位置的一般資訊的富文本欄位。

**出現的地方/效果：** 當使用者點擊地圖上的位置標記時，出現在彈出視窗或詳細資料面板中。

### 重要提示

**它的作用：** 專門用於與位置相關的關鍵警報、規則或警告的輔助富文本欄位。

**出現的地方/效果：** 單擊地圖時，會在位置詳細資訊面板中突出顯示，其樣式通常旨在吸引使用者的注意。

### 關聯路線

**它的作用：** 將位置連結到一條或多條預定義路線。

**出現的地方/效果：** 目前充當邏輯分組。當查詢路線或位置時，它們在資料庫中連結在一起，這可能會影響它們在地圖上的過濾或顯示方式。

### 有效期

**它的作用：** 定義此位置應被視為活動的開始日期和結束日期。

**出現的地方/效果：** 如果當前日期超出此範圍，即使選取「活動」開關，該位置也會自動從公共地圖視圖中隱藏。

### 積極地

**它的作用：** A master switch to enable or disable the location entirely.

**出現的地方/效果：** 如果未選中，位置標記會立即從所有使用者的地圖上消失，無論其有效期限為何。

#### 管理位置影像：

儲存位置後，協調員可以將圖像上傳到該位置。

*   影像會自動調整為小版本（600 像素寬度）和大版本（1600 像素寬度），以優化前端圖庫和燈箱中的載入。
*   協調員可以為每個圖像提供 **標題** 和 **描述**。
*   影像可以切換為**活動**或完全刪除。

  

### 3\. 管理路線

[開啟設定](https://calendar.pw-tools.net/admin/map)

路線代表地圖上的多邊形、線條或特定區域（例如，特定的公共見證區域、步行路徑）。

#### 建立/編輯路線：

### 姓名

**它的作用：** 路線的主要識別碼。

**出現的地方/效果：** 在管理區域的路線清單中、關聯下拉清單中可見，如果在地圖上按一下路線，則作為標題可見。

### 顏色

**它的作用：** 設定路線線條和填滿區域的顏色。

**出現的地方/效果：** 地圖上繪製的形狀將以這種顏色渲染，並具有不同的不透明度。

### 描述

**它的作用：** 詳細說明路線資訊的一般文字。

**出現的地方/效果：** 點選地圖上的路線區域時可見。

### 路線抽屜（多邊形）

互動式地圖工具，允許協調員直接在地圖上繪製形狀（多邊形）以定義路線的地理邊界。

### 協會

*   **關聯地點:**
    *   **它的作用：** 將路線連結到一個或多個預先定義的地圖位置。
    *   **出現的地方/效果：** 允許位置按邏輯分組到此路線。它可能會影響主地圖上的篩選視圖或分組。
*   **相關可預約項目:**
    *   **它的作用：** 將地理路線連結到使用者可以預訂的日曆項目。
    *   **出現的地方/效果：** 這將地圖功能直接與預訂日曆連結起來。當使用者與特定可預訂項目互動時，可以引用或顯示該路線。
*   **相關活動:**
    *   **它的作用：** 將地理路線連結到特定的預訂活動（班次的邏輯分組）。
    *   **出現的地方/效果：** 在日曆中管理或查看活動時，此地理環境會提供活動在地圖上發生位置的直覺表示。