接口简介：

根据经纬度自动判断所属地区查询1-7日天气信息，天气信息来源于中国气象局官方数据。



请求地址：

https://cn.apihz.cn/api/tianqi/tqybjw.php



请求方式：

POST或GET。



请求参数：

【名称】【参数】【必填】【说明】

【用户ID】【id】【是】【用户中心的数字ID，例：id=10000000】

【用户KEY】【key】【是】【用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2】

【经度】【lon】【是】【经度。注意，经纬度会查询距离该坐标最近的地区天气，一般为国内坐标。例：lon=116.294908】

【纬度】【lat】【是】【纬度。注意，经纬度会查询距离该坐标最近的地区天气，一般为国内坐标。例：lat=40.049646】

【查询天数】【day】【否】【可传1到7，代表1到7天内天气预报，默认1。例：day=1】

【时段天气】【hourtype】【否】【是否返回时段天气预报，0=不返回，1=返回。默认0。例：hourtype=1】



返回参数：

【名称】【参数】【说明】

【状态码】【code】【200成功，400错误】

【消息内容】【msg】【如果状态码返回400则msg返回错误信息提示。】

【国家】【guo】【查询地址国家。】

【省级】【sheng】【查询地址省级。如果查询失败，默认查询北京天气。】

【市级】【shi】【查询地址市级或地区。如果查询失败，默认查询北京天气。】

【天气预报地址】【name】【天气预报地址。】

【当日白天天气】【weather1】【当日白天天气。】

【当日夜间天气】【weather2】【当日夜间天气。】

【当日白天温度】【wd1】【当日白天温度。】

【当日夜间温度】【wd2】【当日夜间温度。】

【当日白天风向】【winddirection1】【当日白天风向。】

【当日夜间风向】【winddirection2】【当日夜间风向。】

【当日白天风力等级】【windleve1】【当日白天风力等级。】

【当日夜间风力等级】【windleve2】【当日夜间风力等级。】

【当日白天天气图标】【weather1img】【当日白天天气图标。】

【当日夜间天气图标】【weather2img】【当日夜间天气图标。】

【地区经度】【lon】【地区经度。】

【地区纬度】【lat】【地区纬度。】

【当日天气更新时间】【uptime】【当日天气更新时间。】

【当前天气信息数据集】【nowinfo】【当前天气信息数据集。】

【降水量】【nowinfo.precipitation】【降水量。】

【温度】【nowinfo.temperature】【温度。】

【气压】【nowinfo.pressure】【气压。】

【湿度】【nowinfo.humidity】【湿度。】

【风向】【nowinfo.windDirection】【风向。】

【风向度】【nowinfo.windDirectionDegree】【风向度。】

【风速】【nowinfo.windSpeed】【风速。】

【风级】【nowinfo.windScale】【风级。】

【体感温度】【nowinfo.feelst】【体感温度。】

【当前天气信息更新时间】【nowinfo.uptime】【当前天气信息更新时间。】

【近期预警信息数据集】【alarm】【近期预警信息数据集，如有返回，没有返回null。】

【预警编号】【alarm.id】【预警编号，识别码。】

【预警标题】【alarm.title】【预警标题。】

【预警类别】【alarm.signaltype】【预警天气类别。】

【预警等级】【alarm.signallevel】【预警等级。】

【生效时间】【alarm.effective】【生效时间。】

【事件类型代码】【alarm.eventType】【事件类型代码。】

【预警等级英文】【alarm.severity】【预警等级英文。】

【预警类型代码】【alarm.type】【预警类型代码。】

【第2天天气数据集】【weatherday2】【第2天天气数据集，数据集字段意思参考当日天气字段。】

【第3天天气数据集】【weatherday3】【第3天天气数据集。】

【第4天天气数据集】【weatherday4】【第4天天气数据集。】

【第5天天气数据集】【weatherday5】【第5天天气数据集。】

【第6天天气数据集】【weatherday6】【第6天天气数据集。】

【第7天天气数据集】【weatherday7】【第7天天气数据集。】

【时段预报更新时间】【hourtime】【所有日期各时段天气信息整体更新时间。】

【当日各时段天气数据集】【hour1】【当日各时段天气数据集。】

【第2天各时段天气】【hour2】【第2天各时段天气。】

【第3天各时段天气】【hour3】【第3天各时段天气。】

【第4天各时段天气】【hour4】【第4天各时段天气。】

【第5天各时段天气】【hour5】【第5天各时段天气。】

【第6天各时段天气】【hour6】【第6天各时段天气。】

【第7天各时段天气】【hour7】【第7天各时段天气。】



GET请求示例：

https://cn.apihz.cn/api/tianqi/tqybjw.php?id=88888888&key=88888888&lon=116.294908&lat=40.049646&day=1&hourtype=1

注意：示例里的ID与KEY为公共ID与KEY，共享每分钟调用频次限制，接口本身免费，请使用自己的ID与KEY，独享每分钟调用频次。每日调用无上限。



POST请求示例：

请根据开发语言自行POST。



返回数据示例：

示例：{"code":400,"msg":"通讯秘钥错误。"}

示例：

