# 臺灣座標 OnePass v8 — 全套公式、參數、可追溯轉換方法

本文件對應 `site/js/` **已實際執行的 JavaScript 計算核心**，不是未實作的設計稿。使用者原稿 `perfect_map_v4.py` 的特殊外島規則及臺灣自訂 Mapcode 已分別移植；獨立 TM2 六階核心不取用來源舊程式的簡化公式。

**數學運算驗證、電桿點位比較及測量精度認證是三件不同的事。** TWD97[2010]/[2020] 未取得官方差值網格時，顯示通用 TWD97「未進行年代改正」，不是宣稱不同年代座標一致。

## 0. 使用流程、轉換版本與資料契約

- 網頁單一輸入欄位：`緯度, 經度`；`東向E, 北向N`；台電 9/11 碼；來源 v4 Mapcode；獨立 TWG；WGS84 ECEF 則為 `X, Y, Z` 三數值。
- `AUTO` 只可靠辨識經緯度、台電圖號及兩種格網；二維公尺座標必須手動指定 EPSG／中央經線，不能依數值猜測大地基準。
- **獨立計算版本**：GRS80/GRS67 六階 Krüger TM2、ECEF、EPSG 公告本島仿射，獨立 TWG；不使用 `perfect_map_v4.py` 的 TM2 二階近似公式。
- **來源相容版本**：完整 120 區臺灣 Mapcode、3×3 核心矩陣、來源歷史外島參數。可與獨立 TWG 同時顯示；兩種格網並不相同。
- **離島經驗修正**：可選。基底是來源歷史參數，再依公開電桿資料估計平面殘差；與獨立數學核心完全分離。預設啟用，可切換回來源未修正模型。
- `status=MATHEMATICAL`：同一基準計算閉合；`APPROXIMATE`：跨基準近似；`EMPIRICAL_HOLDOUT`：電桿資料經驗修正；`EPOCH_DEFAULT`：年代未改正；`UNAVAILABLE`：缺乏可負責任結果。

## 1. 三個橢球體的確定參數

| 橢球體 | 用途 | 長半徑 a (m) | 扁率倒數 1/f |
|---|---|---:|---:|
| WGS84 | WGS84 | 6,378,137.000 | 298.257223563 |
| GRS80 | TWD97 | 6,378,137.000 | 298.257222101 |
| GRS67 Modified | TWD67 | 6,378,160.000 | 298.25 |

定義：

\[
f=\frac1{1/f},\quad b=a(1-f),\quad e^2=2f-f^2,\quad e'=\frac e{\sqrt{1-e^2}},\quad n=\frac f{2-f}.
\]

其中 `a` 為長半徑、`b` 為短半徑、`e` 第一偏心率、`e'` 第二偏心率、`n` 為第三扁率。數值來源以 EPSG／PROJ CRS 定義為準；`TWD67` 舊系統不可直接視為 WGS84，橢球體相近更不代表基準相同。

## 2. TWD67／TWD97 TM2 投影參數（全部四種組合）

| EPSG | 基準 | 中央經線 λ₀ | 原點緯度 φ₀ | 中央經線比例尺 k₀ | 東移 E₀ | 北移 N₀ |
|---|---|---:|---:|---:|---:|---:|
| 3826 | TWD97 | 121°E | 0° | 0.9999 | 250,000m | 0m |
| 3825 | TWD97 | 119°E | 0° | 0.9999 | 250,000m | 0m |
| 3828 | TWD67 | 121°E | 0° | 0.9999 | 250,000m | 0m |
| 3827 | TWD67 | 119°E | 0° | 0.9999 | 250,000m | 0m |

**119°E 與 121°E 換帶**：應以同一大地基準的逆算＋正算完成；不能把 E 坐標加上固定公尺常數。`EPSG:3828` 的部分歷史軟體定義曾有橢球／`towgs84` 使用問題，應檢查實際 PROJ 操作，不可只看 EPSG 數字就認定跨基準精度。

