名称	参数	必填	说明
开发者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
日出落时间表	suntimetype	否	是否返回7天日出日落详细时间。0=不返回，1=返回。默认0。例：suntimetype=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天各时段天气。
日出日落时间表数据集	suntimes	7天日出日落详细时间表数据集。
日期	suntimes.date	日期。
格式化日期	suntimes.date_formatted	格式化日期。
星期几英文全	suntimes.weekday	星期几英文全称。
星期几英文缩	suntimes.weekday_short	星期几英文缩写。
星期几中文全	suntimes.weekday_cn	星期几中文全称。
星期几中文缩	suntimes.weekday_short_cn	星期几中文缩写。
民用晨光始	suntimes.civil_twilight_begin	讲人话就是天亮时间。
日出时间	suntimes.sunrise	日出时间。
太阳正午	suntimes.transit	太阳正午。
日落时间	suntimes.sunset	日落时间。
民用昏影终	suntimes.civil_twilight_end	讲人话就是天黑时间。
天文晨光始	suntimes.astronomical_twilight_begin	天文晨光始（太阳中心在地平线下18度），天空开始有微弱光线。
航海晨光始	suntimes.nautical_twilight_begin	航海晨光始（太阳中心在地平线下12度），地平线隐约可见。
航海昏影终	suntimes.nautical_twilight_end	航海昏影终（太阳中心在地平线下12度），地平线不可见。
天文昏影终	suntimes.astronomical_twilight_end	天文昏影终（太阳中心在地平线下18度），完全黑暗。
昼长	suntimes.day_length_seconds	昼长（日出到日落）的秒数。
夜长	suntimes.night_length_seconds	夜长（简化计算：24小时-昼长）的秒数。
精确夜长	suntimes.night_length_accurate_seconds	精确夜长（当天日落到第二天日出）的秒数。
晨光时长	suntimes.twilight_morning_seconds	晨光时长（天亮到日出）的秒数。
昏影时长	suntimes.twilight_evening_seconds	昏影时长（日落到天黑）的秒数。
总天亮时长	suntimes.daylight_duration_seconds	总天亮时长（天亮到天黑）的秒数。
昼长格式化	suntimes.day_length	昼长，格式化。
夜长格式化	suntimes.night_length	夜长格式化。
精确夜长格式化	suntimes.night_length_accurate	精确夜长格式化。
晨光时长格式化	suntimes.twilight_morning	晨光时长格式化。
昏影时长格式化	suntimes.twilight_evening	昏影时长格式化。
总天亮时长格式化	suntimes.daylight_duration	总天亮时长格式化。
昼长百分比	suntimes.day_percentage	昼长百分百。
夜长百分比	suntimes.night_percentage	夜长百分比。

返回数据示例

