接口线路类型一[集群IP接口-免费]
[接口地址1] :当前负载【】 接口通讯【正常

复制

测速 

[接口地址2] :当前负载【】 接口通讯【正常

复制

测速 

[接口地址3] :当前负载【】 接口通讯【正常

复制

测速 

说明:直接访问https://api.apihz.cn/getapi.php获取当前最优接口地址,IP接口省去域名解析步骤,速度较快。集群IP接口并非永久有效,且容易遭受攻击,建议定期获取当前最优IP接口地址做容错处理,或直接使用域名接口或彩钻接口。IP直链接口CC防火墙严格。
接口线路类型二[域名接口-免费]
[接口地址] :[自动分发到集群接口服务器,但可能因网络运营商DNS缓存如果某个集群节点发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]

复制

测速 

接口线路类型三[超高稳定-最低24¥/月]
[彩钻接口] :[专属集群+普通集群+备用集群,自动负载均衡,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!CC防火墙宽松。登录后购买。]

复制

测速 

请求示例
[GET]请求示例:(以下为公共KEY,共享每分钟调用频次,请登录后使用自己的KEY独享频次)

复制全部

复制参数 

[POST]请求示例(请根据开发语言自行POST)

请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。
提示:如发现接口有BUG,可加服务QQ群500700444,及时向我们反馈。
提示:请求参数里的开发者ID与KEY,登录后台菜单【个人资料】里查看。
名称 参数 必填 说明
开发者IDid用户中心的数字ID,例:id=10000000
开发者KEYkey用户中心通讯秘钥,例: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
用户IPuip接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻会员和炫钻会员专享。
返回参数说明
名称 参数 说明
状态码code200成功,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": "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%"
    }]
}
更新记录
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-08-24 11:13:05

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

调用限制
单价/次 免费[无上限]
瞬时并发[单IP] 20
单日[所有用户之和] 999999999
1分钟并发[所有用户之和] 999999999
1小时并发[所有用户之和] 999999999
频次限制[注册用户] 10次/分钟|每日无上限
频次限制[钻石会员] 最高+1500次/分钟|每日无上限
频次限制[定制频次] 联系我们定制
调用方法
请求方式 GET/POST
返回格式 JSON
编码格式 UTF-8
调用信息
浏览量 8270
今日总计调用 34868
昨日总计调用 608892
历史总计调用 63649763
今日排名 4
总排名 6
自检信息

自检日志

自检启用状态 已启用
自检节点 上海
自检线路 彩钻接口线路
自检时间 2025-09-04 01:58:46
自检耗时 172 毫秒
自检状态 正常
历史自检成功数 259196 次
历史自检失败数 776 次
历史自检成功率 99.70 %
今日自检成功数 33 次
今日自检失败数 0 次
今日自检成功率 100.00 %