## 3. 六階 Krüger／Engsager–Poder TM2 正算：完整計算式

輸入同一基準之緯度 `φ`、經度 `λ`；中央經線 `λ₀`。以下三角函數角度均為弧度。

### 3.1 正規化與等角緯度

\[
\Delta\lambda=\lambda-\lambda_0,\quad
\tau=\tan\varphi,\quad
\sigma=\sinh\left(e\operatorname{atanh}(e\sin\varphi)\right),
\]

\[
\tau'=\tau\sqrt{1+\sigma^2}-\sigma\sqrt{1+\tau^2},
\]

\[
\xi'=\operatorname{atan2}(\tau',\cos\Delta\lambda),\qquad
\eta'=\operatorname{asinh}\!\left(\frac{\sin\Delta\lambda}{\sqrt{\tau'^2+\cos^2\Delta\lambda}}\right).
\]

令

\[
A=\frac{a}{1+n}\left(1+\frac{n^2}{4}+\frac{n^4}{64}+\frac{n^6}{256}\right).
\]

### 3.2 六階正算級數

\[
\xi=\xi'+\sum_{j=1}^{6}\alpha_j\sin(2j\xi')\cosh(2j\eta'),
\]

\[
\eta=\eta'+\sum_{j=1}^{6}\alpha_j\cos(2j\xi')\sinh(2j\eta'),
\]

\[
\boxed{E=E_0+k_0A\eta},\qquad\boxed{N=N_0+k_0A\xi}.
\]

正算係數（來源及可執行實作：`legacy_v3/tm6.py`）：

\[
\begin{aligned}
\alpha_1={}&\tfrac12n-\tfrac23n^2+\tfrac5{16}n^3+\tfrac{41}{180}n^4-\tfrac{127}{288}n^5+\tfrac{7891}{37800}n^6\\
\alpha_2={}&\tfrac{13}{48}n^2-\tfrac35n^3+\tfrac{557}{1440}n^4+\tfrac{281}{630}n^5-\tfrac{1983433}{1935360}n^6\\
\alpha_3={}&\tfrac{61}{240}n^3-\tfrac{103}{140}n^4+\tfrac{15061}{26880}n^5+\tfrac{167603}{181440}n^6\\
\alpha_4={}&\tfrac{49561}{161280}n^4-\tfrac{179}{168}n^5+\tfrac{6601661}{7257600}n^6\\
\alpha_5={}&\tfrac{34729}{80640}n^5-\tfrac{3418889}{1995840}n^6\\
\alpha_6={}&\tfrac{212378941}{319334400}n^6.
\end{aligned}
\]

## 4. 六階 TM2 反算

先扣除比例尺與假東移、假北移：

\[
\xi=\frac{N-N_0}{k_0A},\qquad\eta=\frac{E-E_0}{k_0A}.
\]

\[
\xi'=\xi-\sum_{j=1}^{6}\beta_j\sin(2j\xi)\cosh(2j\eta),\quad
\eta'=\eta-\sum_{j=1}^{6}\beta_j\cos(2j\xi)\sinh(2j\eta).
\]

反算係數：

\[
\begin{aligned}
\beta_1={}&\tfrac12n-\tfrac23n^2+\tfrac{37}{96}n^3-\tfrac1{360}n^4-\tfrac{81}{512}n^5+\tfrac{96199}{604800}n^6\\
\beta_2={}&\tfrac1{48}n^2+\tfrac1{15}n^3-\tfrac{437}{1440}n^4+\tfrac{46}{105}n^5-\tfrac{1118711}{3870720}n^6\\
\beta_3={}&\tfrac{17}{480}n^3-\tfrac{37}{840}n^4-\tfrac{209}{4480}n^5+\tfrac{5569}{90720}n^6\\
\beta_4={}&\tfrac{4397}{161280}n^4-\tfrac{11}{504}n^5-\tfrac{830251}{7257600}n^6\\
\beta_5={}&\tfrac{4583}{161280}n^5-\tfrac{108847}{3991680}n^6\\
\beta_6={}&\tfrac{20648693}{638668800}n^6.
\end{aligned}
\]

