实况天气 API

currentconditions/v1 实时实况接口：温度、湿度、风力、天气现象与体感温度，需 Location Key，支持 details=true 与公制/英制。

产品概述

华风爱科实况天气 API 提供全球地点的实时气象数据，分为标准能力与进阶能力。调用前需通过定位搜索 API 获取 Location Key。标准能力返回当前温度、天气状况、风力、体感温度等；进阶能力支持查询过去 6 小时（逐小时）或 24 小时的实况历史记录。由中国气象局授权品牌与 AccuWeather 全球数据能力提供支撑。

✓标准能力： /currentconditions/v1/{locationkey}.json 获取当前实况
✓进阶能力：历史路径 historical / historical/24 查询过往实况
✓完整字段： details=true 返回 RealFeel、UV、降水摘要等扩展要素
✓单位兼容：温度/风速等同时提供 Metric（公制）与 Imperial（英制）

产品展示

通过当前天气API可以构建的应用示例

Web/PC

PC端天气网站

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

响应式布局实时更新多维度展示

iOS/Android 华风爱科 currentconditions 实况天气移动端 APP 示例

移动端APP

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

触控优化极速加载推送通知

Widget

桌面小组件

简洁直观的桌面天气小组件，快速浏览当前核心气象指标，提供沉浸式的使用体验

轻量化实时刷新系统原生

Car System 车载系统实况天气与驾驶安全辅助界面示例

车载系统展示图

专为车载智能终端优化的实时天气界面，提供实时天气预警与安全驾驶辅助

精准实时车载适配安全辅助

快速开始

免费注册并完成开发者认证，获取 API Key（标准测试 Key 开通 30 天试用，每日 500 次免费调用，5 QPS）。
通过定位搜索 API 获取目标地点的 Location Key（示例：101924 北京）。
请求 GET /currentconditions/v1/{locationkey}.json，建议携带 language=zh-cn 与 details=true 获取完整实况字段。

标准能力接口

GET 调取当前实况天气数据

https://openapi.weathercn.com/currentconditions/v1/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true

进阶能力接口

⚠️ 进阶接口（历史实况）需单独申请开通权限。标准测试 Key 无法调用，会返回 401/403。如需开通，请注册账号后联系商务咨询，或在开发者后台提交权限申请。

GET 调取过往实况（前6小时） 进阶

https://openapi.weathercn.com/currentconditions/v1/101924/historical.json?apikey=YOUR_API_KEY&language=zh-cn&details=true

GET 调取过往实况（前24小时） 进阶

https://openapi.weathercn.com/currentconditions/v1/101924/historical/24.json?apikey=YOUR_API_KEY&language=zh-cn&details=true

请求参数

URL 路径中的 {locationkey} 为定位 API 返回的 Location Key；下表为查询参数。进阶历史接口路径不同（historical / historical/24），查询参数与标准能力一致。

参数名	类型	必填	默认值	说明	示例
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

返回字段

