WebService API

开发指南

概述

通过行政区划编码、位置经纬度，查询对应城市的实时天气或预报天气。

请求URL

URL：https://apis.map.qq.com/ws/weather/v1/
Method: GET

请求参数

参数	必填	说明	示例
key	是	开发密钥（Key）	key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-*****
adcode	是（二选一）	行政区划代码，可支持市级和区/县级	adcode=130681
location	是（二选一）	位置经纬度，获取坐标所在区县的天气数据	location=39.905023,116.724502
type	否	查询天气类型，取值： now[默认] 实时天气预报 future 未来天气预报（默认获取当天和未来3天的天气信息） hours 未来24小时天气预报（起始时间为当前时间的前一个小时）	type=future
get_md	否	未来预报天数，仅在type=future时生效，取值： 0 [默认]当天加未来3天的天气情况 1 当天加未来6天的天气情况	get_md=1
added_fields	否	附加字段，取值： alarm 预警信息，仅在type=now时生效。 index 生活指数信息，仅在type=future时生效 air 空气质量信息	added_fields=alarm
output	否	返回格式：支持JSON/JSONP，默认JSON	output=json
callback	否	JSONP方式回调函数	callback=function1

响应结果

名称		类型	必有	说明
status		number	是	状态码，0为正常，其它为异常，详细请参阅状态码说明
message		string	是	对status的描述
result		object	是	天气查询结果
	realtime	array of object	是	实时天气信息，type=now时返回，具体参考如下实时天气响应结果
	forecast	array of object	是	预报天气信息，type=future时返回，具体参考如下预报天气响应结果

实时天气响应结果

名称			类型	必有	说明
realtime			array of object	是	实时天气信息
	province		string	是	省份
	city		string	是	市
	district		string	是	区县
	adcode		number	是	区划编码
	update_time		string	是	更新时间
	infos		object	是	天气信息
		weather	string	是	天气描述，如：阴
		temperature	number	是	温度，单位：摄氏度
		wind_direction	string	是	风向描述，如：东北风
		wind_power	string	是	风力描述，如：4-5级
		wind_power_v2	string	是	风力描述，如：4级
		humidity	number	是	湿度，单位：百分比
		air_pressure	number	是	气压，单位：百帕
	alarms		array of object	否	预警信息，设置added_fields=alarms 时返回
		type_name	string	否	预警类型，如：寒潮
		level_name	string	否	预警级别，如：黄色
		title	string	否	预警名称，如：北京市海淀区发布大雾黄色预警
		pub_content	string	否	预警发布内容
	air		object	否	空气质量信息，设置added_fields=air 时返回
		aqi	number	是	空气质量，单位：微克每立方米(μg/m³)
		pm10	number	是	pm10，单位：微克每立方米(μg/m³)
		pm25	number	是	pm2.5，单位：微克每立方米(μg/m³)
		no2	number	是	二氧化氮，单位：微克每立方米(μg/m³)
		o3	number	是	臭氧浓度，单位：微克每立方米(μg/m³)
		so2	number	是	二氧化硫浓度，单位：微克每立方米(μg/m³)
		co	number	是	一氧化碳浓度，单位：微克每立方米(μg/m³)

预报天气响应结果

名称				类型	必有	说明
forecast				array of object	是	预报天气信息
	province			string	是	省份
	city			string	是	市
	district			string	是	区县
	adcode			number	是	区划编码
	update_time			string	是	更新时间
	infos			array of object	是	天气信息
		date		string	是	日期，如：2024-08-16
		week		string	是	星期，如：星期五
		day		object	是	白天天气
			weather	string	是	天气描述，如：阴
			temperature	number	是	温度，单位：摄氏度
			wind_direction	string	是	风向描述，如：东北风
			wind_power	string	是	风力描述，如：4-5级
			humidity	number	是	湿度，单位：百分比
		night		object	是	夜晚天气
			weather	string	是	天气描述，如：阴
			temperature	number	是	温度，单位：摄氏度
			wind_direction	string	是	风向描述，如：东北风
			wind_power	string	是	风力描述，如：4-5级
			humidity	number	是	湿度，单位：百分比
	indexes			array of object	否	生活指数信息，设置added_fields=index 时返回
		index_date		string	否	日期，格式：yyyymmdd，如：20251229 注意：生活指数最多返回4天内容，每天06:35前获取的是前一天、当天和未来两天的生活指数信息；每天06:35及以后，获取的是当天和未来3天的生活指数信息。
		ids		array of object	否	生活指数列表
			name	string	否	生活指数名称
			level	string	否	生活指数说明
			desc	string	否	生活指数描述
	air			array of object	否	空气质量信息，设置added_fields=air 时返回
		air_date		string	否	日期，格式：yyyymmdd，如：20260101 注意：预报空气质量最多获取5天内容，每天08:05前获取的是前一天、当前和未来三天的预报信息；每天08:05及以后，获取的是当天和未来4天的空气质量信息
		aqi		number	否	空气质量，单位：微克每立方米(μg/m³)

24小时预报天气响应结果

名称				类型	必有	说明
forecast_hours				array of object	是	预报天气信息
	province			string	是	省份
	city			string	是	市
	district			string	是	区县
	adcode			number	是	区划编码
	update_time			string	是	更新时间
	infos			array of object	是	天气信息
		hour		string	是	时间，如：2025-09-26 18:05
		info		object	是	白天天气
			weather	string	是	天气描述，如：阴
			temperature	number	是	温度，单位：摄氏度
			wind_direction	string	是	风向描述，如：东北风
			wind_power	string	是	风力描述，如：4-5级

天气描述表

晴天多云阴阵雨雷阵雨雷阵雨伴有冰雹雨夹雪小雨中雨大雨暴雨	大暴雨特大暴雨阵雪阵雪小雪中雪大雪暴雪雾冻雨沙尘暴小到中雨	中到大雨大到暴雨暴雨到大暴雨大暴雨到特大暴雨小到中雪中到大雪大到暴雪浮尘扬沙强沙尘暴浓雾	强浓雾霾中度霾重度霾严重霾大雾特强浓雾无雨雪

风向/风力描述表

风向描述	风力描述（预报/实时天气返回）	风力描述(实时天气wind_power_v2返回)
无持续风向	微风（仅预报天气返回）	无风
东北风	1-2级	1级
东风	2-3级	2级
东南风	3-4级	3级
南风	4-5级	4级
西南风	5-6级	5级
西风	6-7级	6级
西北风	7-8级	7级
北风	8-9级	8级
旋转风	9-10级	9级

调用示例

// GET请求，注意参数值要进行URL编码
https://apis.map.qq.com/ws/weather/v1/?key=[你的key]&adcode=130681&type=future

试试AI总结

不想看文档？直接问AI～

这篇文档对您是否有帮助？

有帮助

没帮助

本页内容