逐日预报 API

forecasts/v1/daily 逐日预报:1/5/10 日标准与 25/45/90 日进阶,含最高最低温、白天/夜间天气与降水概率,需 Location Key。

产品概述

华风爱科逐日预报 API 提供全球地点的逐日天气预报,分为标准能力进阶能力。调用前需通过 定位搜索 API 获取 Location Key。标准能力覆盖 1/5/10 日预报;进阶能力支持 25/45/90 日长期预报,适用于日历、出行规划与行业决策场景。由中国气象局授权品牌与 AccuWeather 全球数据能力提供支撑。

  • 标准能力: /forecasts/v1/daily/1day|5day|10day/{locationkey}.json
  • 进阶能力: 25day / 45day / 90day 长期逐日预报(需单独开通)
  • 完整字段: details=true 返回白天/夜间分项、降水概率、风速等扩展要素
  • 典型场景: 7–15 天日历展示、微信小程序、平板分栏视图
产品展示

通过逐日预报API可以构建的应用示例

Tablet华风爱科逐日预报 API 平板 7-15 天天气日历示例

平板应用

iPad/Android平板优化的天气应用,充分利用大屏幕展示丰富的气象信息

分栏视图平滑交互大屏适配
iOS/Android华风爱科 daily 逐日预报移动端 APP 下拉刷新示例

移动端APP

原生/混合移动应用,提供贴靠随身浏览的突发天气预防的用户界面

触控优化下拉刷新推送通知
Web/PC逐日预报 API PC 端 7-15 天趋势图表展示示例

PC端天气网站

桌面浏览器端的天气预报网站,提供未来7-15天的详细天气数据展示,包含趋势图表、温湿度等多种可视化内容

响应式布局图表可视化多数据展示
微信小程序微信小程序 5 日逐日预报 lightweight 展示示例

微信小程序

嵌入微信生态,展示7天预报数据,适配小程序交互规范

即用即走一键分享轻量化

快速开始

  1. 免费注册并完成开发者认证,获取 API Key(标准测试 Key 开通 30 天试用,每日 500 次免费调用,5 QPS)。
  2. 通过 定位搜索 API 获取 Location Key(示例:101924 北京)。
  3. 选择预报天数:标准能力可用 1day / 5day / 10day,请求 GET /forecasts/v1/daily/5day/{locationkey}.json,建议 language=zh-cndetails=true

标准能力接口

GET 1日预报
https://openapi.weathercn.com/forecasts/v1/daily/1day/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true
GET 5日预报
https://openapi.weathercn.com/forecasts/v1/daily/5day/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true
GET 10日预报
https://openapi.weathercn.com/forecasts/v1/daily/10day/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true

进阶能力接口

⚠️ 进阶接口(25/45/90 日长期预报)需单独申请开通权限。标准测试 Key 无法调用,会返回 401/403。如需开通,请注册账号后联系商务咨询,或在开发者后台提交权限申请。
GET 25日预报 进阶
https://openapi.weathercn.com/forecasts/v1/daily/25day/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true
GET 45日预报 进阶
https://openapi.weathercn.com/forecasts/v1/daily/45day/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true
GET 90日预报 进阶
https://openapi.weathercn.com/forecasts/v1/daily/90day/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true

请求参数

URL 路径格式为 /forecasts/v1/daily/{Nday}/{locationkey}.json,其中 {Nday} 为预报天数(如 5day),{locationkey} 为定位 API 返回的 Key;下表为查询参数。进阶长期预报仅更换路径中的天数段,查询参数一致。

参数名 类型 必填 默认值 说明 示例
apikey String - 用以在API里验证与授权使用的用户密钥 YOUR_API_KEY
version String v1 当前API版本 v1
locationkey String - 用以搜索指定地点的特定ID 101924
format String JSON 响应格式 JSON
language String en-us 指定响应数据语言的字符串 zh-cn
details String false 用以判断返回缩短版或完整版的每日天气预报 details = true
metric String false 是否使用公制单位 metric = true

返回字段

