# ATAK TDAL Custom Coordinate

## ATAK 自訂座標系統定義與啟用 / Custom Coordinate System Definition and Activation

### 1\. 安裝 TDAL 附加元件 / Install the TDAL Plugin

首先，您需要從 Google Play 商店安裝 **TDAL 附加元件 (Plugin)**，這是啟用自訂座標系統的必要工具。

**附加元件名稱：** ATAK Plugin: TDAL
**附加元件 Java 專案名稱：** `com.atakmap.android.bng.plugin`

點擊下方連結進行安裝：

[**TDAL 附加元件 (Google Play 商店)**](https://play.google.com/store/apps/details?id=com.atakmap.android.bng.plugin)

### 2\. 下載並放置設定檔 / Download and Place the Configuration File

接下來，您需要下載包含自訂座標定義的 **XML 檔案**，並將其放置到 **ATAK** 的特定資料夾路徑中。

#### 2.1. 下載 XML 檔案

點擊下方連結下載自訂座標系統設定檔：

[**座標系統設定檔 (coordinate\_systems.xml)**](https://drive.google.com/file/d/1ZNEi38ycSdi2TmcjBl1SD5cPTBNRmDc6/view?usp=sharing)

#### 2.2. 放置檔案路徑

請將下載的 `coordinate_systems.xml` 檔案，放置到您的 **ATAK** 資料夾中的以下路徑：

atak/tools/coordinate_systems/coordinate_systems.xml

#### 2.3. 檔案名稱與路徑檢查 (CRITICAL CHECK)

**請務必確認**下載後的檔案名稱完全符合以下要求，避免因大小寫、副檔名錯誤或重複編號導致設定失敗。

| 項目 (Item) | 內容 (Content) | 備註 (Note) |
| :--- | :--- | :--- |
| **正確檔名 (Exact Filename)** | **`coordinate_systems.xml`** | 必須完全吻合，包括大小寫。 |
| **檔案名稱檢查** | **不可**出現如 `coordinate_systems (1).xml` 或 `Coordinate_Systems.xml` 等變異名稱。 | 請刪除括號中的數字或調整大小寫。 |
| **目標路徑 (Target Path)** | **`atak/tools/coordinate_systems/coordinate_systems.xml`** | 確保檔案被放置在正確的路徑中。 |

### 3\. 座標系統定義 (XML 內容) / Coordinate System Definition (XML Content)

#### 座標系統概覽 (Overview)

| 系統 (System) | 名稱 (Name) | EPSG 代碼 (Code) | 適用範圍 (Bounds) | 參考連結 (Link) |
| :--- | :--- | :--- | :--- | :--- |
| **TWD97** | TWD97 / TM2 zone 121 | **3826** | 台灣及周邊海域 (約 $114^\circ \text{E}$ 至 $124^\circ \text{E}$) | [https://epsg.io/3826](https://epsg.io/3826) |
| **TWD67** | TWD67 / TM2 zone 119 (澎湖) | **3827** | 澎湖地區 | [https://epsg.io/3827](https://epsg.io/3827) |
| **TWD67** | TWD67 / TM2 zone 121 (台灣本島) | **3828** | 台灣本島及周邊 | [https://epsg.io/3828](https://epsg.io/3828) |

#### XML 程式碼區塊

<coordinateReferenceSystems>
  <crs>
    <name>TWD97</name>
    <title>TWD97 / TM2 zone 121</title>
    <epsg>3826</epsg>
    <bounds>
      <minLongitude>114.32</minLongitude>
      <minLatitude>17.36</minLatitude>
      <maxLongitude>123.61</maxLongitude>
      <maxLatitude>26.96</maxLatitude>
    </bounds>
  </crs>

  <group>
    <name>TWD67</name>
    <title>TWD67 / TM2</title>
    <groupReferenceSystems>
      <crs>
        <name>TWD67 119</name>
        <title>TWD67 / TM2 zone 119</title>
        <epsg>3827</epsg>
        <bounds>
          <minLongitude>119.25</minLongitude>
          <minLatitude>23.13</minLatitude>
          <maxLongitude>119.78</maxLongitude>
          <maxLatitude>23.82</maxLatitude>
        </bounds>
      </crs>
      <crs>
        <name>TWD67 121</name>
        <title>TWD67 / TM2 zone 121</title>
        <epsg>3828</epsg>
        <bounds>
          <minLongitude>119.99</minLongitude>
          <minLatitude>21.87</minLatitude>
          <maxLongitude>122.06</maxLongitude>
          <maxLatitude>25.34</maxLatitude>
        </bounds>
      </crs>
    </groupReferenceSystems>
  </group>
</coordinateReferenceSystems>

-----

### 4\. 啟用 TDAL 座標工具 / Activate the TDAL Coordinate Tool

檔案放置完成後，您需要進入 ATAK 內部的設定選單來**啟用**並**選擇**這些新的座標系統。

::: tip 重要提醒 (Important Note)
在開始以下步驟前，請務必確認 TDAL 附加元件 (Plugin) 已成功安裝，並且在 ATAK 中已載入。如果未載入，您將無法在步驟 3 找到 TDAL 偏好設定的選項。
:::

#### 步驟 4.1: 進入工具偏好設定 (Tool Preferences)

| 動作 (Action) | 說明 (Description) | 截圖 (Screenshot) |
| :--- | :--- | :--- |
| **1.1** | 前往**設定 (Settings)** $\rightarrow$ **工具偏好設定 (Tool Preferences)**。 |  |

#### 步驟 4.2: 進入特定工具設定 (Specific Tool Preferences)

| 動作 (Action) | 說明 (Description) | 截圖 (Screenshot) |
| :--- | :--- | :--- |
| **2.1** | 進入**特定工具偏好設定 (Specific Tool Preferences)**。 |  |

#### 步驟 4.3: 進入 TDAL 偏好設定 (TDAL Preferences)

| 動作 (Action) | 說明 (Description) | 截圖 (Screenshot) |
| :--- | :--- | :--- |
| **3.1** | 向下捲動選單。 |  |
| **3.2** | 點選 **TDAL 偏好設定 (TDAL Preferences)**。 |  |

#### 步驟 4.4: 啟用並選擇 TWD97

| 動作 (Action) | 說明 (Description) | 截圖 (Screenshot) |
| :--- | :--- | :--- |
| **4.1** | 勾選 **「啟用 TDAL 模式 (Enable TDAL Mode)」**。 |  |
| **4.2** | 在 **座標系統 (Coordinate System)** 下拉選單中，選擇 **TWD97 / TM2 zone 121** (或您需要的 TWD67 系統)。 |  |

#### 步驟 5: 返回主畫面確認 (Verification)

| 動作 (Action) | 說明 (Description) | 截圖 (Screenshot) |
| :--- | :--- | :--- |
| **5.1** | 返回主地圖畫面，觀察**地圖中心十字線 (Center Crosshair)** 下方，**座標顯示格式**應已變更為 TDAL 模式下的 **TWD97 / TM2 zone 121**。 |  |

---

## 補充說明

殘念，目前無法直接透過匯入的方式設定，需要手動搬移檔案安裝套件後，才可以匯入設定檔...

<?xml version='1.0' encoding='ASCII' standalone='yes'?>
<preferences>
  <preference version="1" name="com.atakmap.app_preferences">
    <entry key="com.atakmap.android.bng.enableBngPref" class="class java.lang.Boolean">true</entry>
    <entry key="com.atakmap.android.bng.chooseCoordinateSystem" class="class java.lang.String">TWD97</entry>
  </preference>
</preferences>

算了來動手做作看吧!!