反得等角變數：

\[
\tau'=\frac{\sin\xi'}{\sqrt{\sinh^2\eta'+\cos^2\xi'}},\quad
\lambda=\lambda_0+\operatorname{atan2}(\sinh\eta',\cos\xi').
\]

以 Newton 迭代反求 `τ=tan φ`：

\[
\sigma(\tau)=\sinh(e\operatorname{atanh}(e\sin(\arctan\tau))),
\]

\[
F(\tau)=\tau\sqrt{1+\sigma^2}-\sigma\sqrt{1+\tau^2},
\]

\[
\tau_{k+1}=\tau_k+
\frac{(\tau'-F(\tau_k))\,[1+(1-e^2)\tau_k^2]}
{(1-e^2)\sqrt{1+\tau_k^2}\sqrt{1+F(\tau_k)^2}},\quad
\varphi=\arctan\tau.
\]

本實作以 `τ₀=τ'` 起始，最多迭代 30 次，步進小於 `1×10^-14` 結束。此公式為**完整六階**，不是以假定固定座標差取代投影。

## 5. 大地坐標 ↔ 地心直角座標（ECEF）

輸入橢球高 `h`（不是正高），同一基準下：

\[
\nu=\frac a{\sqrt{1-e^2\sin^2\varphi}},
\]

\[
\boxed{X=(\nu+h)\cos\varphi\cos\lambda},\quad
\boxed{Y=(\nu+h)\cos\varphi\sin\lambda},\quad
\boxed{Z=[\nu(1-e^2)+h]\sin\varphi}.
\]

逆算：`p=sqrt(X²+Y²)`；`λ=atan2(Y,X)`，初值

\[
\varphi_0=\operatorname{atan2}(Z,p(1-e^2)),
\]

反覆求

\[
\nu_k=\frac a{\sqrt{1-e^2\sin^2\varphi_k}},\quad
h_k=\frac p{\cos\varphi_k}-\nu_k
\]

\[
\varphi_{k+1}=\operatorname{atan2}\!\left(Z,p\left(1-\frac{e^2\nu_k}{\nu_k+h_k}\right)\right).
\]

近極點時改用 `h=Z/sinφ-ν(1-e²)` 以降低浮點不穩定；地心 `X=Y=Z=0` 無唯一緯度。無高程時**不生成 XYZ**，避免偷偷把 `h=0` 當作觀測高程。

## 6. 跨大地基準轉換

### 6.1 一般 2D PROJ 操作（實際預設）

1. 先由 PROJ 的 EPSG 座標操作資料庫查出候選轉換。
2. 不採用名稱含 `ballpark`、公告 `accuracy=-1` 的操作。
3. 以座標值計算出結果並顯示：`source EPSG`、`target EPSG`、實際操作名稱、PROJ pipeline 定義、公告精度。
4. 轉換 WGS84／TWD97 僅使用通用靜態版本；未提供年份不自行計算地殼運動。
5. 121°E 本島 TWD67↔TWD97：本機 PROJ 可列出公告約 **7 m** 的轉換操作；它**不是**公分級認證。
6. 119°E 澎湖及特殊離島缺少可辯護的 TWD67↔TWD97 操作時，不跨用本島模型，不偷偷改用球面或等值坐標。

補充：`nominal_accuracy_upper_sum_m` 是為辨識各操作公告精度而列出的**數字合計**，**不能視為嚴格誤差上限、置信區間或獨立實測 RMSE**。

### 6.2 已知參數時的嚴格七參數 Helmert

地心坐標向量 `p=(X,Y,Z)^T`，平移 `T=(T_x,T_y,T_z)^T`，尺度因子 `s`（無因次），旋轉角 `r_x,r_y,r_z`（弧度）。位置向量慣例：

\[
\boxed{p_2=T+(1+s)R_z(r_z)R_y(r_y)R_x(r_x)p_1}.
\]

其中

\[
R_x=\begin{pmatrix}1&0&0\\0&\cos r_x&-\sin r_x\\0&\sin r_x&\cos r_x\end{pmatrix},\quad
R_y=\begin{pmatrix}\cos r_y&0&\sin r_y\\0&1&0\\-\sin r_y&0&\cos r_y\end{pmatrix},
\]

\[
R_z=\begin{pmatrix}\cos r_z&-\sin r_z&0\\\sin r_z&\cos r_z&0\\0&0&1\end{pmatrix}.
\]

**嚴格反算**：

\[
\boxed{p_1=\frac{R_x^TR_y^TR_z^T(p_2-T)}{1+s}}.
\]

換算：角秒 `r(rad)=r(arcsec)π/(180×3600)`；ppm `s=ppm×10^-6`。若用「坐標框架慣例」（coordinate frame）則旋轉符號與位置向量慣例相反，不能混用。**未提供經權威資料確認的 T、R、s，本程式不提供虛構七參數預設值**。原有測試函式：`legacy_v3/engine.py`。

### 6.3 十四參數時變 Helmert

在參考時刻 `t₀` 具備七參數 `p₀` 與其七個速度 `\dot p`：

\[
T_i(t)=T_{i0}+\dot T_i(t-t_0),\quad
r_i(t)=r_{i0}+\dot r_i(t-t_0),\quad
s(t)=s_0+\dot s(t-t_0).
\]

代入上方嚴格七參數公式。遇到地殼速度則另需明確的框架間速度場 `V_X,V_Y,V_Z`：

\[
p(t)=p(t_0)+V(t-t_0)+\Delta p_{\rm quake}(t).
\]

不同年代的 TWD97[2010]、[2020] 不是「只要改名稱就高精度對齊」；除非提供官方網格模型、14 參數與時刻，否則**保留原一般 TWD97 並顯示警示**。本系統 v4 的一般操作介面不預設任意 14 參數。


## 7. 臺灣電力九碼／十一碼：完整雙向格網公式

台電原生網格以分區原點 `(E₀,N₀)` 計算，方格為 80,000 公尺（東）×50,000 公尺（北）。

設九碼字串為 `R pp qq AB cd`，十一碼為 `R pp qq AB cd ef`，其中 R 為分區字母；`pp`、`qq` 為 00–99；A∈A…H、B∈A…E；c,d,e,f∈0…9。

> **注意：** 9 碼最後 `c,d` **是 10 公尺增量**，不是可以忽略的裝飾位。十一碼新增 `e,f` 是 1 公尺增量。這修正了舊程式 `_pwr_parse_raw` 對 9 碼忽略最後兩位的問題。

| 位元 | 東向貢獻 | 北向貢獻 |
|---|---:|---:|
| `pp` | `800·pp` | 0 |
| `qq` | 0 | `500·qq` |
| A（索引 a=0…7） | `100·a` | 0 |
| B（索引 b=0…4） | 0 | `100·b` |
| `c` | `10·c` | 0 |
| `d` | 0 | `10·d` |
| `e`（十一碼） | `e` | 0 |
| `f`（十一碼） | 0 | `f` |

格網**西南角**：

\[
E=E_0+800p+100a+10c+e,\qquad N=N_0+500q+100b+10d+f.
\]

9 碼令 `e=f=0`、方格邊長 `L=10m`；11 碼 `L=1m`。座標值顯示**方格中心**時各加 `L/2`。方格中心相對真實網格內任意位置的最大幾何量化差為 `L√2/2`（9 碼約 7.071m；11 碼約 0.707m），不含大地基準轉換／電桿物理偏移。

**反向編碼**：令 `u=floor(E-E₀)`、`v=floor(N-N₀)`（只在 `[0,80000)×[0,50000)` 有效）。

\[
p=\lfloor u/800
floor,\;q=\lfloor v/500
floor,
\quad a=\lfloor (umod800)/100
floor,\quad b=\lfloor(vmod500)/100
floor,
\]
\[
c=\lfloor(umod100)/10
floor,\;d=\lfloor(vmod100)/10
floor,\quad e=umod10,\;f=vmod10.
\]

### 7.1 原生格網分區原點（公尺）

| 分區 | E₀ | N₀ | 投影原生基準 |
|---|---:|---:|---|
| A | 170000 | 2750000 | TWD67 TM2／121° |
| B | 250000 | 2750000 | 同上 |
| C | 330000 | 2750000 | 同上 |
| D | 170000 | 2700000 | 同上 |
| E | 250000 | 2700000 | 同上 |
| F | 330000 | 2700000 | 同上 |
| G | 170000 | 2650000 | 同上 |
| H | 250000 | 2650000 | 同上 |
| J | 90000 | 2600000 | 同上 |
| K | 170000 | 2600000 | 同上 |
| L | 250000 | 2600000 | 同上 |
| M | 90000 | 2550000 | 同上 |
| N | 170000 | 2550000 | 同上 |
| O | 250000 | 2550000 | 同上 |
| P | 90000 | 2500000 | 同上 |
| Q | 170000 | 2500000 | 同上 |
| R | 250000 | 2500000 | 同上 |
| T | 170000 | 2450000 | 同上 |
| U | 250000 | 2450000 | 同上 |
| V | 170000 | 2400000 | 同上 |
| W | 250000 | 2400000 | 同上 |
| X（澎湖） | 275000 | 2614000 | TWD67 TM2／119°，歷史模型非認證 |
| Y（澎湖） | 275000 | 2564000 | TWD67 TM2／119°，歷史模型非認證 |
| S（馬祖） | 10000 | 2894000 | **來源 v4 特殊 117°／國際橢球原生格網** |
| Z（金門） | `pp≥50` 取 10000；`pp<50` 取 90000 | 2675800 | **來源 v4 特殊 117°／國際橢球原生格網** |

本島分區有意**略過 I 及 S**（S 留給馬祖）；不能使用 `chr(index+65)` 把 23 項索引直接對應 26 字母，這是原始程式的實際風險。

### 7.2 金門 Z、馬祖 S：117° 特殊投影與大地基準轉換

**以下參數出自 `perfect_map_v4.py`，不是已獲官方核定的 117° 歷史座標系統定義。**

- 橢球：International 1924（Hayford）：`a=6,378,388m, 1/f=297`。
- 特殊 TM 中央經線 `λ₀=117°E`；中央經線比例尺 `k₀=0.9996`；原點緯度 `φ₀=0°`。
- 金門 Z 的投影假東移、假北移：`E_false = -42160m, N_false = -205m`。
- 馬祖 S 的投影假東移、假北移：`E_false = -279825m, N_false = +20830m`。
- 來源 3D 平移（先於國際橢球座標反解）：`(X_i,Y_i,Z_i)=(X_97+637,Y_97+549,Z_97+203)m`。
- 反向路徑：原生格網 (E,N) → 117° TM 反算（International 1924） → 該橢球地心 XYZ（**依來源 v4 假設橢球高 0m**） → 地心 XYZ 減 `(637,549,203)m` → GRS80 大地經緯度 → 靜態 WGS84 近似。
- 正向路徑：WGS84 地理位置（以一般 TWD97 近似）→ GRS80 ECEF，h=0 → XYZ 加 `(637,549,203)m` → International 1924 大地經緯度 → 117° 投影 → S/Z 格網編碼。

這條路徑**完整保留外島處理，並明確揭露其非官方與高程假設**。本套件不會誤把 S/Z 解作 119° TM2。

### 7.3 澎湖 X/Y 的跨基準原始候選七參數

來源 v4 記載（採座標框架小角旋轉符號慣例，角度單位弧度；尺度為無因次）：

- 平移 `T=(-752.47,-358.56,-179.48)m`。
- 旋轉 `rₓ=+0.0000019183, rᵧ=+0.0000010933, r_z=+0.0000015502`。
- 尺度 `s=-0.0000022206`。
- 來源小角矩陣 `M=[[1,+r_z,-r_y],[-r_z,1,+r_x],[+r_y,-r_x,1]]`。

\[
\mathbf X_{97}=\mathbf T+(1+s)M\mathbf X_{67},\qquad
\mathbf X_{67}=M^{-1}rac{\mathbf X_{97}-\mathbf T}{1+s}.
\]

本版反算使用精確 `M^{-1}`，而不是簡單把旋轉符號反向當成矩陣反矩陣；因為這是歷史候選模型，仍**不能聲稱跨基準公分級**。

### 7.4 TWD67 ↔ TWD97 本島可用的 EPSG 公告通用操作

本機 PROJ 9.5.1 在 `EPSG:3828→EPSG:3826` 選用的公告操作為兩維仿射：

\[
oxed{E_{97}=E_{67}+828.589\;\mathrm m},\qquad
oxed{N_{97}=N_{67}-206.915\;\mathrm m}.
\]

反算嚴格扣回：`E67=E97−828.589m`、`N67=N97+206.915m`。**操作公告精度約 7m**，不能用近零閉合差冒充獨立測量精度，也不能將這組本島平移硬套澎湖／金門／馬祖。

## 8. 公開台電電桿資料的經驗校正模型（預設開啟、可關閉）

設歷史模型預測 TWD97 119° 平面點為 `(E_p,N_p)`、公開同圖號電桿位置為 `(E_o,N_o)`，以**圖號分組的訓練集**估計殘差 `(ΔE,ΔN)=(E_p-E_o,N_p-N_o)`，設中心 `(E_c,N_c)`。對每一區域建立低階線性模型（係數來自實際資料最小平方法＋迭代離群值處理）：

\[
\Delta E=b_{E0}+b_{E1}(E_p-E_c)/100000+b_{E2}(N_p-N_c)/100000,
\]
\[
\Delta N=b_{N0}+b_{N1}(E_p-E_c)/100000+b_{N2}(N_p-N_c)/100000.
\]

**校正**：`(E_corr,N_corr)=(E_p-ΔE,N_p-ΔN)`；**反向編碼**以固定點迭代解 `E_p=E_target+ΔE(E_p,N_p)`、`N_p=N_target+ΔN(E_p,N_p)`。完整係數可稽核 `site/js/offshore-calibration.mjs`；模型使用台電電桿點位不是大地基準官方改正網格，也不保證其他位置的同樣誤差。


### 8.1 區域校正全部實際係數

| 區域 | E_c（m） | N_c（m） | 東向 bE0, bE1, bE2（m） | 北向 bN0, bN1, bN2（m） |
|---|---:|---:|---|---|
| X | 309697.903757 | 2617016.509442 | -3.318686806, 51.596154384, -21.884595739 | -12.801827917, -35.831046112, -18.002074819 |
| Y | 311847.899772 | 2607318.259760 | -2.492123186, -2.449754598, -6.070940916 | -13.212533188, -2.592707619, 0.049657970 |
| S | 344500.501607 | 2894545.466451 | -46.559532879, -0.268277987, 0.936095539 | 1.101135339, -0.413225871, 0.412683849 |
| Z | 183681.013601 | 2704737.840465 | 0.165560193, -0.191770574, -0.126616751 | 0.206297630, -0.114168495, 0.321685508 |

### 8.2 真實保留樣本統計及精度解讀

| 區域 | 訓練筆數 | 保留筆數 | 原始中位數(m) | 校正中位數(m) | 校正第95百分位(m) | 校正 RMSE(m) | 校正最大值(m) |
|---|---:|---:|---:|---:|---:|---:|---:|
| X | 1539 | 360 | 14.306 | 5.662 | 27.799 | 16.279 | 136.073 |
| Y | 6242 | 1618 | 14.841 | 5.418 | 35.571 | 182.822 | 4995.246 |
| S | 856 | 208 | 46.449 | 0.164 | 5.833 | 3.242 | 31.164 |
| Z | 9587 | 2413 | 4.091 | 4.088 | 7.640 | 152.896 | 7199.441 |

此表由完整資料中各區抽樣最多 12,000 個電桿紀錄，以同圖號的 SHA-256 固定雜湊分派訓練／保留，**並未以圖號資料作官方控制點定位認證**。極端異常未刪除自保留統計；例如 Y、Z 區出現數公里異常。

## 9. 兩套 Mapcode 格網的完整公式

### 9.1 使用者來源 v4 臺灣自訂 Mapcode

**不是日本 DENSO 授權的官方 MAPCODE**。依 `perfect_map_v4.py`：

- 原始設計基準：緯度 `21.75°`、經度 `119.25°`；採 `0.25°`（15′）區塊，**僅 120 個收錄區域**，且清單有自訂排序。區域代碼 `0` 省略前綴，其他區碼用 `1..119`。**120 個 `(緯度,經度)` 原點的完整 JSON**，見 `js/source-parameters.json`（`ZONE_LIST`）。
- 先求含點區塊西南角 `(zφ,zλ)`，必須查得來源清單的代碼 `zone`（不存在時拒絕，不以 `zone=0` 偷偷替代）。
- 在區塊內，以 `30″` 劃分 30×30 `block`，其次以 `1″` 劃分 30×30 `unit`。
- 再以 `1/3″` 劃分 3×3 `core`，最後以 `1/9″` 劃分 3×3 `S-core`。
- 3×3 編碼矩陣（**由南至北三列；由西至東三欄**）為：

```
5 6 7
8 0 1
2 3 4
```

設 `Δφ=(φ-zφ)`、`Δλ=(λ-zλ)`（度），換為 `1/9″` 的整數 ticks `tφ=floor(Δφ×32400)`、`tλ=floor(Δλ×32400)`。各方向：

```
block_index = floor(t / 270)        # 30″ = 270 ticks
unit_index  = floor((t % 270) / 9) # 1″ = 9 ticks
core_index  = floor((t % 9) / 3)   # 1/3″ = 3 ticks
score_index = t % 3                 # 1/9″
```

`block=30×block_lat_index+block_lon_index`；`unit=30×unit_lat_index+unit_lon_index`；`core`/`S-core` 以矩陣取字元。

字串格式（首區不顯示 zone）：`[zone ]BBB UUU*CS`。對來源 v4 原版做反算時**回傳網格西南角**：

\[
arphi=z_arphi+rac{30\lfloor B/30
floor+\lfloor U/30
floor+c_arphi/3+s_arphi/9}{3600},
\]
\[
\lambda=z_\lambda+rac{30(Bmod30)+(Umod30)+c_\lambda/3+s_\lambda/9}{3600}.
\]

「方格中心」再各加 `1/18″`。最小網格為 1/9 角秒，**不是零誤差還原原始輸入**。

### 9.2 完全獨立的 TWG 公開格網

為避免把來源 v4 的 120 區清單假裝全球標準，新增**獨立、自明的全球原點** `(−90°,−180°)`；仍採 15′/30″/1″/1/3″/1/9″ 分格，但與 v4 不共用區碼：

\[
I=\lfloor4(arphi+90)
floor\in[0,719],\qquad
J=\lfloor4(\lambda+180)
floor\in[0,1439].
\]

區塊西南角：`zφ=−90+I/4`，`zλ=−180+J/4`。字串格式 `TWG:III:JJJJ BBB UUU*CS`；可雙向解碼，預設回傳**方格中心**。格網本身不是地理測量基準，也不是日本 DENSO 官方 MAPCODE。

## 10. TWD97 年代、WGS84 框架與高程限制

- `TWD97[2010]`、`TWD97[2020]` 預設會顯示**通用 TWD97 尚未改正的數值**，狀態 `EPOCH_DEFAULT`；不可將這些相同數值誤認為真正年代轉換。
- 要做實際各年代轉換，須取得官方控制點差值網格／速度／觀測時刻。一般 TWD97 預設只是操作選擇，非實測高精度認證。
- 一般 WGS84（EPSG:4326）與 TWD97 採靜態近似；若要次公尺或公分精度須明確 GNSS 框架、年代、速度場及震後位移改正。
- 橢球高 `h` 不等於正高，缺少高程不應在跨基準七參數計算時視為已知高程 0m；歷史 v4 特例採 `h=0` 必須揭露。
- 東沙、南沙的正式台電圖號適用性尚未確認，維持 `N/A`，不阻礙本島、澎湖、金門、馬祖的作業。

## 11. 可執行測試及數值容許誤差

**不可僅靠相同程式正反算閉合宣稱實際定位精度**。測試至少區分：

1. 六階 TM2 公式對照 PROJ 9.5.1 公告實作：2,048 點，四 EPSG；正算與反算各自誤差門檻 `0.0001m`。
2. 2,000 點 WGS84 ECEF 正反算、2,000 點來源七參數正反算，驗證數值閉合。
3. 9／11 台電編碼完整位數與邊界檢查、X/Y/S/Z 來源專用測試、1/9″ Mapcode/TWG 格網位置包含測試。
4. 台電實際電桿資料的獨立保留樣本，計算每地區中位數、P95、RMSE、最大值與異常值；與數學精度分離。

執行 `node --test tests/onepass.test.mjs` 及 `node tests/field-audit.mjs`；`tests/OFFSHORE_HOLDOUT.json` 保留訓練／保留集實測統計。

## 12. 技術與官方公開來源

- [PROJ 六階 Transverse Mercator](https://proj.org/en/stable/operations/projections/tmerc.html)
- [EPSG Registry](https://epsg.org/)
- [台電電桿座標資料](https://data.gov.tw/dataset/33305)
- [台電官方圖臺](https://service.taipower.com.tw/psvs1/tpcemap/#/psvs1/home)
- [國土測繪中心免費 WMTS](https://maps.nlsc.gov.tw/pro/sysinfo.jsp)
- [國土測繪中心年代差值模型供應](https://www.nlsc.gov.tw/cp.aspx?n=14018)
- [國土測繪中心 WMTS 圖資服務](https://maps.nlsc.gov.tw/S09SOA/pro/Wmts_ajax_main.jsp)
- [Cloudflare Pages Direct Upload](https://developers.cloudflare.com/pages/get-started/direct-upload/)

所有來源 v4 的特殊參數保留於 `site/js/geodesy.mjs`、`site/js/taipower.mjs` 與 `site/js/source-parameters.json`；未取用的舊有投影近似程式未被冒充為精確核心。


## v8：地圖標記與互動座標換算（原生 Web Mercator）

地圖顯示採球面 Web Mercator 的瓦片座標；此部分**只用於地圖呈現**，不取代 TM2 大地基準投影公式。

對於 WGS84 地理座標 `(φ, λ)`（度）、整數縮放階數 `z`、標準 256 像素圖磚：

- `n = 256 × 2^z`
- `x = n(λ + 180°)/360°`
- `y = (n/2)[1 - ln(tan(π/4 + φ/2))/π]`，其中 `φ` 轉換為弧度。
- `φ = (180°/π) atan[sinh(π(1 - 2y/n))]`
- `λ = 360° × x/n - 180°`（處理跨 180° 的經度週期）。

顯示標記以輸入座標轉換後的 **WGS84 十進位經緯度**換算至像素位置；地圖點選時，反向將游標像素坐標換回 **WGS84 經緯度**，再重算其它座標種類。這是視覺定位，不代表 TM2 與不同基準的實地精度。

底圖取自國土測繪中心 `EMAP/default/EPSG:3857`，不需額外 API 金鑰。