参数 类型 说明 数据形式示例
Headline
Object 预报摘要信息 -
└─ EffectiveDate
String 生效时间 2026-07-27T08:00:00+08:00
└─ EffectiveEpochDate
Int 生效时间的 UNIX 时间戳 1785110400
└─ Severity
Int 严重程度 1
└─ Text
String 摘要文本 天气晴朗,未来2天以晴为主
└─ Category
String 类别 tips
└─ EndDate
String 结束时间 2026-07-29T18:00:00+08:00
└─ EndEpochDate
Int 结束时间的 UNIX 时间戳 1785319200
└─ MobileLink
String 移动端链接 http://m.weathercn.com/zh/cn/beijing/101924/daily-weather-forecast/101924?unit=c&lang=zh-cn
└─ Link
String 网页端链接 http://m.weathercn.com/zh/cn/beijing/101924/daily-weather-forecast/101924?unit=c&lang=zh-cn
DailyForecasts
Array 逐日预报数组 -
└─ Date
String 预报日期 2026-07-27T11:00:00+08:00
└─ EpochDate
Int 预报日期的 UNIX 时间戳 1785121200
└─ Sun
Object 日出日落 -
└─ Rise
String 日出时间 2026-07-27T05:08:00+08:00
└─ EpochRise
Int 日出的 UNIX 时间戳 1785100080
└─ Set
String 日落时间 2026-07-27T19:34:00+08:00
└─ EpochSet
Int 日落的 UNIX 时间戳 1785152040
└─ Moon
Object 月相信息 -
└─ Rise
String 月升时间 2026-07-27T18:21:30+08:00
└─ EpochRise
Int 月升的 UNIX 时间戳 1785147690
└─ Set
String 月落时间 2026-07-28T03:19:57+08:00
└─ EpochSet
Int 月落的 UNIX 时间戳 1785179997
└─ Phase
String 月相 WaxingGibbous
└─ Age
Int 月龄 13
└─ Temperature
Object 温度范围 -
└─ Minimum
Object 最低温度 -
└─ Value
Float 数值 24
└─ Unit
String 单位 C
└─ UnitType
Int 单位类型 17
└─ Maximum
Object 最高温度 -
└─ Value
Float 数值 33
└─ Unit
String 单位 C
└─ UnitType
Int 单位类型 17
└─ RealFeelTemperature
Object 体感温度 -
└─ Minimum
Object 最低体感 -
└─ Value
Float 数值 28
└─ Unit
String 单位 C
└─ UnitType
Int 单位类型 17
└─ Maximum
Object 最高体感 -
└─ Value
Float 数值 37
└─ Unit
String 单位 C
└─ UnitType
Int 单位类型 17
└─ RealFeelTemperatureShade
Object 阴影下体感温度 -
└─ Minimum
Object 最低体感 -
└─ Value
Float 数值 28.2
└─ Unit
String 单位 C
└─ UnitType
Int 单位类型 17
└─ Maximum
Object 最高体感 -
└─ Value
Float 数值 37.1
└─ Unit
String 单位 C
└─ UnitType
Int 单位类型 17
└─ HoursOfSun
Float 日照时数 8.7
└─ DegreeDaySummary
Object 度数日摘要 -
└─ Heating
Object 取暖度数 -
└─ Value
Float 数值 0
└─ Unit
String 单位 C
└─ UnitType
Int 单位类型 17
└─ Cooling
Object 避暑度数 -
└─ Value
Float 数值 10
└─ Unit
String 单位 C
└─ UnitType
Int 单位类型 17
└─ AirAndPollen
Array 空气质量与花粉指数 -
└─ Name
String 指数名称 AirQuality
└─ Value
Int 数值 90
└─ Category
String 类别描述
└─ CategoryValue
Int 类别对应数值 2
└─ Type
String 具体类型 (如臭氧) 臭氧
└─ Day
Object 白天天气 -
└─ Icon
Int 天气图标 7
└─ IconPhrase
String 天气描述 多云
└─ ShortPhrase
String 简短描述 多云
└─ LongPhrase
String 详细描述 多云
└─ LocalSource
Object 本地数据源 -
└─ Id
Int 源 ID 7
└─ Name
String 源名称 Huafeng
└─ WeatherCode
String 天气代码 01
└─ WindLevelCode
String 风力等级代码 0
└─ WindDirectionCode
String 风向代码 4
└─ PubName
String 发布者 中央气象台
└─ PubTime
String 发布时间 2026-07-27T12:00:00+08:00
└─ EpochPubTime
Int 发布的 UNIX 时间戳 1785124800
└─ HasPrecipitation
Boolean 是否有降水 false
└─ PrecipitationType
String 降水类型 null
└─ PrecipitationIntensity
String 降水强度 null
└─ PrecipitationProbability
Int 降水概率 (%) 55
└─ ThunderstormProbability
Int 雷暴概率 (%) 33
└─ RainProbability
Int 降雨概率 (%) 55
└─ SnowProbability
Int 降雪概率 (%) 0
└─ IceProbability
Int 结冰概率 (%) 0
└─ Wind
Object 风力 -
└─ Speed
Object 风速 -
└─ Value
Float 数值 3.2
└─ Unit
String 单位 km/h
└─ UnitType
Int 单位类型 7
└─ Direction
Object 风向 -
└─ Degrees
Int 角度 180
└─ Localized
String 地方向
└─ English
String 英文方向 S
└─ WindGust
Object 阵风 -
└─ Speed
Object 风速 -
└─ Value
Float 数值 25.9
└─ Unit
String 单位 km/h
└─ UnitType
Int 单位类型 7
└─ Direction
Object 风向 -
└─ Degrees
Int 角度 189
└─ Localized
String 地方向
└─ English
String 英文方向 S
└─ TotalLiquid
Object 总液体降水量 -
└─ Value
Float 数值 1.7
└─ Unit
String 单位 mm
└─ UnitType
Int 单位类型 3
└─ Rain
Object 降雨量 -
└─ Value
Float 数值 1.7
└─ Unit
String 单位 mm
└─ UnitType
Int 单位类型 3
└─ Snow
Object 降雪量 -
└─ Value
Float 数值 0
└─ Unit
String 单位 cm
└─ UnitType
Int 单位类型 4
└─ Ice
Object 结冰量 -
└─ Value
Float 数值 0
└─ Unit
String 单位 mm
└─ UnitType
Int 单位类型 3
└─ HoursOfPrecipitation
Float 降水时长 1.5
└─ HoursOfRain
Float 降雨时长 1.5
└─ HoursOfSnow
Float 降雪时长 0
└─ HoursOfIce
Float 结冰时长 0
└─ CloudCover
Int 云量 (%) 43
└─ Evapotranspiration
Object 蒸散量 -
└─ Value
Float 数值 4.6
└─ Unit
String 单位 mm
└─ UnitType
Int 单位类型 3
└─ SolarIrradiance
Object 太阳辐射量 -
└─ Value
Float 数值 7962.6
└─ Unit
String 单位 W/m²
└─ UnitType
Int 单位类型 33
└─ Night
Object 夜间天气 -
└─ Icon
Int 天气图标 7
└─ IconPhrase
String 天气描述 多云
└─ ShortPhrase
String 简短描述 多云
└─ LongPhrase
String 详细描述 多云
└─ LocalSource
Object 本地数据源 -
└─ Id
Int 源 ID 7
└─ Name
String 源名称 Huafeng
└─ WeatherCode
String 天气代码 01
└─ WindLevelCode
String 风力等级代码 0
└─ WindDirectionCode
String 风向代码 4
└─ PubName
String 发布者 中央气象台
└─ PubTime
String 发布时间 2026-07-27T12:00:00+08:00
└─ EpochPubTime
Int 发布的 UNIX 时间戳 1785124800
└─ HasPrecipitation
Boolean 是否有降水 false
└─ PrecipitationType
String 降水类型 null
└─ PrecipitationIntensity
String 降水强度 null
└─ PrecipitationProbability
Int 降水概率 (%) 61
└─ ThunderstormProbability
Int 雷暴概率 (%) 12
└─ RainProbability
Int 降雨概率 (%) 61
└─ SnowProbability
Int 降雪概率 (%) 0
└─ IceProbability
Int 结冰概率 (%) 0
└─ Wind
Object 风力 -
└─ Speed
Object 风速 -
└─ Value
Float 数值 3.2
└─ Unit
String 单位 km/h
└─ UnitType
Int 单位类型 7
└─ Direction
Object 风向 -
└─ Degrees
Int 角度 180
└─ Localized
String 地方向
└─ English
String 英文方向 S
└─ WindGust
Object 阵风 -
└─ Speed
Object 风速 -
└─ Value
Float 数值 20.4
└─ Unit
String 单位 km/h
└─ UnitType
Int 单位类型 7
└─ Direction
Object 风向 -
└─ Degrees
Int 角度 183
└─ Localized
String 地方向
└─ English
String 英文方向 S
└─ TotalLiquid
Object 总液体降水量 -
└─ Value
Float 数值 1.3
└─ Unit
String 单位 mm
└─ UnitType
Int 单位类型 3
└─ Rain
Object 降雨量 -
└─ Value
Float 数值 1.3
└─ Unit
String 单位 mm
└─ UnitType
Int 单位类型 3
└─ Snow
Object 降雪量 -
└─ Value
Float 数值 0
└─ Unit
String 单位 cm
└─ UnitType
Int 单位类型 4
└─ Ice
Object 结冰量 -
└─ Value
Float 数值 0
└─ Unit
String 单位 mm
└─ UnitType
Int 单位类型 3
└─ HoursOfPrecipitation
Float 降水时长 1
└─ HoursOfRain
Float 降雨时长 1
└─ HoursOfSnow
Float 降雪时长 0
└─ HoursOfIce
Float 结冰时长 0
└─ CloudCover
Int 云量 (%) 42
└─ Evapotranspiration
Object 蒸散量 -
└─ Value
Float 数值 0.3
└─ Unit
String 单位 mm
└─ UnitType
Int 单位类型 3
└─ SolarIrradiance
Object 太阳辐射量 -
└─ Value
Float 数值 252.4
└─ Unit
String 单位 W/m²
└─ UnitType
Int 单位类型 33
└─ Sources
Array 数据源列表 (如 ["中国天气通"]) -
└─ MobileLink
String 移动端链接 http://m.weathercn.com/zh/cn/beijing/101924/daily-weather-forecast/101924?day=1&unit=c&lang=z...
└─ Link
String 网页端链接 http://m.weathercn.com/zh/cn/beijing/101924/daily-weather-forecast/101924?day=1&unit=c&lang=z...
>_ 代码示例
# 调取5日逐日预报(标准能力)
curl "https://openapi.weathercn.com/forecasts/v1/daily/5day/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true"
// 调取5日逐日预报(标准能力)
fetch('https://openapi.weathercn.com/forecasts/v1/daily/5day/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true')
  .then(response => response.json())
  .then(data => console.log(data));