{

"code": 200,

"guo": "中国",

"sheng": "四川",

"shi": "江油",

"name": "江油",

"weather1": "阵雨",

"weather2": "大雨",

"wd1": "30",

"wd2": "21",

"winddirection1": "无持续风向",

"winddirection2": "无持续风向",

"windleve1": "微风",

"windleve2": "微风",

"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",

"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/dayu.png",

"lon": "104.730",

"lat": "31.800",

"uptime": "2025-08-22 12:00:00",

"nowinfo": {

"precipitation": 0,

"temperature": 27.9,

"pressure": 944,

"humidity": 67,

"windDirection": "东北风",

"windDirectionDegree": 83,

"windSpeed": 4.2,

"windScale": "3级",

"feelst": 29.4,

"uptime": "2025/08/22 13:45"

},

"alarm": {

"id": "51078141600000_20250822091211",

"title": "江油市气象台发布暴雨黄色预警信号[III级/较重]",

"signaltype": "暴雨",

"signallevel": "黄色",

"effective": "2025/08/22 09:12",

"eventType": "11B03",

"severity": "YELLOW",

"type": "p0002003"

},

"weatherday2": {

"date": "2025/08/23",

"weather1": "阵雨",

"weather2": "阵雨",

"wd1": 28,

"wd2": 22,

"winddirection1": "无持续风向",

"winddirection2": "无持续风向",

"windleve1": "微风",

"windleve2": "微风",

"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",

"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png"

},

"hourtime": "2025-08-22 13:01:18",

"hour1": [{

"时间": "14:00",

"天气": "晴",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/qing.png",

"气温": "29.6℃",

"降水": "无降水",

"风速": "3.3m/s",

"风向": "东南风",

"气压": "915.8hPa",

"湿度": "76.2%",

"云量": "7.7%"

}, {

"时间": "17:00",

"天气": "阵雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",

"气温": "30℃",

"降水": "3.8mm",

"风速": "3.3m/s",

"风向": "东南风",

"气压": "914.6hPa",

"湿度": "75.6%",

"云量": "70%"

}, {

"时间": "20:00",

"天气": "阵雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",

"气温": "26.5℃",

"降水": "4.3mm",

"风速": "3.1m/s",

"风向": "东北风",

"气压": "916.2hPa",

"湿度": "82.6%",

"云量": "70%"

}, {

"时间": "23:00",

"天气": "中雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhongyu.png",

"气温": "22.5℃",

"降水": "4.9mm",

"风速": "3.2m/s",

"风向": "西北风",

"气压": "916.9hPa",

"湿度": "89.1%",

"云量": "70%"

}, {

"时间": "02:00",

"天气": "中雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhongyu.png",

"气温": "22.2℃",

"降水": "8.4mm",

"风速": "3.3m/s",

"风向": "西北风",

"气压": "915.8hPa",

"湿度": "95.7%",

"云量": "91.4%"

}, {

"时间": "05:00",

"天气": "中雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhongyu.png",

"气温": "21.9℃",

"降水": "5.4mm",

"风速": "3.3m/s",

"风向": "东北风",

"气压": "915.8hPa",

"湿度": "94.1%",

"云量": "100%"

}, {

"时间": "08:00",

"天气": "中雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhongyu.png",

"气温": "21.8℃",

"降水": "6.2mm",

"风速": "3.1m/s",

"风向": "西北风",

"气压": "917.2hPa",

"湿度": "73.6%",

"云量": "96.7%"

}, {

"时间": "11:00",

"天气": "阵雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",

"气温": "24.2℃",

"降水": "8.7mm",

"风速": "3.3m/s",

"风向": "东北风",

"气压": "917.3hPa",

"湿度": "79.7%",

"云量": "91.5%"

}],

"hour2": [{

"时间": "08:00",

"天气": "中雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhongyu.png",

"气温": "21.8℃",

"降水": "6.2mm",

"风速": "3.1m/s",

"风向": "西北风",

"气压": "917.2hPa",

"湿度": "73.6%",

"云量": "96.7%"

}, {

"时间": "11:00",

"天气": "阵雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",

"气温": "24.2℃",

"降水": "8.7mm",

"风速": "3.3m/s",

"风向": "东北风",

"气压": "917.3hPa",

"湿度": "79.7%",

"云量": "91.5%"

}, {

"时间": "14:00",

"天气": "阵雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",

"气温": "28.2℃",

"降水": "3mm",

"风速": "2.9m/s",

"风向": "东北风",

"气压": "916.9hPa",

"湿度": "88.5%",

"云量": "100%"

}, {

"时间": "17:00",

"天气": "阵雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",

"气温": "28.6℃",

"降水": "2.7mm",

"风速": "3.2m/s",

"风向": "东南风",

"气压": "915.9hPa",

"湿度": "86.9%",

"云量": "100%"

}, {

"时间": "20:00",

"天气": "阵雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",

"气温": "27.9℃",

"降水": "4mm",

"风速": "2.6m/s",

"风向": "西北风",

"气压": "917.3hPa",

"湿度": "89.9%",

"云量": "85.9%"

}, {

"时间": "23:00",

"天气": "阵雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",

"气温": "24.5℃",

"降水": "0.1mm",

"风速": "3.2m/s",

"风向": "西南风",

"气压": "918.5hPa",

"湿度": "94.3%",

"云量": "97.3%"

}, {

"时间": "02:00",

"天气": "多云",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",

"气温": "23.6℃",

"降水": "无降水",

"风速": "3.3m/s",

"风向": "西北风",

"气压": "917.6hPa",

"湿度": "95.3%",

"云量": "69.5%"

}, {

"时间": "05:00",

"天气": "阵雨",

"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",

"气温": "23.1℃",

"降水": "2mm",

"风速": "3.1m/s",

"风向": "东北风",

"气压": "917.5hPa",

"湿度": "97.2%",

"云量": "85.1%"

}]

}



参考资料(版权)：

https://www.apihz.cn/api/tianqitqybjw.html