接口简介：

根据地址获取指定地区1-7日天气信息，来源于中国气象局官方数据。可查询地区列表可调用接口【天气预报-天气预报1-7天-中国气象局-地址列表】https://www.apihz.cn/api/tianqitqyblist.html



请求地址：

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



请求方式：

POST或GET。



请求参数：

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

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

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

【省份名称】【sheng】【否】【一级行政区，要查询的省份名称，直辖市也为一级行政区。可查询地区列表可调用接口【天气预报-天气预报1-7天-中国气象局-地址列表】https://www.apihz.cn/api/tianqitqyblist.html。例：sheng=北京，sheng=北京市，sheng=四川省，sheng=四川】

【地点】【place】【是】【要查询的地点，一般为市级名称或该市下的某地点名称。某些直辖市可查区级。可查询地点列表可调用接口【天气预报-天气预报1-7天-中国气象局-地址列表】https://www.apihz.cn/api/tianqitqyblist.html。例：place=大兴区，place=大兴，place=上海，place=重庆，place=广州，place=深圳】

【查询天数】【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/tqyb.php?id=88888888&key=88888888&sheng=四川&place=绵阳&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": "23",

"winddirection1": "东北风",

"winddirection2": "东北风",

"windleve1": "3~4级",

"windleve2": "微风",

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

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

"lon": "118.180",

"lat": "29.790",

"uptime": "2025-09-24 13:00:48",

"nowinfo": {

"precipitation": 0,

"temperature": 29.7,

"pressure": 989,

"humidity": 72,

"windDirection": "东北风",

"windDirectionDegree": 58,

"windSpeed": 3.9,

"windScale": "3级",

"feelst": 32.5,

"uptime": "2025/09/24 13:35"

},

"alarm": null,

"weatherday2": {

"date": "2025/09/25",

"weekday": "星期四",

"monthDay": "09/25",

"weather1": "多云",

"weather2": "多云",

"wd1": 33,

"wd2": 23,

"winddirection1": "东北风",

"winddirection2": "东北风",

"windleve1": "微风",

"windleve2": "微风",

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

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

},

"hourtime": "2025-09-24 13:00:48",

"hour1": [{

"时间": "14:00",

"天气": "小雨",

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

"气温": "26.4℃",

"降水": "2.4mm",

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

"风向": "东北风",

"气压": "966.3hPa",

"湿度": "93%",

"云量": "96.1%"

}, {

"时间": "17:00",

"天气": "中雨",

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

"气温": "24.6℃",

"降水": "3.4mm",

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

"风向": "东北风",

"气压": "966.2hPa",

"湿度": "90.8%",

"云量": "85.8%"

}, {

"时间": "20:00",

"天气": "小雨",

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

"气温": "23.3℃",

"降水": "2.6mm",

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

"风向": "东北风",

"气压": "967.3hPa",

"湿度": "96.7%",

"云量": "98.5%"

}, {

"时间": "23:00",

"天气": "中雨",

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

"气温": "23.8℃",

"降水": "7.1mm",

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

"风向": "东北风",

"气压": "968.8hPa",

"湿度": "96.9%",

"云量": "99.1%"

}, {

"时间": "02:00",

"天气": "小雨",

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

"气温": "24.2℃",

"降水": "2mm",

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

"风向": "东北风",

"气压": "968.9hPa",

"湿度": "97.1%",

"云量": "97.8%"

}, {

"时间": "05:00",

"天气": "小雨",

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

"气温": "24.2℃",

"降水": "0.5mm",

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

"风向": "东北风",

"气压": "968.7hPa",

"湿度": "97.1%",

"云量": "99.1%"

}, {

"时间": "08:00",

"天气": "小雨",

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

"气温": "29.9℃",

"降水": "0.1mm",

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

"风向": "东北风",

"气压": "970.6hPa",

"湿度": "97.1%",

"云量": "99.6%"

}, {

"时间": "11:00",

"天气": "多云",

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

"气温": "31.7℃",

"降水": "无降水",

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

"风向": "东北风",

"气压": "971.1hPa",

"湿度": "59.6%",

"云量": "79.9%"

}],

"hour2": [{

"时间": "08:00",

"天气": "小雨",

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

"气温": "29.9℃",

"降水": "0.1mm",

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

"风向": "东北风",

"气压": "970.6hPa",

"湿度": "97.1%",

"云量": "99.6%"

}, {

"时间": "11:00",

"天气": "多云",

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

"气温": "31.7℃",

"降水": "无降水",

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

"风向": "东北风",

"气压": "971.1hPa",

"湿度": "59.6%",

"云量": "79.9%"

}, {

"时间": "14:00",

"天气": "多云",

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

"气温": "33.3℃",

"降水": "无降水",

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

"风向": "东北风",

"气压": "969.5hPa",

"湿度": "65.2%",

"云量": "79.9%"

}, {

"时间": "17:00",

"天气": "多云",

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

"气温": "29.1℃",

"降水": "无降水",

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

"风向": "东北风",

"气压": "970.2hPa",

"湿度": "72.8%",

"云量": "79.9%"

}, {

"时间": "20:00",

"天气": "多云",

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

"气温": "26.8℃",

"降水": "无降水",

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

"风向": "东北风",

"气压": "971.9hPa",

"湿度": "80.5%",

"云量": "79.9%"

}, {

"时间": "23:00",

"天气": "多云",

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

"气温": "26.2℃",

"降水": "无降水",

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

"风向": "东北风",

"气压": "972.5hPa",

"湿度": "83.9%",

"云量": "79.9%"

}, {

"时间": "02:00",

"天气": "多云",

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

"气温": "23.5℃",

"降水": "无降水",

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

"风向": "东北风",

"气压": "971.9hPa",

"湿度": "93.1%",

"云量": "79.9%"

}, {

"时间": "05:00",

"天气": "多云",

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

"气温": "24.1℃",

"降水": "无降水",

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

"风向": "东北风",

"气压": "972.5hPa",

"湿度": "91.8%",

"云量": "79.9%"

}]

}



参考资料(版权)：

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