# OnePass v8 獨立公式與離島實際資料驗證報告

## v8 地圖互動介面與數值驗收

- 2026-11-18 重新執行 `node --test tests/onepass.test.mjs tests/map-display.test.mjs`：14/14 PASS（11 項原有運算測試＋3 項新地圖運算測試）；沿用 v6 獨立 PROJ 參考數值與模型限制。
- 使用 Playwright／Chromium 執行桌面（1440×960）與手機（390×844）介面測試：主結果卡即時更新、單欄輸入、S 區圖號、快速範例、結果分組、手機版無水平溢出，均通過。
- `tests/website_desktop.png`、`tests/website_mobile.png` 為實際瀏覽器測試畫面。本環境無法外連，地圖會明示圖磚載入狀態、並依 WGS84 坐標放置標記；**未獨立驗證國土測繪中心 WMTS 實際回傳圖資**。
- 尚**未**實際登入使用者的 Cloudflare 帳戶；地圖圖磚連線及部署後服務可用性須依部署指南現場驗收。

## 一、執行與結論

- 測試日期：2026-11-18（以目前實際資料和計算環境執行）。
- JavaScript：Node.js 22.16.0；PROJ 參考數值以 `pyproj 3.7.2／PROJ 9.5.1` 產生。
- `node --test tests/onepass.test.mjs tests/map-display.test.mjs`：**14 組 PASS／0 FAIL**。
- TM2：**4 組投影系統共 2,048 點**，公式正算與獨立 PROJ 參考差距最大約 `2.48 × 10⁻⁹m`，反算閉合約 `2.44 × 10⁻⁹m`。兩者屬**數值運算一致性**，不是 GPS 外業量測精度。
- WGS84 ECEF：2,000 個三維數值點，最大閉合差約 `2.90 × 10⁻⁹m`；七參數數學正反算 2,000 次、EPSG 本島仿射逆算 2,000 次通過。
- 另驗證本島全部台電分區格網 9／11 碼、澎湖 X/Y、金門 Z、馬祖 S、負面錯誤案例、TWG 與臺灣來源 Mapcode 格網量化。
- 尚**未**有官方現行金門／馬祖原生基準認證資料或 TWD97 多年代差值網格，因此這部分只標示候選歷史模型、經驗修正或「未改正代用」，不宣稱公分級。

## 二、X／Y／S／Z 實際電桿獨立保留集

程序：從台電公開 `all.csv` 擷取地區資料，依圖號的 SHA-256 分派訓練／保留；採用候選歷史模型產生的格網中心，與台電 TWD97 電桿實際位置比較。**不同圖號保留樣本不參與係數估計**；但仍可能具有鄰近地區空間相關性，這不是獨立測量控制點認證。

| 區域 | 訓練 | 保留 | 原始中位數 m | 校正中位數 m | 校正 P95 m | 校正 RMSE m | 校正最大值 m |
|---|---:|---:|---:|---:|---:|---:|---:|
| S | 856 | 208 | 46.449 | 0.164 | 5.833 | 3.242 | 31.164 |
| X | 1,539 | 360 | 14.306 | 5.662 | 27.799 | 16.279 | 136.073 |
| Y | 6,242 | 1,618 | 14.841 | 5.418 | 35.571 | 182.822 | 4995.246 |
| Z | 9,587 | 2,413 | 4.091 | 4.088 | 7.640 | 152.896 | 7199.441 |

**請特別注意：** S 區中位數雖下降至約 0.16m，其 P95 仍有約 5.83m；Y 與 Z 區仍存在數公里等級極端異常紀錄。模型**不能**稱為「公分級精度認證」，也不能視為官方測量基準改正。

## 三、網頁預設經驗校正的另一份固定抽樣資料（各區 240 筆）

| 分區 | 筆數 | 中位數 m | P95 m | RMSE m | 最大值 m |
|---|---:|---:|---:|---:|---:|
| K | 240 | 7.837 | 34.212 | 38.234 | 412.085 |
| L | 240 | 9.129 | 51.876 | 39.856 | 386.657 |
| M | 240 | 6.543 | 20.689 | 36.389 | 507.132 |
| N | 240 | 7.251 | 38.924 | 38.837 | 466.686 |
| P | 240 | 6.508 | 17.230 | 9.888 | 40.112 |
| Q | 240 | 7.996 | 36.386 | 325.688 | 5000.449 |
| X | 240 | 5.512 | 26.568 | 16.475 | 158.485 |
| Y | 240 | 5.829 | 49.351 | 325.202 | 4999.105 |
| S | 240 | 0.162 | 6.454 | 2.770 | 19.486 |
| Z | 240 | 4.151 | 7.831 | 4.712 | 13.460 |