参数	类型	说明	数据形式示例
LocalObservationDateTime	String	本地观测时间（ISO 8601格式）	2026-07-27T13:48:09+08:00
EpochTime	Int	观测时间的 UNIX 时间戳	1785131289
WeatherIcon	Int	天气图标编号	7
WeatherText	String	天气状况描述文本	多云
HasPrecipitation	Boolean	是否有降水	false
PrecipitationType	String	降水类型（雨/雪/冰等）	null
LocalSource ▶	Object	本地数据源信息 6 个子字段	-
└─ Id	Int	源 ID	7
└─ Name	String	源名称	Huafeng
└─ WeatherCode	String	天气代码	01
└─ WindLevel	Int	风力等级	4
└─ WindDirectionCode	String	风向代码	5
└─ Temperature	String	温度字符串	32.0
IsDayTime	Boolean	是否为白天	true
Temperature ▶	Object	温度 2 个子字段	-
└─ Metric ▶	Object	公制 2 个子字段	-
└─ Value	Float	数值	32
└─ Unit	String	单位	C
└─ Imperial ▶	Object	英制 2 个子字段	-
└─ Value	Float	数值	89.6
└─ Unit	String	单位	F
RelativeHumidity	Int	相对湿度（%）	57
MobileLink	String	移动端链接	http://m.weathercn.com/zh/cn/beijing/101924/current-weather/101924?lang=zh-cn
Link	String	网页端链接	http://m.weathercn.com/zh/cn/beijing/101924/current-weather/101924?lang=zh-cn
RealFeelTemperature ▶	Object	体感温度 2 个子字段	-
└─ Metric ▶	Object	公制 2 个子字段	-
└─ Value	Float	数值	37.1
└─ Unit	String	单位	C
└─ Imperial ▶	Object	英制 2 个子字段	-
└─ Value	Float	数值	98.8
└─ Unit	String	单位	F
Wind ▶	Object	风力信息 2 个子字段	-
└─ Direction ▶	Object	风向 3 个子字段	-
└─ Degrees	Int	角度	225
└─ Localized	String	本地化方向	西南
└─ English	String	英文方向	SW
└─ Speed ▶	Object	风速 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	23.4
└─ Unit	String	单位	km/h
└─ UnitType	Int	单位类型	7
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	14.5
└─ Unit	String	单位	mi/h
└─ UnitType	Int	单位类型	9
WindGust ▶	Object	阵风信息 1 个子字段	-
└─ Speed ▶	Object	阵风风速 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	23.4
└─ Unit	String	单位	km/h
└─ UnitType	Int	单位类型	7
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	14.5
└─ Unit	String	单位	mi/h
└─ UnitType	Int	单位类型	9
PrecipitationSummary ▶	Object	降水总结 8 个子字段	-
└─ Precipitation ▶	Object	当前降水 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	0
└─ Unit	String	单位	mm
└─ UnitType	Int	单位类型	3
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	0
└─ Unit	String	单位	in
└─ UnitType	Int	单位类型	1
└─ PastHour ▶	Object	过去1小时 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	0
└─ Unit	String	单位	mm
└─ UnitType	Int	单位类型	3
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	0
└─ Unit	String	单位	in
└─ UnitType	Int	单位类型	1
└─ Past3Hours ▶	Object	过去3小时 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	0
└─ Unit	String	单位	mm
└─ UnitType	Int	单位类型	3
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	0
└─ Unit	String	单位	in
└─ UnitType	Int	单位类型	1
└─ Past6Hours ▶	Object	过去6小时 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	1.7
└─ Unit	String	单位	mm
└─ UnitType	Int	单位类型	3
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	0.06
└─ Unit	String	单位	in
└─ UnitType	Int	单位类型	1
└─ Past9Hours ▶	Object	过去9小时 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	2.7
└─ Unit	String	单位	mm
└─ UnitType	Int	单位类型	3
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	0.1
└─ Unit	String	单位	in
└─ UnitType	Int	单位类型	1
└─ Past12Hours ▶	Object	过去12小时 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	2.7
└─ Unit	String	单位	mm
└─ UnitType	Int	单位类型	3
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	0.1
└─ Unit	String	单位	in
└─ UnitType	Int	单位类型	1
└─ Past18Hours ▶	Object	过去18小时 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	3.8
└─ Unit	String	单位	mm
└─ UnitType	Int	单位类型	3
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	0.15
└─ Unit	String	单位	in
└─ UnitType	Int	单位类型	1
└─ Past24Hours ▶	Object	过去24小时 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	3.8
└─ Unit	String	单位	mm
└─ UnitType	Int	单位类型	3
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	0.15
└─ Unit	String	单位	in
└─ UnitType	Int	单位类型	1
TemperatureSummary ▶	Object	温度总结 3 个子字段	-
└─ Past6HourRange ▶	Object	过去6小时范围 2 个子字段	-
└─ Minimum ▶	Object	最低 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	26.4
└─ Unit	String	单位	C
└─ UnitType	Int	单位类型	17
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	79
└─ Unit	String	单位	F
└─ UnitType	Int	单位类型	18
└─ Maximum ▶	Object	最高 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	32.3
└─ Unit	String	单位	C
└─ UnitType	Int	单位类型	17
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	90
└─ Unit	String	单位	F
└─ UnitType	Int	单位类型	18
└─ Past12HourRange ▶	Object	过去12小时范围 2 个子字段	-
└─ Minimum ▶	Object	最低 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	23.5
└─ Unit	String	单位	C
└─ UnitType	Int	单位类型	17
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	74
└─ Unit	String	单位	F
└─ UnitType	Int	单位类型	18
└─ Maximum ▶	Object	最高 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	32.3
└─ Unit	String	单位	C
└─ UnitType	Int	单位类型	17
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	90
└─ Unit	String	单位	F
└─ UnitType	Int	单位类型	18
└─ Past24HourRange ▶	Object	过去24小时范围 2 个子字段	-
└─ Minimum ▶	Object	最低 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	23.5
└─ Unit	String	单位	C
└─ UnitType	Int	单位类型	17
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	74
└─ Unit	String	单位	F
└─ UnitType	Int	单位类型	18
└─ Maximum ▶	Object	最高 2 个子字段	-
└─ Metric ▶	Object	公制 3 个子字段	-
└─ Value	Float	数值	32.9
└─ Unit	String	单位	C
└─ UnitType	Int	单位类型	17
└─ Imperial ▶	Object	英制 3 个子字段	-
└─ Value	Float	数值	91
└─ Unit	String	单位	F
└─ UnitType	Int	单位类型	18

>_ 代码示例

Request

# 调取当前实况天气数据（标准能力）
curl "https://openapi.weathercn.com/currentconditions/v1/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true"

// 调取当前实况天气数据（标准能力）
fetch('https://openapi.weathercn.com/currentconditions/v1/101924.json?apikey=YOUR_API_KEY&language=zh-cn&details=true')
  .then(response => response.json())
  .then(data => console.log(data));

import requests

# 调取当前实况天气数据（标准能力）
url = "https://openapi.weathercn.com/currentconditions/v1/101924.json"
params = {'apikey': 'YOUR_API_KEY', 'language': 'zh-cn', 'details': 'true'}
response = requests.get(url, params=params)
print(response.json())

// 调取当前实况天气数据（标准能力）
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://openapi.weathercn.com/currentconditions/v1/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
// 调取当前实况天气数据（标准能力）
$url = 'https://openapi.weathercn.com/currentconditions/v1/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/currentconditions/v1/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/currentconditions/v1/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/currentconditions/v1/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()

                Response
                
              

                [
  {
    "LocalObservationDateTime": "2026-03-10T10:50:09+08:00",
    "EpochTime": 1773111009,
    "WeatherIcon": 7,
    "WeatherText": "多云",
    "HasPrecipitation": false,
    "PrecipitationType": null,
    "LocalSource": {
      "Id": 7,
      "Name": "Huafeng",
      "WeatherCode": "01",
      "WindLevel": 2,
      "WindDirectionCode": "4",
      "WindGustDirectionCode": "4",
      "Temperature": "6.0"
    },
    "IsDayTime": true,
    "Temperature": {
      "Metric": { "Value": 6.0, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 42.8, "Unit": "F", "UnitType": 18 }
    },
    "RelativeHumidity": 39,
    "MobileLink": "http://m.weathercn.com/zh/cn/beijing/101924/current-weather/101924?lang=zh-cn",
    "Link": "http://m.weathercn.com/zh/cn/beijing/101924/current-weather/101924?lang=zh-cn",
    "RealFeelTemperature": {
      "Metric": { "Value": 3.3, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 37.9, "Unit": "F", "UnitType": 18 }
    },
    "RealFeelTemperatureShade": {
      "Metric": { "Value": 1.3, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 34.3, "Unit": "F", "UnitType": 18 }
    },
    "IndoorRelativeHumidity": 33,
    "DewPoint": {
      "Metric": { "Value": -4.9, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 23.0, "Unit": "F", "UnitType": 18 }
    },
    "Wind": {
      "Direction": { "Degrees": 180, "Localized": "南", "English": "S" },
      "Speed": {
        "Metric": { "Value": 10.4, "Unit": "km/h", "UnitType": 7 },
        "Imperial": { "Value": 6.5, "Unit": "mi/h", "UnitType": 9 }
      }
    },
    "WindGust": {
      "Speed": {
        "Metric": { "Value": 10.4, "Unit": "km/h", "UnitType": 7 },
        "Imperial": { "Value": 6.5, "Unit": "mi/h", "UnitType": 9 }
      }
    },
    "UVIndex": 3,
    "UVIndexText": "弱",
    "Visibility": {
      "Metric": { "Value": 11.4, "Unit": "km", "UnitType": 6 },
      "Imperial": { "Value": 7.1, "Unit": "mi", "UnitType": 2 }
    },
    "ObstructionsToVisibility": "",
    "CloudCover": 10,
    "Ceiling": {
      "Metric": { "Value": 8961.0, "Unit": "m", "UnitType": 5 },
      "Imperial": { "Value": 29400.0, "Unit": "ft", "UnitType": 0 }
    },
    "Pressure": {
      "Metric": { "Value": 1017.0, "Unit": "mb", "UnitType": 14 },
      "Imperial": { "Value": 30.03, "Unit": "inHg", "UnitType": 12 }
    },
    "PressureTendency": { "LocalizedText": "下降", "Code": "F" },
    "Past24HourTemperatureDeparture": {
      "Metric": { "Value": -1.7, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": -3.0, "Unit": "F", "UnitType": 18 }
    },
    "ApparentTemperature": {
      "Metric": { "Value": 5.0, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 41.0, "Unit": "F", "UnitType": 18 }
    },
    "WindChillTemperature": {
      "Metric": { "Value": 1.7, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 35.0, "Unit": "F", "UnitType": 18 }
    },
    "WetBulbTemperature": {
      "Metric": { "Value": 0.8, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 33.0, "Unit": "F", "UnitType": 18 }
    },
    "Precip1hr": {
      "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
      "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 }
    },
    "PrecipitationSummary": {
      "Precipitation": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "PastHour": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "Past3Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "Past6Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "Past9Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "Past12Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "Past18Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "Past24Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }
    },
    "TemperatureSummary": {
      "Past6HourRange": {
        "Minimum": { "Metric": { "Value": -0.9, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 30.0, "Unit": "F", "UnitType": 18 } },
        "Maximum": { "Metric": { "Value": 4.2, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 40.0, "Unit": "F", "UnitType": 18 } }
      },
      "Past12HourRange": {
        "Minimum": { "Metric": { "Value": -0.9, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 30.0, "Unit": "F", "UnitType": 18 } },
        "Maximum": { "Metric": { "Value": 6.9, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 45.0, "Unit": "F", "UnitType": 18 } }
      },
      "Past24HourRange": {
        "Minimum": { "Metric": { "Value": -0.9, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 30.0, "Unit": "F", "UnitType": 18 } },
        "Maximum": { "Metric": { "Value": 12.7, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 55.0, "Unit": "F", "UnitType": 18 } }
      }
    }
  }
]
              

☆

获取 API Key：请先免费注册并完成开发者认证，标准测试 Key 开通 30 天试用，每日 500 次免费调用（5 QPS）。
Location Key：实况接口依赖定位结果，请先调用定位搜索 API 获取 Key。
安全传参：建议通过 Header 传递密钥 X-Gw-API-Key: YOUR_API_KEY，避免 Key 出现在 URL 日志中。