常用天氣預報 API 接口大全：中國天氣網、Google、Yahoo 參數與城市代碼

整理主流免費天氣 API 接口調用方式、返回數據結構、城市代碼對照表及優缺點對比，幫助快速在項目中集成天氣功能。

1. 中國天氣網（weather.com.cn）

接口：https://www.weather.com.cn/data/cityinfo/101010100.html（北京）
返回：JSON 格式，包含 6 天預報、溫度、風力、穿衣指數、紫外線、洗車/旅遊/舒適度指數等豐富字段

{
  "weatherinfo": {
    "city": "北京", "cityid": "101010100",
    "temp1": "2℃~-7℃", "weather1": "晴",
    "wind1": "北風3-4級轉微風", "index": "冷",
    "index_d": "天氣冷，建議著棉衣...", ...
  }
}

城市代碼：101010100=北京，101020100=上海，101030100=天津...（文中附全國 300+ 城市代碼表）
優點：數據全面、穩定、中文友好、無需 Key
缺點：官方未公開文檔、可能限制頻率

2. Google Weather API（已停止維護，歷史參考）

接口：https://www.google.com/ig/api?hl=zh-cn&weather=beijing
城市查詢：https://www.google.com/ig/cities?hl=zh-cn&country=cn
特點：支持經緯度、郵編、城市名；返回 4 天預報；中國城市覆蓋極少

3. Yahoo Weather API

接口：https://weather.yahooapis.com/forecastrss?w=2151330&u=c
參數：w=WOEID（北京 2151330），u=c（攝氏度）/f（華氏度）
返回：XML 格式
優點：國際城市覆蓋全、數據權威
缺點：需查詢 WOEID、XML 解析稍繁瑣

城市代碼快速查詢表（部分）

完整代碼表請參考文中附件或調用城市列表接口動態獲取。

集成建議

1. 首選中國天氣網：國內項目數據最全、無 Key、JSON 易解析
2. 做緩存與降級：API 非商業 SLA，設置 10-30 分鐘緩存，失效時降級顯示「天氣數據暫不可用」
3. 異步加載：前端 JS 請求或後端預抓取，避免阻塞頁面渲染
4. 備選方案：高德/騰訊/和風天氣等商業免費額度 API，穩定性更高

合理選擇天氣 API，讓應用感知環境，提升用戶體驗。