這 240 筆是額外的固定亂數抽樣代理檢核（可能與訓練資料範圍重疊），**不能替代上節真正未參與係數估計的保留測試**。K、L、M、N、P、Q 使用公告通用本島模型，仍可能因點位、分區或資料品質出現偏差。

## 四、已修正與仍需揭露的來源風險

1. `perfect_map_v4.py` 中 `ZONE_MAP` 有一段語法錯誤，原檔不能直接通過 Python 編譯。新版**保留原檔**，只擷取可讀的原始 Mapcode 區表。
2. 舊 `area_table` 搭配 `chr(index+65)` 會忽略 I／S 缺號造成錯置；現版使用明確分區對照表。
3. 舊 `_pwr_parse_raw` 的 9 碼處理未使用最後 10 公尺兩碼；已修正。
4. 舊 `tm2_fwd` 僅保留東向一次項和北向二次項；新獨立核心採完整六階 Krüger 並與 PROJ 數值比對。
5. 來源 S/Z 原生歷史基準的 ECEF 平移、117° 特殊投影是否符合台電現行正式規格，仍需官方對照；**沒有假造官方驗證 PASS**。
6. 臺電官方圖臺目前未以經認證的自動 API 取得可重現的官方數值回傳；網站提供手動連結與座標距離比對，不宣稱已自動驗證該圖臺。
7. Cloudflare 帳戶尚未授權本執行環境，**未執行真實遠端 Pages 部署**。提供可直接上傳、全靜態成品及部署腳本。地圖以國土測繪中心 WMTS 圖磚直連，不使用第三方地圖 SDK。

## 五、驗收狀態矩陣

| 項目 | 狀態 |
|---|---|
| TM2 四 EPSG、正反算、六階公式、ECEF | **NUMERICAL_VERIFIED** |
| 台電本島 9／11 碼正反算 | **FORMULA_VERIFIED／FIELD_PROXY_AVAILABLE** |
| 澎湖 X/Y 圖號及候選歷史模型 | **FIELD_EMPIRICAL_HOLDOUT（仍有極端殘差）** |
| 金門 Z／馬祖 S 特殊 117° 路徑 | **SOURCE_MODEL_AVAILABLE／FIELD_EMPIRICAL_HOLDOUT** |
| WGS84 與一般 TWD97 靜態操作 | **DEFAULT_APPROXIMATE** |
| TWD97[2010]／[2020] 官方高精度年代轉換 | **EPOCH_DEFAULT_NO_GRID（未改正代用）** |
| TWD67 ↔ TWD97 公分級外業認證 | **NOT_CERTIFIED（本島約 7m 公告）** |
| 日本 DENSO 官方 MAPCODE 編碼 | **NOT_INCLUDED（來源 v4 為臺灣自訂碼）** |
| 東沙／南沙正式台電圖號 | **N/A／非核心範圍** |
| Cloudflare Pages 正式上線 | **READY_TO_DEPLOY／尚未登入帳戶** |
| 外部圖磚依賴 | **僅使用國土測繪中心官方 WMTS，無其他地圖供應商** |

## 六、測試可覆核檔案

- `tests/NODE_TEST_RESULT.txt`：實際 Node 測試原始輸出（14 組測試）。
- `tests/map-display.test.mjs`：Web Mercator 正反算與圖磚服務名稱測試。
- `tests/UI_TEST_RESULT.txt`：實際 Chromium DOM 地圖互動測試結果。
- `tests/tm_pyproj_reference.json`：2,048 筆 PROJ 參考投影數值。
- `tests/OFFSHORE_HOLDOUT.json`：全部保留樣本統計含極端值。
- `tests/FIELD_AUDIT.json`：10 個圖號分區固定樣本比較。
- `tests/field_samples.json`：固定種子抽樣圖號與 TWD97 原資料（部分）。
- `tools/predict-offshore.mjs` 與 `tools/fit-offshore.py`：模型估計及殘差推算邏輯。


## v8 新增之標記與地圖互動驗證

- 地圖 Web Mercator 已實測 **28,200 個測點**（28,200 點來自六個 zoom 階數各 4,700 點），最大緯度閉合差約 `4.27e-14°`、經度 `8.53e-14°`。

- 實際 Chromium DOM 測試：座標輸入後立即顯示標記，經緯度與轉換結果一致。
- 點選地圖位置，輸入自動改為 WGS84、標記移至所點位置，地圖浮動資訊、標記標題及右側結果均明示「地圖選點」。
- Web Mercator 點選反算已於測試中發現並修正經度正規化問題，另用大量數值測點檢查。
- 地圖縮放、靶心定位、外島 S 區轉換、CSV 匯入、桌面／手機排版、移除固定位置的示意標記，均納入操作測試。
- 測試環境無法驗證實際 NLSC 圖磚連線及 Cloudflare 遠端部署；此二項須以部署後測試判斷，不列為已完成的實測。