import requests

# 调取5日逐日预报(标准能力)
url = "https://openapi.weathercn.com/forecasts/v1/daily/5day/101924.json"
params = {'apikey': 'YOUR_API_KEY', 'language': 'zh-cn', 'details': 'true'}
response = requests.get(url, params=params)
print(response.json())
// 调取5日逐日预报(标准能力)
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://openapi.weathercn.com/forecasts/v1/daily/5day/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
<?php
// 调取5日逐日预报(标准能力)
$url = 'https://openapi.weathercn.com/forecasts/v1/daily/5day/101924.json';
$params = http_build_query(['apikey' => 'YOUR_API_KEY', 'language' => 'zh-cn', 'details' => 'true']);
$response = file_get_contents($url . '?' . $params);
print_r(json_decode($response, true));
?>
package main
import (
  "fmt"
  "io"
  "net/http"
)
func main() {
  url := "https://openapi.weathercn.com/forecasts/v1/daily/5day/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true"
  resp, _ := http.Get(url)
  defer resp.Body.Close()
  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
}
require 'net/http'
require 'json'

url = URI("https://openapi.weathercn.com/forecasts/v1/daily/5day/101924.json")
params = {apikey: 'YOUR_API_KEY', language: 'zh-cn', details: 'true'}
url.query = URI.encode_www_form(params)
response = Net::HTTP.get_response(url)
puts JSON.parse(response.body)
let url = URL(string: "https://openapi.weathercn.com/forecasts/v1/daily/5day/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true")!
let task = URLSession.shared.dataTask(with: url) { data, response, error in
    if let data = data { print(try? JSONSerialization.jsonObject(with: data)) }
}
task.resume()
{
  "Headline": {
    "EffectiveDate": "2026-03-10T08:00:00+08:00",
    "EffectiveEpochDate": 1773100800,
    "Severity": 1,
    "Text": "天气晴朗,未来2天以晴为主",
    "Category": "tips",
    "EndDate": "2026-03-12T18:00:00+08:00",
    "EndEpochDate": 1773309600,
    "MobileLink": "http://m.weathercn.com/...",
    "Link": "http://m.weathercn.com/..."
  },
  "DailyForecasts": [
    {
      "Date": "2026-03-10T08:00:00+08:00",
      "EpochDate": 1773100800,
      "Sun": {
        "Rise": "2026-03-10T06:35:00+08:00",
        "EpochRise": 1773095700,
        "Set": "2026-03-10T18:15:00+08:00",
        "EpochSet": 1773137700
      },
      "Moon": {
        "Rise": "2026-03-10T00:26:59+08:00",
        "EpochRise": 1773073619,
        "Set": "2026-03-10T09:33:04+08:00",
        "EpochSet": 1773106384,
        "Phase": "WaningGibbous",
        "Age": 21
      },
      "Temperature": {
        "Minimum": { "Value": 2.0, "Unit": "C", "UnitType": 17 },
        "Maximum": { "Value": 11.0, "Unit": "C", "UnitType": 17 }
      },
      "RealFeelTemperature": {
        "Minimum": { "Value": -1.2, "Unit": "C", "UnitType": 17 },
        "Maximum": { "Value": 15.0, "Unit": "C", "UnitType": 17 }
      },
      "RealFeelTemperatureShade": {
        "Minimum": { "Value": -1.2, "Unit": "C", "UnitType": 17 },
        "Maximum": { "Value": 11.2, "Unit": "C", "UnitType": 17 }
      },
      "HoursOfSun": 4.3,
      "DegreeDaySummary": {
        "Heating": { "Value": 11.0, "Unit": "C", "UnitType": 17 },
        "Cooling": { "Value": 0.0, "Unit": "C", "UnitType": 17 }
      },
      "AirAndPollen": [
        { "Name": "AirQuality", "Value": 90, "Category": "良", "CategoryValue": 2, "Type": "臭氧" },
        { "Name": "UVIndex", "Value": 4, "Category": "弱", "CategoryValue": 2 }
      ],
      "Day": {
        "Icon": 1,
        "IconPhrase": "晴",
        "ShortPhrase": "晴",
        "LongPhrase": "晴",
        "LocalSource": {
          "Id": 7,
          "Name": "Huafeng",
          "WeatherCode": "00",
          "WindLevelCode": "0",
          "WindDirectionCode": "4",
          "PubName": "中央气象台",
          "PubTime": "2026-03-10T08:00:00+08:00",
          "EpochPubTime": 1773100800
        },
        "HasPrecipitation": false,
        "PrecipitationProbability": 2,
        "ThunderstormProbability": 0,
        "RainProbability": 2,
        "SnowProbability": 0,
        "IceProbability": 0,
        "Wind": {
          "Speed": { "Value": 3.2, "Unit": "km/h", "UnitType": 7 },
          "Direction": { "Degrees": 180, "Localized": "南", "English": "S" }
        },
        "WindGust": {
          "Speed": { "Value": 20.4, "Unit": "km/h", "UnitType": 7 },
          "Direction": { "Degrees": 191, "Localized": "南", "English": "S" }
        },
        "TotalLiquid": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Rain": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Snow": { "Value": 0.0, "Unit": "cm", "UnitType": 4 },
        "Ice": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "HoursOfPrecipitation": 0.0,
        "HoursOfRain": 0.0,
        "HoursOfSnow": 0.0,
        "HoursOfIce": 0.0,
        "CloudCover": 61,
        "Evapotranspiration": { "Value": 1.8, "Unit": "mm", "UnitType": 3 },
        "SolarIrradiance": { "Value": 2791.8, "Unit": "W/m²", "UnitType": 33 }
      },
      "Night": {
        "Icon": 33,
        "IconPhrase": "晴",
        "ShortPhrase": "晴",
        "LongPhrase": "晴",
        "LocalSource": {
          "Id": 7,
          "Name": "Huafeng",
          "WeatherCode": "00",
          "WindLevelCode": "0",
          "WindDirectionCode": "8",
          "PubName": "中央气象台",
          "PubTime": "2026-03-10T08:00:00+08:00",
          "EpochPubTime": 1773100800
        },
        "HasPrecipitation": false,
        "PrecipitationProbability": 0,
        "ThunderstormProbability": 0,
        "RainProbability": 0,
        "SnowProbability": 0,
        "IceProbability": 0,
        "Wind": {
          "Speed": { "Value": 3.2, "Unit": "km/h", "UnitType": 7 },
          "Direction": { "Degrees": 0, "Localized": "北", "English": "N" }
        },
        "WindGust": {
          "Speed": { "Value": 24.1, "Unit": "km/h", "UnitType": 7 },
          "Direction": { "Degrees": 9, "Localized": "北", "English": "N" }
        },
        "TotalLiquid": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Rain": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Snow": { "Value": 0.0, "Unit": "cm", "UnitType": 4 },
        "Ice": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "HoursOfPrecipitation": 0.0,
        "HoursOfRain": 0.0,
        "HoursOfSnow": 0.0,
        "HoursOfIce": 0.0,
        "CloudCover": 0,
        "Evapotranspiration": { "Value": 0.5, "Unit": "mm", "UnitType": 3 },
        "SolarIrradiance": { "Value": 0.0, "Unit": "W/m²", "UnitType": 33 }
      },
      "Sources": ["中国天气通"],
      "MobileLink": "http://m.weathercn.com/...",
      "Link": "http://www.weathercn.com/..."
    },
    // ... 中间省略 3 条逐日预报数据 (Day 2-4) ...
    {
      "Date": "2026-03-14T08:00:00+08:00",
      "EpochDate": 1773446400,
      "Sun": {
        "Rise": "2026-03-14T06:29:00+08:00",
        "EpochRise": 1773440940,
        "Set": "2026-03-14T18:19:00+08:00",
        "EpochSet": 1773483540
      },
      "Moon": {
        "Rise": "2026-03-14T03:54:21+08:00",
        "EpochRise": 1773431661,
        "Set": "2026-03-14T13:05:12+08:00",
        "EpochSet": 1773464712,
        "Phase": "WaningCrescent",
        "Age": 25
      },
      "Temperature": {
        "Minimum": { "Value": -1.0, "Unit": "C", "UnitType": 17 },
        "Maximum": { "Value": 10.0, "Unit": "C", "UnitType": 17 }
      },
      "RealFeelTemperature": {
        "Minimum": { "Value": -0.5, "Unit": "C", "UnitType": 17 },
        "Maximum": { "Value": 12.0, "Unit": "C", "UnitType": 17 }
      },
      "RealFeelTemperatureShade": {
        "Minimum": { "Value": -0.5, "Unit": "C", "UnitType": 17 },
        "Maximum": { "Value": 11.4, "Unit": "C", "UnitType": 17 }
      },
      "HoursOfSun": 1.0,
      "DegreeDaySummary": {
        "Heating": { "Value": 12.0, "Unit": "C", "UnitType": 17 },
        "Cooling": { "Value": 0.0, "Unit": "C", "UnitType": 17 }
      },
      "AirAndPollen": [
        { "Name": "AirQuality", "Value": 30, "Category": "优", "CategoryValue": 1, "Type": "臭氧" },
        { "Name": "UVIndex", "Value": 2, "Category": "很弱", "CategoryValue": 1 }
      ],
      "Day": {
        "Icon": 7,
        "IconPhrase": "多云",
        "ShortPhrase": "多云",
        "LongPhrase": "多云",
        "LocalSource": {
          "Id": 7,
          "Name": "Huafeng",
          "WeatherCode": "01",
          "WindLevelCode": "0",
          "WindDirectionCode": "8",
          "PubName": "中央气象台",
          "PubTime": "2026-03-10T08:00:00+08:00",
          "EpochPubTime": 1773100800
        },
        "HasPrecipitation": false,
        "PrecipitationProbability": 3,
        "ThunderstormProbability": 0,
        "RainProbability": 3,
        "SnowProbability": 0,
        "IceProbability": 0,
        "Wind": {
          "Speed": { "Value": 3.2, "Unit": "km/h", "UnitType": 7 },
          "Direction": { "Degrees": 0, "Localized": "北", "English": "N" }
        },
        "WindGust": {
          "Speed": { "Value": 18.5, "Unit": "km/h", "UnitType": 7 },
          "Direction": { "Degrees": 72, "Localized": "东北偏东", "English": "ENE" }
        },
        "TotalLiquid": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Rain": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Snow": { "Value": 0.0, "Unit": "cm", "UnitType": 4 },
        "Ice": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "HoursOfPrecipitation": 0.0,
        "HoursOfRain": 0.0,
        "HoursOfSnow": 0.0,
        "HoursOfIce": 0.0,
        "CloudCover": 97,
        "Evapotranspiration": { "Value": 2.0, "Unit": "mm", "UnitType": 3 },
        "SolarIrradiance": { "Value": 408.4, "Unit": "W/m²", "UnitType": 33 }
      },
      "Night": {
        "Icon": 33,
        "IconPhrase": "晴",
        "ShortPhrase": "晴",
        "LongPhrase": "晴",
        "LocalSource": {
          "Id": 7,
          "Name": "Huafeng",
          "WeatherCode": "00",
          "WindLevelCode": "0",
          "WindDirectionCode": "8",
          "PubName": "中央气象台",
          "PubTime": "2026-03-10T08:00:00+08:00",
          "EpochPubTime": 1773100800
        },
        "HasPrecipitation": false,
        "PrecipitationProbability": 0,
        "ThunderstormProbability": 0,
        "RainProbability": 0,
        "SnowProbability": 0,
        "IceProbability": 0,
        "Wind": {
          "Speed": { "Value": 3.2, "Unit": "km/h", "UnitType": 7 },
          "Direction": { "Degrees": 0, "Localized": "北", "English": "N" }
        },
        "WindGust": {
          "Speed": { "Value": 24.1, "Unit": "km/h", "UnitType": 7 },
          "Direction": { "Degrees": 200, "Localized": "西南偏南", "English": "SSW" }
        },
        "TotalLiquid": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Rain": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Snow": { "Value": 0.0, "Unit": "cm", "UnitType": 4 },
        "Ice": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "HoursOfPrecipitation": 0.0,
        "HoursOfRain": 0.0,
        "HoursOfSnow": 0.0,
        "HoursOfIce": 0.0,
        "CloudCover": 29,
        "Evapotranspiration": { "Value": 0.5, "Unit": "mm", "UnitType": 3 },
        "SolarIrradiance": { "Value": 0.0, "Unit": "W/m²", "UnitType": 33 }
      },
      "Sources": ["中国天气通"],
      "MobileLink": "http://m.weathercn.com/...",
      "Link": "http://www.weathercn.com/..."
    }
  ]
}
获取 API Key:请先免费注册并完成开发者认证,标准测试 Key 开通 30 天试用,每日 500 次免费调用(5 QPS)。
Location Key:逐日预报依赖定位结果,请先调用 定位搜索 API 获取 Key
安全传参:建议通过 Header 传递密钥 X-Gw-API-Key: YOUR_API_KEY,避免 Key 出现在 URL 日志中。