香港天氣查詢技能

本技能提供調用香港天文台 (HKO) 開放數據 API 的完整指導，無需 API Key，完全免費。

API 基礎資訊

• - 基址: https://data.weather.gov.hk/weatherAPI/opendata/weather.php
• 認證: 無需 API Key
• 回應格式: JSON
• 語言參數: lang=en (英文) 或 lang=tc (繁體中文)
• 官方文檔: 見 references/api-docs.md

核心端點速查

需求	dataType	說明	更新頻率
全港即時天氣	rhrread	當前天氣報告 (含分區數據)	每小時
分區天氣

rhrread | 指定地區氣溫 (例如：沙田、銅鑼灣) | 每小時 | | 本地天氣預報 | flw | 本地天氣預報 | 每小時 | | 九天預報 | fnd | 九天天氣預報 | 每日 2 次 | | 天氣警告摘要 | warnsum | 天氣警告摘要 | 即時 | | 天氣警告詳情 | warningInfo | 詳細天氣警告資訊 | 即時 | | 特別天氣提示 | swt | 特別天氣提示 | 即時 |

⚠️ 注意: 分區天氣數據包含在 rhrread 回應中，為臨時數據，僅經有限度驗證。

標準調用流程

步驟 1: 確定用戶需求

詢問或確認用戶需要：

• - 當前天氣還是預報？
• 全港還是特定分區？
• 是否需要天氣警告資訊？

步驟 2: 調用腳本獲取天氣數據 ⭐

優先使用腳本，而非直接調用 API。腳本已處理 API 請求、JSON 解析和錯誤處理。

標準命令：

bash

全港即時天氣 (含分區氣溫)

python3 {baseDir}/scripts/fetch_weather.py --type current

指定地區天氣 (例如：沙田)

python3 {baseDir}/scripts/fetch_weather.py --type regional --location 沙田

九天預報

python3 {baseDir}/scripts/fetch_weather.py --type forecast --days 9

3 天預報

python3 {baseDir}/scripts/fetch_weather.py --type forecast --days 3

本地天氣預報 (概況)

python3 {baseDir}/scripts/fetch_weather.py --type hourly

檢查天氣警告

python3 {baseDir}/scripts/check_warnings.py

僅檢查關鍵警告 (暴雨/颱風等)

python3 {baseDir}/scripts/check_warnings.py --critical

步驟 3: 呈現結果

以清晰格式向用戶展示天氣資訊，包括：

• - 溫度、濕度
• 風向、風速
• 預報趨勢 (如適用)
• 生效中警告 (如適用)

註: 除非腳本不可用，否則避免直接用 web_fetch 調用 API。

使用腳本

本技能提供以下腳本：

腳本	用途
scripts/fetchweather.py	獲取並解析天氣數據
scripts/checkwarnings.py

檢查生效中天氣警告 |

使用示例:

bash

全港即時天氣 (含分區氣溫)

python3 {baseDir}/scripts/fetch_weather.py --type current

指定地區天氣 (例如：沙田)

python3 {baseDir}/scripts/fetch_weather.py --type regional --location 沙田

指定地區天氣 (例如：香港天文台)

python3 {baseDir}/scripts/fetch_weather.py --type regional --location 香港天文台

顯示所有分區氣溫

python3 {baseDir}/scripts/fetch_weather.py --type regional

九天預報

python3 {baseDir}/scripts/fetch_weather.py --type forecast --days 9

3 天預報

python3 {baseDir}/scripts/fetch_weather.py --type forecast --days 3

本地天氣預報 (概況)

python3 {baseDir}/scripts/fetch_weather.py --type hourly

降雨資訊 (過去一小時分區降雨量)

python3 {baseDir}/scripts/fetch_weather.py --type rainfall

降雨預報 (未來幾日是否會下雨)

python3 {baseDir}/scripts/fetch_weather.py --type rainfall-forecast --days 9

降雨預報 (未來 3 日)

python3 {baseDir}/scripts/fetch_weather.py --type rainfall-forecast --days 3

檢查天氣警告

python3 {baseDir}/scripts/check_warnings.py

僅檢查關鍵警告 (暴雨/颱風等)

python3 {baseDir}/scripts/check_warnings.py --critical

輸出原始 JSON

python3 {baseDir}/scripts/fetch_weather.py --type current --json

詳細腳本文檔見 references/scripts.md。

參考資料

• - API 完整文檔: references/api-docs.md
• 腳本使用說明: references/scripts.md
• 分區代碼對照表: references/regions.md
• 天氣警告類型說明: references/warnings.md

注意事項

1. 1. 使用條款:

- 本專案代碼（Code）以 MIT 等開源授權釋出；資料使用受香港天文台使用條款約束，商業用途可能需要天文台書面授權（見 references/api-docs.md）。 - 請於輸出中清楚註明資料來源為「香港天文台」，並必要時展示免責聲明（見 references/terms-and-attribution.md）。 - 不可用於航空、航海等安全關鍵應用。 - 不可誤導用戶認為本專案與香港天文台有正式合作或背後授權。

1. 2. 錯誤處理:

- API 可能返回 404 或其他 HTTP 錯誤 - 建議加入重試機制 - 檢查 JSON 回應中的 error 欄位

1. 3. 數據限制:

- 分區天氣為臨時數據 - 預報數據可能隨更新調整 - 警告資訊以天文台官方發布為準

觸發場景

當用戶提出以下類型的請求時，應使用本技能：

• - 「香港今日天氣怎麼樣？」
• 「明天會不會下雨？」
• 「有沒有暴雨警告？」
• 「九龍區現在幾度？」
• 「未來幾天天氣怎麼樣？」
• 「有沒有颱風警告？」