这里是和风天气API S6版本,该版本将于2021年12月31日下线且不再提供技术支持,新用户现已无法使用,点击查看最新版本

S6版本API开发文档

适用API版本 维护期 最后编辑 下载本文档(.md)
S6 2018年1月1日 至 2021年6月1日 2020年3月20日 下载

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.heweather.net/s6/weather/{weather-type}?{parameters}

免费版:

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

请求URL示例

# 获取北京实况天气
https://api.heweather.net/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.heweather.net/s6/weather/{grid-type}?{parameters}

免费版:

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

请求URL示例

# 获取某一个坐标的格点实况天气
https://api.heweather.net/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.heweather.net/s6/weather/grid-minute?{parameters}

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

请求URL示例

# 获取某一坐标分钟级降水情况:
https://api.heweather.net/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.heweather.net/s6/scenic?{parameters}

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

请求URL示例

# 获取北京天坛公园天气情况:
https://api.heweather.net/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.heweather.net/s6/weather/historical?{parameters}

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

请求URL示例

# 获取北京的前一天天气数据
https://api.heweather.net/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.heweather.net/s6/alarm?{parameters}

商业版(全部地区):

https://api.heweather.net/s6/alarm/all?{parameters}

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

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

请求URL示例

# 获取北京的灾害预警信息
https://api.heweather.net/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.heweather.net/s6/air/{air-type}?{parameters}

免费版:

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

请求URL示例

# 获取北京空气质量实况天气:
https://api.heweather.net/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.heweather.net/s6/solar/solar-elevation-angle?{parameters}

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

请求URL示例

# 获取某一个坐标的太阳高度
https://api.heweather.net/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

风云二号卫星云图

风云二号卫星每小时更新的全国彩色卫星云图

请求URL

商业版:

https://api.heweather.net/s6/map/cloudmap?{parameters}

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

请求参数

参数 描述 选择 示例值
key 用户认证key,请参考如何获取你的KEY
支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx