文档
测试

获取天气信息

POST
GetWeatherInfo

接口描述

获取天气信息

请求参数

参数名
类型
描述
必填
dataJson
object
数据参数
必填
key
string
秘钥:29c0b6ed48d52c76122cc003fd79383c
必填
lon
string
经度 示例:113.54 注:中国大陆地区应使用GCJ-02坐标系,在其他地区应使用WGS-84坐标系。
必填
lat
string
纬度 示例:22.28 注:中国大陆地区应使用GCJ-02坐标系,在其他地区应使用WGS-84坐标系。
必填

响应参数

参数名
类型
描述
必填
data
object
数据字典
必填
obsTime
string
观测时间 示例:2026-07-21T21:02+08:00
必填
temp
string
温度,默认单位:摄氏度 示例:27
必填
feelsLike
string
体感温度,默认单位:摄氏度 示例:31
必填
icon
string
天气状况的图标代码(https://icons.qweather.com/) 示例:151
必填
text
string
天气状况的文字描述,包括阴晴雨雪等天气状态的描述 示例:多云
必填
wind360
string
风向360角度 示例:90
必填
windDir
string
风向 示例:东风
必填
windScale
string
风力等级 示例:2
必填
windSpeed
string
风速,公里/小时 示例:8
必填
humidity
string
相对湿度,百分比数值 示例:93
必填
precip
string
降水量,默认单位:毫米 示例:0.0
必填
pressure
string
站点气压,默认单位:百帕 示例:1001
必填
vis
string
能见度,默认单位:公里 示例:13
必填
cloud
string
云量,百分比数值 示例:91
必填
dew
string
露点温度 示例:25
必填
date
string
当前日期(年月日)示例:2026年07月21日
必填
mmHH
string
当前日期(月日) 示例:07月21日
必填
date_time
string
当前时间 示例:2026年07月21日 21时05分04秒
必填
ret
int
示例:0
必填
err_code
int
示例:0
必填
msg
string
示例:ok
必填

说明 / 示例

## 接口地址 ## 成功返回示例 ```language { "data": { "obsTime": "2026-07-21T21:02+08:00", "temp": "27", "feelsLike": "31", "icon": "151", "text": "多云", "wind360": "90", "windDir": "东风", "windScale": "2", "windSpeed": "8", "humidity": "93", "precip": "0.0", "pressure": "1001", "vis": "13", "cloud": "91", "dew": "25", "date": "2026年07月21日", "mmHH": "07月21日", "date_time": "2026年07月21日 21时05分04秒" }, "ret": 0, "err_code": 0, "msg": "ok" } ``` >i 注:ret = 0 为成功 ## 失败返回示例 ```language { "ret": 4, "msg": "参数不能为空", "err_code": 10008 } ``` >d 注:ret > 0 为失败 ## 错误编号(errCode):