雷達回波

中央氣象署雷達整合回波（回波強度，單位 dBZ）的圖磚。涵蓋東經 115°–126.5°、北緯 18°–29°，格距 0.0125°。保留約 7 天，時間間隔依中央氣象署發布而定，請以列表為準。適合做降雨回波動畫、即時天氣地圖。

共通規則（座標、快取、資料來源標示、完整地圖範例）見圖磚概要。

資料授權

註明來源・可商用
建議標示資料來源：中央氣象署、ExpTech Studio（exptech.dev）

上游條款

中央氣象署：另須遵守中央氣象署的資料使用規範（例如政府資料開放授權條款）；氣象與地震資訊以中央氣象署發布的內容為準。

標示位置、範例與商業使用申請見資料授權與來源標示。

驗證

目前不需要 API Token。

取得可用時間

GEThttps://api.core-tnn1.exptech.dev/api/v2/tiles/radar/list

可商用

伺服器TNN-1

請求範例

curl --compressed "https://api.core-tnn1.exptech.dev/api/v2/tiles/radar/list"

const res = await fetch("https://api.core-tnn1.exptech.dev/api/v2/tiles/radar/list");
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://api.core-tnn1.exptech.dev/api/v2/tiles/radar/list",
    timeout=10,
)
res.raise_for_status()
print(res.json())

回應

200500

成功（沒有資料時為 [ ]）；用戶端支援時以 gzip 壓縮

[
  1794641400,
  600,
  600,
  600
]

伺服器錯誤（純文字錯誤訊息）text/plain

試試看

回應欄位

回應是 delta 編碼的整數陣列，由舊到新，單位 Unix 秒（還原方式見圖磚概要）。

欄位	類型	說明
`[0]`	`integer`	最舊一筆的時間，Unix 秒。
`[i]（i ≥ 1）`	`integer`	與前一筆的差，秒。累加後得到每一筆的時間。

取得圖磚

GEThttps://static.core-tnn1.exptech.dev/api/v2/tiles/radar/{time}/{z}/{x}/{y}.webp

可商用

伺服器TNN-1

路徑參數

timeinteger必填
Unix 秒，必須是列表裡的值（完全相等，不會找最接近的一筆）。
zinteger必填
縮放層級，3–12。超出範圍回 1 × 1 透明 GIF。
xinteger必填
XYZ 圖磚欄號。
yinteger必填
XYZ 圖磚列號（由北往南）。

請求範例

curl -o output.webp "https://static.core-tnn1.exptech.dev/api/v2/tiles/radar/<time>/<z>/<x>/<y>.webp"

const res = await fetch("https://static.core-tnn1.exptech.dev/api/v2/tiles/radar/<time>/<z>/<x>/<y>.webp");
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const blob = await res.blob();

import requests

res = requests.get(
    "https://static.core-tnn1.exptech.dev/api/v2/tiles/radar/<time>/<z>/<x>/<y>.webp",
    timeout=10,
)
res.raise_for_status()
with open("output.webp", "wb") as f:
    f.write(res.content)

回應

200304400500

image/webp，256 × 256，無損壓縮、透明背景，只畫出有回波（dBZ > 0）的格點。z 不在 3–12、圖磚不在涵蓋範圍內，或範圍內沒有回波時，改回 1 × 1 透明 GIF（image/gif）binary image/webp

If-None-Match 與 ETag 相符，沒有內容沒有回應本文

time 不是整數

bad time

該時間不存在，或伺服器錯誤；內容只有一個換行沒有回應本文

試試看

色階

dBZ 捨去小數後，每個整數對應一種顏色（0–65 dBZ，超過 65 以 65 的顏色表示）。主要節點：

dBZ	顏色	說明
0–14	`#00FFFF` → `#0000FF`	青到藍，逐 dBZ 加深
15–25	`#00FF00` → `#009600`	綠，逐 dBZ 加深
26–29	`#33AB00` → `#CCEA00`	黃綠
30–35	`#FFFF00` → `#FFC800`	黃
36–44	`#FFB800` → `#FF1800`	橙
45–55	`#FF0000` → `#960000`	紅，逐 dBZ 加深
56–59	`#AB0033` → `#EA00CC`	紫紅
60–65	`#FF00FF` → `#9600FF`	洋紅到紫

注意事項

時間不存在時回 500，不是 404。 內容只有一個換行。請只使用列表裡的時間；過舊（約 7 天前）的時間會從列表消失，也就拿不到圖磚。
時間要完全相等。time 是 Unix 秒，不要用毫秒。
z、x、y 不是整數時不會回 400，會被當成 0 處理，請自行檢查。
不需要的縮放層級請在地圖函式庫設定 minzoom: 3、maxzoom: 12，超過 12 時放大第 12 層的圖磚。
圖磚網址的內容固定，可以在用戶端長期快取；回應沒有 Cache-Control，但有 ETag 可做條件請求。
同一個列表路徑在圖磚主機也能取得，但會快取約 1 小時，請用上方的列表主機取得最新時間。
圖上請依資料授權的建議標示註明來源。