和风天气API S6版将于2021年12月31日停止技术支持并于2022年12月31日停止服务,请使用最新版本

S6版本API开发文档

适用API版本 维护期 最后编辑
S6 2018年1月1日 至 2021年12月31日 2020年3月20日

请注意,API S6版本将在2021年12月31日停止技术支持,并于2022年12月31日停止服务,请升级到最新版本

自2020年7月6日起,创建的新API应用均无法再使用S6版本

Status Code #

Status 字段是API的状态码,请出错误时请参考这里了解错误原因。

代码 说明
ok 数据正常
invalid key 无效的key,请检查你的key是否输入以及是否输入有误
invalid key type KEY的类型错误(如使用SDK的KEY去访问Web API)。
invalid param 无效的参数,请检查你传递的参数是否正确、完整
bad bind 错误的绑定,绑定的PackageName、BundleID、域名IP地址不一致
no data for this location 该城市/地区没有你所请求的数据
no more requests 超过访问次数,需要等到当月最后一天24点(免费用户为当天24点)后进行访问次数的重置或升级你的访问量
no balance 没有余额,你的按量计费产品由于余额不足或欠费而不能访问,请尽快充值
too fast 超过限定的QPM,请参考QPM说明
dead 无响应或超时,接口服务异常请联系我们
unknown location 没有你查询的这个地区,或者地区名称错误
permission denied 无访问权限,你没有购买你所访问的这部分服务
sign error 签名错误,请参考签名算法

常规天气接口 #

通过常规天气数据API,可以获取到3-10天天气预报、实况天气、逐小时天气预报以及生活指数。

请求URL #

商业版:

https://api.qweather.com/s6/weather/{weather-type}?{parameters}

免费版:

https://free-api.qweather.com/s6/weather/{weather-type}?{parameters}
  • {weather-type} 代表不同的天气数据类型,必选,请使用以下值替代:
weather-type 值 描述 授权
now 实况天气 商业/免费
forecast 3-10天预报 商业/免费
hourly 逐小时预报 商业/免费
lifestyle 生活指数 商业/免费
  • {parameters}代表请求参数,包括必选和可选参数。所有请求参数均使用 &进行分隔,参数值存在中文或特殊字符的情况,需要对参数进行 url encode

请求URL示例

# 获取北京实况天气
https://api.qweather.com/s6/weather/now?location=beijing&key=xxx

请求参数 #