示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
    "code": 200,
    "guo": "中国",
    "sheng": "云南",
    "shi": "砚山",
    "name": "砚山",
    "weather1": "多云",
    "weather2": "多云",
    "wd1": "27",
    "wd2": "14",
    "winddirection1": "西南风",
    "winddirection2": "无持续风向",
    "windleve1": "3~4级",
    "windleve2": "微风",
    "weather1img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
    "weather2img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
    "lon": "104.340",
    "lat": "23.600",
    "uptime": "2026-03-30 12:00:00",
    "nowinfo": {
        "precipitation": 0,
        "temperature": 28.2,
        "pressure": 837,
        "humidity": 23,
        "windDirection": "西南风",
        "windDirectionDegree": 264,
        "windSpeed": 4.5,
        "windScale": "3级",
        "feelst": 26.3,
        "uptime": "2026/03/30 15:40"
    },
    "alarm": [{
        "id": "53262241600000_20260330123645",
        "title": "砚山县气象台发布大风蓝色预警[Ⅳ级/一般]",
        "signaltype": "大风",
        "signallevel": "蓝色",
        "effective": "2026/03/30 12:37",
        "eventType": "11B06",
        "severity": "BLUE",
        "type": "p0007004"
    }],
    "hourtime": "2026-03-30 15:48:14",
    "hour1": [{
        "时间": "17:00",
        "天气": "多云",
        "图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
        "气温": "26.9℃",
        "降水": "无降水",
        "风速": "6.7m/s",
        "风向": "西南风",
        "气压": "834.9hPa",
        "湿度": "45.8%",
        "云量": "10.5%"
    }, {
        "时间": "20:00",
        "天气": "多云",
        "图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
        "气温": "21.9℃",
        "降水": "无降水",
        "风速": "5.5m/s",
        "风向": "西南风",
        "气压": "836.2hPa",
        "湿度": "56.7%",
        "云量": "10.7%"
    }, {
        "时间": "23:00",
        "天气": "多云",
        "图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
        "气温": "18.9℃",
        "降水": "无降水",
        "风速": "3.3m/s",
        "风向": "西南风",
        "气压": "837.6hPa",
        "湿度": "56.9%",
        "云量": "31.9%"
    }, {
        "时间": "02:00",
        "天气": "多云",
        "图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
        "气温": "16.2℃",
        "降水": "无降水",
        "风速": "2.5m/s",
        "风向": "西南风",
        "气压": "837.2hPa",
        "湿度": "57.3%",
        "云量": "55.5%"
    }, {
        "时间": "05:00",
        "天气": "多云",
        "图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
        "气温": "14.8℃",
        "降水": "无降水",
        "风速": "2.2m/s",
        "风向": "西南风",
        "气压": "836.9hPa",
        "湿度": "77.5%",
        "云量": "10.1%"
    }, {
        "时间": "08:00",
        "天气": "多云",
        "图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
        "气温": "14.8℃",
        "降水": "无降水",
        "风速": "2.9m/s",
        "风向": "西南风",
        "气压": "838.7hPa",
        "湿度": "79.3%",
        "云量": "10.1%"
    }, {
        "时间": "11:00",
        "天气": "多云",
        "图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
        "气温": "23.2℃",
        "降水": "无降水",
        "风速": "3.2m/s",
        "风向": "东北风",
        "气压": "839.5hPa",
        "湿度": "52.8%",
        "云量": "10.1%"
    }, {
        "时间": "14:00",
        "天气": "多云",
        "图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
        "气温": "23.6℃",
        "降水": "无降水",
        "风速": "2.1m/s",
        "风向": "东北风",
        "气压": "837.8hPa",
        "湿度": "55.4%",
        "云量": "33.2%"
    }],
    "suntimes": [{
        "date": "2026-03-30",
        "date_formatted": "2026年03月30日",
        "weekday": "Monday",
        "weekday_short": "Mon",
        "weekday_cn": "星期一",
        "weekday_short_cn": "周一",
        "civil_twilight_begin": "06:34:16",
        "sunrise": "06:56:51",
        "transit": "13:07:10",
        "sunset": "19:17:30",
        "civil_twilight_end": "19:40:05",
        "astronomical_twilight_begin": "05:41:07",
        "nautical_twilight_begin": "06:07:48",
        "nautical_twilight_end": "20:06:33",
        "astronomical_twilight_end": "20:33:14",
        "day_length_seconds": 44439,
        "night_length_seconds": 41902,
        "night_length_accurate_seconds": 41902,
        "twilight_morning_seconds": 1355,
        "twilight_evening_seconds": 1355,
        "daylight_duration_seconds": 47149,
        "day_length": "12:20:39",
        "night_length": "11:38:22",
        "night_length_accurate": "11:38:22",
        "twilight_morning": "00:22:35",
        "twilight_evening": "00:22:35",
        "daylight_duration": "13:05:49",
        "day_percentage": 51.4,
        "night_percentage": 48.5
    }, {
        "date": "2026-03-31",
        "date_formatted": "2026年03月31日",
        "weekday": "Tuesday",
        "weekday_short": "Tue",
        "weekday_cn": "星期二",
        "weekday_short_cn": "周二",
        "civil_twilight_begin": "06:33:16",
        "sunrise": "06:55:52",
        "transit": "13:06:52",
        "sunset": "19:17:53",
        "civil_twilight_end": "19:40:29",
        "astronomical_twilight_begin": "05:40:02",
        "nautical_twilight_begin": "06:06:46",
        "nautical_twilight_end": "20:06:59",
        "astronomical_twilight_end": "20:33:42",
        "day_length_seconds": 44521,
        "night_length_seconds": 41820,
        "night_length_accurate_seconds": 41820,
        "twilight_morning_seconds": 1356,
        "twilight_evening_seconds": 1356,
        "daylight_duration_seconds": 47233,
        "day_length": "12:22:01",
        "night_length": "11:37:00",
        "night_length_accurate": "11:37:00",
        "twilight_morning": "00:22:36",
        "twilight_evening": "00:22:36",
        "daylight_duration": "13:07:13",
        "day_percentage": 51.5,
        "night_percentage": 48.4
    }, {
        "date": "2026-04-01",
        "date_formatted": "2026年04月01日",
        "weekday": "Wednesday",
        "weekday_short": "Wed",
        "weekday_cn": "星期三",
        "weekday_short_cn": "周三",
        "civil_twilight_begin": "06:32:16",
        "sunrise": "06:54:53",
        "transit": "13:06:34",
        "sunset": "19:18:16",
        "civil_twilight_end": "19:40:53",
        "astronomical_twilight_begin": "05:38:58",
        "nautical_twilight_begin": "06:05:44",
        "nautical_twilight_end": "20:07:25",
        "astronomical_twilight_end": "20:34:11",
        "day_length_seconds": 44603,
        "night_length_seconds": 41739,
        "night_length_accurate_seconds": 41739,
        "twilight_morning_seconds": 1357,
        "twilight_evening_seconds": 1357,
        "daylight_duration_seconds": 47317,
        "day_length": "12:23:23",
        "night_length": "11:35:39",
        "night_length_accurate": "11:35:39",
        "twilight_morning": "00:22:37",
        "twilight_evening": "00:22:37",
        "daylight_duration": "13:08:37",
        "day_percentage": 51.6,
        "night_percentage": 48.3
    }, {
        "date": "2026-04-02",
        "date_formatted": "2026年04月02日",
        "weekday": "Thursday",
        "weekday_short": "Thu",
        "weekday_cn": "星期四",
        "weekday_short_cn": "周四",
        "civil_twilight_begin": "06:31:16",
        "sunrise": "06:53:55",
        "transit": "13:06:17",
        "sunset": "19:18:39",
        "civil_twilight_end": "19:41:18",
        "astronomical_twilight_begin": "05:37:54",
        "nautical_twilight_begin": "06:04:43",
        "nautical_twilight_end": "20:07:51",
        "astronomical_twilight_end": "20:34:40",
        "day_length_seconds": 44684,
        "night_length_seconds": 41657,
        "night_length_accurate_seconds": 41657,
        "twilight_morning_seconds": 1359,
        "twilight_evening_seconds": 1359,
        "daylight_duration_seconds": 47402,
        "day_length": "12:24:44",
        "night_length": "11:34:17",
        "night_length_accurate": "11:34:17",
        "twilight_morning": "00:22:39",
        "twilight_evening": "00:22:39",
        "daylight_duration": "13:10:02",
        "day_percentage": 51.7,
        "night_percentage": 48.2
    }, {
        "date": "2026-04-03",
        "date_formatted": "2026年04月03日",
        "weekday": "Friday",
        "weekday_short": "Fri",
        "weekday_cn": "星期五",
        "weekday_short_cn": "周五",
        "civil_twilight_begin": "06:30:16",
        "sunrise": "06:52:56",
        "transit": "13:05:59",
        "sunset": "19:19:02",
        "civil_twilight_end": "19:41:42",
        "astronomical_twilight_begin": "05:36:49",
        "nautical_twilight_begin": "06:03:41",
        "nautical_twilight_end": "20:08:17",
        "astronomical_twilight_end": "20:35:09",
        "day_length_seconds": 44766,
        "night_length_seconds": 41576,
        "night_length_accurate_seconds": 41576,
        "twilight_morning_seconds": 1360,
        "twilight_evening_seconds": 1360,
        "daylight_duration_seconds": 47486,
        "day_length": "12:26:06",
        "night_length": "11:32:56",
        "night_length_accurate": "11:32:56",
        "twilight_morning": "00:22:40",
        "twilight_evening": "00:22:40",
        "daylight_duration": "13:11:26",
        "day_percentage": 51.8,
        "night_percentage": 48.1
    }, {
        "date": "2026-04-04",
        "date_formatted": "2026年04月04日",
        "weekday": "Saturday",
        "weekday_short": "Sat",
        "weekday_cn": "星期六",
        "weekday_short_cn": "周六",
        "civil_twilight_begin": "06:29:17",
        "sunrise": "06:51:58",
        "transit": "13:05:42",
        "sunset": "19:19:25",
        "civil_twilight_end": "19:42:06",
        "astronomical_twilight_begin": "05:35:45",
        "nautical_twilight_begin": "06:02:39",
        "nautical_twilight_end": "20:08:44",
        "astronomical_twilight_end": "20:35:39",
        "day_length_seconds": 44847,
        "night_length_seconds": 41495,
        "night_length_accurate_seconds": 41495,
        "twilight_morning_seconds": 1361,
        "twilight_evening_seconds": 1361,
        "daylight_duration_seconds": 47569,
        "day_length": "12:27:27",
        "night_length": "11:31:35",
        "night_length_accurate": "11:31:35",
        "twilight_morning": "00:22:41",
        "twilight_evening": "00:22:41",
        "daylight_duration": "13:12:49",
        "day_percentage": 51.9,
        "night_percentage": 48
    }, {
        "date": "2026-04-05",
        "date_formatted": "2026年04月05日",
        "weekday": "Sunday",
        "weekday_short": "Sun",
        "weekday_cn": "星期日",
        "weekday_short_cn": "周日",
        "civil_twilight_begin": "06:28:18",
        "sunrise": "06:51:00",
        "transit": "13:05:24",
        "sunset": "19:19:48",
        "civil_twilight_end": "19:42:31",
        "astronomical_twilight_begin": "05:34:40",
        "nautical_twilight_begin": "06:01:38",
        "nautical_twilight_end": "20:09:11",
        "astronomical_twilight_end": "20:36:08",
        "day_length_seconds": 44928,
        "night_length_seconds": 41472,
        "night_length_accurate_seconds": 0,
        "twilight_morning_seconds": 1362,
        "twilight_evening_seconds": 1363,
        "daylight_duration_seconds": 47653,
        "day_length": "12:28:48",
        "night_length": "11:31:12",
        "night_length_accurate": "N/A",
        "twilight_morning": "00:22:42",
        "twilight_evening": "00:22:43",
        "daylight_duration": "13:14:13",
        "day_percentage": 52,
        "night_percentage": 48
    }]
}

