[接口地址]
：[自动分发到集群接口服务器，但可能因网络运营商DNS缓存如果某个集群节点发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]
[彩钻接口]
：[专属集群+普通集群+备用集群，自动负载均衡，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！CC防火墙宽松。登录后购买。]
| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者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 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻会员和炫钻会员专享。 |
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | 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天各时段天气。 |
示例：{"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%"
}]
}
2025-08-24 11:13:05 - 更新部分市级地区查询失败的BUG。2025-08-22 07:23:58 - 调整了当日某些返回字段，同时新增查询未来7天内天气数据参数，新增各时段天气预报参数，重构整体查询流程，双重预缓存，全面提升所有查询速度。2025-07-18 22:03:30 - 新增返回参数weather1img=天气1图标,weather2img=天气2图标,uptime=天气数据更新时间。 天气类型大全：晴,阴,多云,小雨,中雨,大雨,暴雨,阵雨,雷阵雨,小雪,中雪,大雪,暴雪,阵雪,雨夹雪,雷阵雪2025-05-31 14:16:46 - 优化了缓存逻辑，提升了高并发下查询速度。2025-04-25 16:15:22 - 修复缓存造成的温度等元素不正确BUG。2024-09-26 15:52:28 - 修复查询某些地区无天气预报代码报错BUG。2024-09-22 17:20:50 - 地名无需去除后缀，由接口自动处理，如果查询失败请尝试自己去除地名后缀再试。例如四川省去除后缀则为四川，新疆维吾尔族自治区去除后缀则为新疆。2024-09-11 23:49:45 - 优化了缓存逻辑，大大提升了获取速度。2024-06-01 16:14:34 - 采用预缓存技术，大大提高该接口获取中国气象局天气数据速度。2024-05-31 22:33:17 - 新增两个当日天气状态返回参数weather1与weather2，例如晴转多云，则晴代表weather1，多云代表weather2。2024-05-31 21:41:50 - 修复某些城市查询报错BUG。2024-03-25 12:35:32 - 新增接口。
天气预报-天气预报1-7天-中国气象局-地址查询版-2025-09-24 14:10:53根据地址获取指定地区1-7日天气信息，来源于中国气象局官方数据。可查询地区列表可调用接口【天气预报-天气预报1-7天-中国气象局-地址列表】https://www.apihz.cn/api/tianqitqyblist.html
| 单价/次 | 免费[无上限] |
| 瞬时并发[单IP] | 20 |
| 单日[所有用户之和] | 999999999 |
| 1分钟并发[所有用户之和] | 999999999 |
| 1小时并发[所有用户之和] | 999999999 |
| 频次限制[注册用户] | 10次/分钟|每日无上限 |
| 频次限制[钻石会员] | 最高+1500次/分钟|每日无上限 |
| 频次限制[定制频次] | 联系我们定制 |
| 浏览量 | 9645 |
| 今日总计调用 | 91735 |
| 昨日总计调用 | 417162 |
| 历史总计调用 | 77941447 |
| 今日排名 | 3 |
| 总排名 | 6 |