参数 描述 选择 示例值
location 需要查询的城市或地区,可输入以下值:
1. 城市ID:城市列表
2. 经纬度格式:经度,纬度(经度在前纬度在后,英文,分隔,十进制格式,北纬东经为正,南纬西经为负
3. 城市名称,支持中英文和汉语拼音
4. 城市名称,上级城市 或 省 或 国家,英文,分隔,此方式可以在重名的情况下只获取想要的地区的天气数据,例如 西安,陕西
5. IP
6. 根据请求自动判断,根据用户的请求获取IP,通过 IP 定位并获取城市数据
必选 1. location=CN101010100
2. location=116.40,39.9
3. location=北京、 location=北京市、 location=beijing
4. location=朝阳,北京、 location=chaoyang,beijing
5. location=60.194.130.1
6. location=auto_ip
lang 多语言,可以不使用该参数,默认为简体中文,海外城市默认为英文
详见多语言参数
可选 lang=en
unit 单位选择,公制(m)或英制(i),默认为公制单位
详见度量衡单位参数
可选 unit=i
key 用户认证key,请参考如何获取你的KEY
支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx

返回数据说明 #

常规天气数据接口将返回一些基本字段和不同天气类型的字段。

返回的数据中,basicupdatestatus是基本参数,在不同数据类型中都会返回。

具体的天气数据,会根据你请求的{weather-type}不同,将返回不同的天气数据。

basic 基础信息

基础信息包括所查询的城市/地区的一些基本信息,例如名称、ID、经纬度等

参数 描述 示例值
location 地区/城市名称 卓资
cid 地区/城市ID CN101080402
lat 地区/城市纬度 40.89576
lon 地区/城市经度 112.577702
parent_city 该地区/城市的上级城市 乌兰察布
admin_area 该地区/城市所属行政区域 内蒙古
cnty 该地区/城市所属国家名称 中国
tz 该地区/城市所在时区 +8.0

update 接口更新时间

接口更新时间为当前接口的更新时间,包括城市/地区所在地的当地时间和UTC时间,即使其中有个别数据没有变化,update时间也会变更。

参数 描述 示例值
loc 当地时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 12:34
utc UTC时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 04:34

satuts 接口状态

当前接口的状态,正常返回数据会返回ok,若未能返回数据,会给出具体的错误码,不同的错误码请参考接口状态码及错误码

参数 描述 示例值
status 接口状态,具体含义请参考接口状态码及错误码 ok

now实况天气

实况天气即为当前时间点的天气状况以及温湿风压等气象指数,具体包含的数据:体感温度、实测温度、天气状况、风力、风速、风向、相对湿度、大气压强、降水量、能见度等。

参数 描述 示例
fl 体感温度,默认单位:摄氏度 23
tmp 温度,默认单位:摄氏度 21
cond_code 实况天气状况代码 100
cond_txt 实况天气状况描述
wind_deg 风向360角度 305
wind_dir 风向 西北
wind_sc 风力 3-4
wind_spd 风速,公里/小时 15
hum 相对湿度 40
pcpn 降水量 0
pres 大气压强 1020
vis 能见度,默认单位:公里 10
cloud 云量 23

daily_forecast 天气预报

3-10天天气预报数据,天气预报包含的数据:日出日落、月升月落、最高最低温度、天气白天和夜间状况、风力、风速、风向、相对湿度、大气压强、降水量、降水概率、露点温度、紫外线强度、能见度等数据

参数 描述 示例值
date 预报日期 2013-12-30
sr 日出时间 07:36
ss 日落时间 16:58
mr 月升时间 04:47
ms 月落时间 14:59
tmp_max 最高温度 4
tmp_min 最低温度 -5
cond_code_d 白天天气状况代码 100
cond_code_n 夜间天气状况代码 100
cond_txt_d 白天天气状况描述
cond_txt_n 晚间天气状况描述
wind_deg 风向360角度 310
wind_dir 风向 西北风
wind_sc 风力 1-2
wind_spd 风速,公里/小时 14
hum 相对湿度 37
pcpn 降水量 0
pop 降水概率 0
pres 大气压强 1018
uv_index 紫外线强度指数 3
vis 能见度,单位:公里 10

hourly 逐小时预报

未来24-168个小时,逐小时的天气预报数据数据,具体包含的数据:温度、天气状况、风力、风速、风向、相对湿度、大气压强、降水概率等。

参数 描述 示例
time 预报时间,格式yyyy-MM-dd hh:mm 2013-12-30 13:00
tmp 温度 2
cond_code 天气状况代码 101
cond_txt 天气状况描述 多云
wind_deg 风向360角度 290
wind_dir 风向 西北
wind_sc 风力 3-4
wind_spd 风速,公里/小时 15
hum 相对湿度 30
pres 大气压强 1030
pop 降水概率,百分比 30
dew 露点温度 12
cloud 云量 23

lifestyle 生活指数

生活指数和生活指数预报包括:穿衣、洗车、感冒、紫外线、运动、舒适度、旅游、空气污染扩散条件。

目前生活指数仅支持中国地区

参数 描述
brf 生活指数简介
txt 生活指数详细描述
type 生活指数类型 comf:舒适度指数、cw:洗车指数、drsg:穿衣指数、flu:感冒指数、sport:运动指数、trav:旅游指数、uv:紫外线指数、air:空气污染扩散条件指数、ac:空调开启指数、ag:过敏指数、gl:太阳镜指数、mu:化妆指数、airc:晾晒指数、ptfc:交通指数、fsh:钓鱼指数、spi:防晒指数

lifestyle_forecast 生活指数预报

生活指数预报提供最长未来3天的预报数据,包括:穿衣、洗车、感冒、紫外线、运动、舒适度、旅游、空气污染扩散条件。

目前生活指数预报仅支持中国地区

参数 描述
date 预报日期,例如2017-12-30
brf 生活指数简介
txt 生活指数详细描述
type 生活指数类型 comf:舒适度指数、cw:洗车指数、drsg:穿衣指数、flu:感冒指数、sport:运动指数、trav:旅游指数、uv:紫外线指数、air:空气污染扩散条件指数、ac:空调开启指数、ag:过敏指数、gl:太阳镜指数、mu:化妆指数、airc:晾晒指数、ptfc:交通指数、fsh:钓鱼指数、spi:防晒指数

1公里格点天气数据 #

由和风天气、中国气象局、清华大学联合研发的我国首个精确到1公里格点的高精度天气实况和预报数据,精确到街道、小区的天气数据,包括:温度、湿度、大气压、天气状况、风力、风向等

请求URL #

商业版:

https://api.qweather.com/s6/weather/{grid-type}?{parameters}

免费版:

https://free-api.qweather.com/s6/weather/{grid-type}?{parameters}
  • {grid-type} 代表不同的天气数据类型,必选,请使用以下值替代:
grid-type 值 描述 授权
grid-now 格点实况天气 商业
grid-forecast 格点3-7天预报 商业/免费
grid-hourly 格点逐小时预报 商业
  • {parameters}代表请求参数,包括必选和可选参数。所有请求参数均使用 &进行分隔,参数值存在中文或特殊字符的情况,需要对参数进行 url encode

请求URL示例

# 获取某一个坐标的格点实况天气
https://api.qweather.com/s6/weather/grid-now?location=116.4,39.9&key=xxx

请求参数 #

参数 描述 选择 示例值
location 需要查询的地区,仅可使用经纬度坐标查询
经纬度格式:经度,纬度(经度在前纬度在后,英文,分隔,十进制格式,北纬东经为正,南纬西经为负
必选 location=116.40,39.9
lang 多语言,可以不使用该参数,默认为简体中文,海外城市默认为英文
详见多语言参数
可选 lang=en
unit 单位选择,公制(m)或英制(i),默认为公制单位
详见度量衡单位参数
可选 unit=i
key 用户认证key,请参考如何获取你的KEY
支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx

返回数据说明 #

格点天气数据接口将返回一些基本字段和不同天气类型的字段:

  • 返回的数据中,basicupdatestatus是基本参数,在不同数据类型中都会返回。
  • 具体的天气数据,会根据你请求的{grid-type}不同,将返回不同的天气数据。

basic 基础信息

参数 描述 示例值
lat 地区/城市纬度 39.956074
lon 地区/城市经度 116.310316
parent_city 该地区/城市的上级城市 北京
admin_area 该地区/城市所属行政区域 北京
cnty 该地区/城市所属国家名称 中国
tz 该地区/城市所在时区 +8.0

update 接口更新时间

参数 描述 示例值
loc 当地时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 12:34
utc UTC时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 04:34

status 接口状态

参数 描述 示例
status 接口状态,具体含义请参考接口状态码及错误码 ok

grid_now 格点实况天气

参数 描述 示例值
tmp 温度 2
cond_code 天气状况代码 101
cond_txt 天气状况代码 多云
wind_dir 风向 西北
wind_sc 风力 1
hum 相对湿度 30
pcpn 1小时降水量 10
pcpn_10m 10分钟降水量 10
pres 大气压强 1030

grid_forecast 格点未来7天预报

参数 描述 示例值
date 预报日期,格式yyyy-MM-dd 2013-12-30
tmp_max 最高温度 4
tmp_min 最低温度 -5
cond_code_d 白天天气状况代码 100
cond_code_n 晚间天气状况代码 100
cond_txt_d 白天天气状况描述
cond_txt_n 晚间天气状况描述
wind_dir_d 白天风向 西北
wind_dir_n 夜间风向 西北
wind_sc_d 白天风力 3-4
wind_sc_n 夜间风力 3-4

grid_hourly 格点逐小时天气预报

参数 描述 示例值
time 预报时间,格式yyyy-MM-dd HH:mm 2013-12-30 13:00
tmp 温度 2
cond_code 天气状况代码 101
cond_txt 天气状况代码 多云
wind_dir 风向 西北
wind_sc 风力 3-4
pcpn 降水量 10

分钟降水数据 #

由中国气象局、清华大学以及和风天气联合研发的我国首个精确到1公里格点的全国分钟级降雨预报数据,为每一分钟的降雨进行预测。

请求URL #

商业版:

https://api.qweather.com/s6/weather/grid-minute?{parameters}

parameters代表请求参数,包括必选和可选参数。所有请求参数均使用&进行分隔,参数值存在中文或特殊字符的情况,需要对参数进行 url encode

请求URL示例

# 获取某一坐标分钟级降水情况:
https://api.qweather.com/s6/weather/grid-minute?location=116.4,39.9&key=xxx

请求参数 #

参数 描述 选择 示例值
location 需要查询的地区,仅可使用经纬度坐标查询
经纬度格式:经度,纬度(经度在前纬度在后,英文,分隔,十进制格式,北纬东经为正,南纬西经为负
必选 location=116.40,39.9
lang 多语言,可以不使用该参数,默认为简体中文,海外城市默认为英文
详见多语言参数
可选 lang=en
unit 单位选择,公制(m)或英制(i),默认为公制单位
详见度量衡单位参数
可选 unit=i
key 用户认证key,请参考如何获取你的KEY
支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx

返回数据说明 #

basic 基础信息

参数 描述 示例值
lat 地区/城市纬度 39.956074
lon 地区/城市经度 116.310316
parent_city 该地区/城市的上级城市 北京
admin_area 该地区/城市所属行政区域 北京
cnty 该地区/城市所属国家名称 中国
tz 该地区/城市所在时区 +8

grid_minute_forecast 临近预报

参数 描述 示例值
date 预报日期,格式yyyy-MM-dd HH:mm 2013-12-30 20:35
txt 分钟降雨描述 未来2小时无降雨

pcpn_5m 未来两小时5分钟降水量

参数 描述 示例值
time 时间,格式yyyy-MM-dd HH:mm 2013-12-30 20:35
pcpn 降水量 10

pcpn_type降水类型

参数 描述 示例
pcpn_type 降水类型,rain雨,snow雪 rain

update 接口更新时间

参数 描述 示例值
loc 当地时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 12:34
utc UTC时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 04:34

status 接口状态

参数 描述 示例
status 接口状态,具体含义请参考接口状态码及错误码 ok

中国景点天气预报 #

全国4A和5A级景点共2000+的7天天气预报,包括:日出日落时间、最高最低温度、白天和晚间天气状况、风力、风向等。

请求URL #

商业版:

https://api.qweather.com/s6/scenic?{parameters}

parameters代表请求参数,包括必选和可选参数。所有请求参数均使用&进行分隔,参数值存在中文或特殊字符的情况,需要对参数进行 url encode

请求URL示例

# 获取北京天坛公园天气情况:
https://api.qweather.com/s6/scenic?location=CN10101010004A&key=xxx

请求参数 #

参数 描述 选择 示例值
location 景点天气仅支持使用景点ID获取数据
查看全部景点ID
必选 location=CN10101010004A
lang 多语言,可以不使用该参数,默认为简体中文,海外城市默认为英文
详见多语言参数
可选 lang=en
unit 单位选择,公制(m)或英制(i),默认为公制单位
详见度量衡单位参数
可选 unit=i
key 用户认证key,请参考如何获取你的KEY
另外支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx

返回数据说明 #

basic基础信息

参数 描述 示例值
location 地区/城市名称 玉渊潭公园
cid 地区/城市ID CN10101020010A
lat 地区/城市纬度 39.90999
lon 地区/城市经度 116.30999
parent_city 该地区/城市的上级城市 北京
admin_area 该地区/城市所属行政区域 北京
cnty 该地区/城市所属国家名称 中国
tz 该地区/城市所在时区 +8.0

update接口更新时间

参数 描述 示例值
loc 当地时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 12:34
utc UTC时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 04:34

status接口状态

参数 描述 示例
status 接口状态,具体含义请参考接口状态码及错误码 ok

daily_forecast天气预报

参数 描述 示例
date 预报日期  
sr 日出时间 04:50
ss 日落时间 18:06
tmp_max 最高温度 4
tmp_min 最低温度 -5
cond_code_d 白天天气状况代码 100
cond_code_n 夜间天气状况代码 100
cond_txt_d 白天天气状况描述
cond_txt_n 晚间天气状况描述
wind_dir 风向
wind_sc 风力 2-3

历史前一天天气 #

请求URL #

商业版:

https://api.qweather.com/s6/weather/historical?{parameters}

parameters代表请求参数,包括必选和可选参数。所有请求参数均使用&进行分隔,参数值存在中文或特殊字符的情况,需要对参数进行 url encode

请求URL示例

# 获取北京的前一天天气数据
https://api.qweather.com/s6/weather/historical?location=CN101010100&date=2017-05-31&key=xxx

请求参数 #

参数 描述 选择 示例值
location 仅支持城市ID的方式查询,城市列表 必选 location=CN101010100
key 用户认证key,请参考如何获取你的KEY
支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx
date 获取制定日期的历史数据,格式为yyyy-mm-dd 必选 date=2010-01-01

返回数据说明 #

basic 基础信息

参数 描述 示例值
location 地区/城市名称 卓资
cid 地区/城市ID CN101080402
lat 地区/城市纬度 40.89576
lon 地区/城市经度 112.577702
parent_city 该地区/城市的上级城市 乌兰察布
admin_area 该地区/城市所属行政区域 内蒙古
cnty 该地区/城市所属国家名称 中国
tz 该地区/城市所在时区 +8.0

status 接口状态

参数 描述 示例值
status 接口状态,具体含义请参考接口状态码及错误码 ok

daily_weather 当天天气

参数 描述 示例值
date 日期 2013-12-30
sr 日出时间 07:36
ss 日落时间 16:58
mr 月升时间 04:47
ms 月落时间 14:59
tmp_max 最高温度 4
tmp_min 最低温度 -5
hum 相对湿度 37
pcpn 降水量 0
pres 大气压强 1018

hourly_weather 逐小时预报

参数 描述 示例
time 时间,格式yyyy-MM-dd hh:mm 2013-12-30 13:00
tmp 温度 2
cond_code 天气状况代码 101
cond_txt 天气状况代码 多云
wind_dir 风向 西北
wind_sc 风力 3-4
wind_spd 风速,公里/小时 15
hum 相对湿度 30
pres 大气压强 1030

中国极端天气灾害预警 #

  • 获取当前时间点全国3240个市县区所有灾害预警信息。
  • 预警种类:台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰、寒冷、灰霾、雷雨大风、森林火险、降温、道路冰雪、干热风、低温、冰冻、空气重污染、海上大雾、雷暴大风、持续低温、浓浮尘、龙卷风、低温冻害、海上大风、低温雨雪冰冻、强对流、臭氧、大雪、强降雨、强降温、雪灾、森林(草原)火险、雷暴、严寒、沙尘、海上雷雨大风、海上雷电、海上台风。
  • 预警级别:白色(仅限广东省内)、蓝色、黄色、橙色、红色
  • 更新时间:每15分钟更新一次。

请求URL #

商业版(指定地区):

https://api.qweather.com/s6/alarm?{parameters}

商业版(全部地区):

https://api.qweather.com/s6/alarm/all?{parameters}

当使用获取全部城市预警信息时,访问量按照返回的城市预警信息计算,例如当一次性返回500条预警信息时,按照500次访问量计算。

{parameters}代表请求参数,包括必选和可选参数。所有请求参数均使用 &进行分隔,参数值存在中文或特殊字符的情况,需要对参数进行 url encode

请求URL示例

# 获取北京的灾害预警信息
https://api.qweather.com/s6/alarm?location=beijing&key=xxx

请求参数 #

参数 描述 选择 示例值
lang 多语言,可以不使用该参数,默认为简体中文,海外城市默认为英文
详见多语言参数
可选 lang=en
unit 单位选择,公制(m)或英制(i),默认为公制单位
详见度量衡单位参数
可选 unit=i
key 用户数据key,请参考如何获取你的KEY 必选 key=xxxxxxxxxxxxxx

返回数据说明 #

basic 基础信息(指定地区)

基础信息包括所查询的城市/地区的一些基本信息,例如名称、ID、经纬度等

参数 描述 示例值
location 地区/城市名称 卓资
cid 地区/城市ID CN101080402
lat 地区/城市纬度 40.89576
lon 地区/城市经度 112.577702
parent_city 该地区/城市的上级城市 乌兰察布
admin_area 该地区/城市所属行政区域 内蒙古
cnty 该地区/城市所属国家名称 中国
tz 该地区/城市所在时区 +8.0

update 接口更新时间

参数 描述 示例值
loc 当地时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 12:34
utc UTC时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 04:34

status 接口状态

参数 描述 示例
status 接口状态,具体含义请参考接口状态码及错误码 ok

alarm 灾害预警(指定地区)

参数 描述 示例
title 预警标题 北京市朝阳区气象台发布大风黄色预警
stat 预警状态 预警中
level 预警等级 黄色
type 预警类型 大风
txt 预警详细信息 朝阳区气象台05日14时30分发布大风黄色预警,预计5日15时至21时,受东移加强的…

alarm_list 灾害预警(全部地区)

参数 描述 示例
cid 地区/城市ID CN101280601
title 预警标题 广东省深圳市气象台发布雷电黄色预警
stat 预警状态 预警中
level 预警等级 黄色
type 预警类型 雷电
txt 预警详细信息 深圳市气象局于10月04日12时59分发布雷电黄色预警信号,请注意防御。

中国空气质量数据 #

通过空气质量数据接口,可获取空气质量相关数据,包括空气质量实况数据、空气质量未来7天预报以及空气质量未来逐小时预报。

请求URL #

商业版:

https://api.qweather.com/s6/air/{air-type}?{parameters}

免费版:

https://free-api.qweather.com/s6/air/{air-type}?{parameters}
  • {air-type}代表不同的天气数据类型,必选,请使用以下值替代:
air-type 值 描述 授权
now 空气质量实况 商业/免费
forecast 未来3-7天空气质量预报 商业
hourly 未来24小时逐小时空气质量预报 商业
  • {parameters}代表请求参数,包括必选和可选参数。所有请求参数均使用&进行分隔,参数值存在中文或特殊字符的情况,需要对参数进行 url encode

请求URL示例

# 获取北京空气质量实况天气:
https://api.qweather.com/s6/air/now?location=beijing&key=xxx

请求参数 #

参数 描述 选择 示例值
location 需要查询的城市或地区,可输入以下值:
1. 城市ID:城市列表
2. 经纬度格式:经度,纬度(经度在前纬度在后,英文,分隔,十进制格式,北纬东经为正,南纬西经为负
3. 城市名称,支持中英文和汉语拼音
4. 城市名称,上级城市 或 省 或 国家,英文,分隔,此方式可以在重名的情况下只获取想要的地区的天气数据,例如 西安,陕西
5. IP
6. 根据请求自动判断,根据用户的请求获取IP,通过 IP 定位并获取城市数据
必选 1. location=CN101010100
2. location=116.40,39.9
3. location=北京、 location=北京市、 location=beijing
4. location=朝阳,北京、 location=chaoyang,beijing
5. location=60.194.130.1
6. location=auto_ip
lang 多语言,可以不使用该参数,默认为简体中文,海外城市默认为英文
详见多语言参数
可选 lang=en
unit 单位选择,公制(m)或英制(i),默认为公制单位
详见度量衡单位参数
可选 unit=i
key 用户认证key,请参考如何获取你的KEY
支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx

返回数据说明 #

空气质量数据接口将返回一些基本字段和不同空气质量类型的字段。

返回的数据中,basicupdatestatus是基本参数,在不同数据类型中都会返回。

具体的空气质量数据,会根据你请求的{air-type}不同,将返回不同的空气质量数据。

basic 基础信息

基础信息包括所查询的城市/地区的一些基本信息,例如名称、ID、经纬度等

参数 描述 示例值
location 地区/城市名称 卓资
cid 地区/城市ID CN101080402
lat 地区/城市纬度 40.89576
lon 地区/城市经度 112.577702
parent_city 该地区/城市的上级城市 乌兰察布
admin_area 该地区/城市所属行政区域 内蒙古
cnty 该地区/城市所属国家名称 中国
tz 该地区/城市所在时区 +8.0

update 接口更新时间

接口更新时间为当前接口的更新时间,包括城市/地区所在地的当地时间和UTC时间。在一些接口中,其中一部分数据会单独更新,但此时update时间不会变更。

参数 描述 示例值
loc 当地时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 12:34
utc UTC时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 04:34

satuts 接口状态

当前接口的状态,正常返回数据会返回ok,若未能返回数据,会给出具体的错误码,不同的错误码请参考接口状态码及错误码

参数 描述 示例值
status 接口状态,具体含义请参考接口状态码及错误码 ok

air_now_city 空气质量实况(城区)

中国3240个市县区的实时空气质量(AQI)数据,包含环保部300+国控站点所在的地级市。

参数 描述 示例
pub_time 数据发布时间,格式yyyy-MM-dd HH:mm 2017-03-20 12:30
aqi 空气质量指数 74
main 主要污染物 pm25
qlty 空气质量,取值范围:优,良,轻度污染,中度污染,重度污染,严重污染
pm10 pm10 78
pm25 pm25 66
no2 二氧化氮 40
so2 二氧化硫 30
co 一氧化碳 33
o3 臭氧 20

air_now_station 空气质量实况(站点)

环保部1500+国控监测站点实时空气质量(AQI)数据。

参数 描述 示例
pub_time 数据发布时间,格式yyyy-MM-dd HH:mm 2017-03-20 12:30
air_sta 站点名称 万寿西宫
asid 站点ID CNA110000
lat 站点纬度 116.405285
lon 站点经度 39.904989
aqi 空气质量指数 74
main 主要污染物 pm25
qlty 空气质量,取值范围:优,良,轻度污染,中度污染,重度污染,严重污染
pm10 pm10 78
pm25 pm25 66
no2 二氧化氮 40
so2 二氧化硫 30
co 一氧化碳 33
o3 臭氧 20

air_forecast 空气质量预报

结合环保部最新排放污染清单以及WRF-CHEM模型算法,和风天气推出了全国首家且唯一的未来7天空气质量预报数据,本数据接口可对未来7天全国3240个城市地区进行空气质量AQI预报。

参数 描述 示例
date 预报日期,格式yyyy-MM-dd 2017-08-09
aqi 空气质量指数 74
main 主要污染物 pm25
qlty 空气质量,取值范围:优,良,轻度污染,中度污染,重度污染,严重污染

air_hourly 空气质量逐小时预报

全国3240个城市地区进行精确到每一小时的空气质量预报,最长达120小时

参数 描述 示例
time 预报日期,格式yyyy-MM-dd HH:mm 2017-08-09 14:00
aqi 空气质量指数 74
main 主要污染物 pm25
qlty 空气质量,取值范围:优,良,轻度污染,中度污染,重度污染,严重污染

全球太阳高度数据 #

任意时间点的全球太阳高度及方位角接口,为安全和智能驾驶、房屋建设提供数据支持

仅限付费用户使用

请求URL #

https://api.qweather.com/s6/solar/solar-elevation-angle?{parameters}

parameters代表请求参数,包括必选和可选参数。所有请求参数均使用&进行分隔,参数值存在中文或特殊字符的情况,需要对参数进行 url encode

请求URL示例

# 获取某一个坐标的太阳高度
https://api.qweather.com/s6/solar/solar-elevation-angle?lat=39.9&lon=116.4&date=20170809&time=1230&alt=43&tz=8&key=xxx

请求参数 #

参数 描述 选择 示例值
lat 所查询地区的纬度
纬度采用十进制格式,北纬为正,南纬为负
必选 lat=36.088
lon 所查询地区的经度
经度采用十进制格式,东经为正,西经为负
必选 lon=120.343
date 查询日期,格式为yyyyMMdd 必选 20170809
time 查询时间,格式为HHmm,24 时制 必选 1230
alt 海拔高度,单位为米 必选 43
tz 查询地区所在时区 必选 8
key 用户认证key,请参考如何获取你的KEY
支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx

返回数据说明 #

solar_elevation_angle 基础信息

参数 描述 示例值
solar_elevation_angle 太阳高度角 89
solar_azimuth_angle 太阳方位角,正北顺时针方向角度 190
solar_hour 太阳时 0923
hour_angle 时角 -45.5

status 接口状态

参数 描述 示例
status 接口状态,具体含义请参考接口状态码及错误码 ok