更新记录

2026-03-30 15:53:41 - 更新返回字段【alarm】，能存在多个对象，请遍历。

2026-02-12 21:23:19 - 新增返回字段：日出日落时间表数据集，含民用晨光始，日出时间，太阳正午，日落时间，民用昏影终，天文晨光始，航海晨光始，航海昏影终，天文昏影终，昼长，夜长，总天亮时长，昼长百分比，夜长百分比等字段。

2025-11-23 23:47:26 - 修复个别城市查询失败的BUG。

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天-中国气象局-地址查询版-2026-03-30 15:56:49

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

调用限制

调用权限	非定制接口直接使用
单价/次	免费[无上限]
单日[所有用户之和]	999999999
1分钟并发[所有用户之和]	999999999
1小时并发[所有用户之和]	999999999
频次限制[注册用户]	10次/分钟\|每日无上限
频次限制[钻石会员]	最高8000+次/分钟\|每日无上限
频次限制[定制频次]	联系我们定制

调用方法

请求方式	GET/POST
返回格式	JSON
编码格式	UTF-8

调用信息

浏览量	16484
今日总计调用	188201
昨日总计调用	247268
历史总计调用	142293673
今日排名	4
总排名	6

自检信息

自检日志

自检启用状态	已启用
自检节点	上海
自检线路	彩钻接口线路
自检时间	2026-04-01 18:04:40
自检耗时	25 毫秒
自检状态	正常
历史自检成功数	334026 次
历史自检失败数	792 次
历史自检成功率	99.76 %
今日自检成功数	275 次
今日自检失败数	0 次
今日自检成功率	100.00 %