S6版本API开发文档

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

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

Status Code

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

常规天气接口

通过常规天气数据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} 代表不同的天气数据类型，必选，请使用以下值替代：

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

请求URL示例

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

请求参数

返回数据说明

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

返回的数据中，basic，update和status是基本参数，在不同数据类型中都会返回。

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

basic 基础信息

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

update 接口更新时间

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

satuts 接口状态

now实况天气

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

daily_forecast 天气预报

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

hourly 逐小时预报

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

lifestyle 生活指数

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

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

lifestyle_forecast 生活指数预报

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

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

1公里格点天气数据

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

请求URL

商业版：

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

免费版：

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

• {grid-type} 代表不同的天气数据类型，必选，请使用以下值替代：

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

请求URL示例

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

请求参数

返回数据说明

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

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

basic 基础信息

update 接口更新时间

status 接口状态

grid_now 格点实况天气

grid_forecast 格点未来7天预报

grid_hourly 格点逐小时天气预报

分钟降水数据

由中国气象局、清华大学以及和风天气联合研发的我国首个精确到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

请求参数

返回数据说明

basic 基础信息

grid_minute_forecast 临近预报

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

pcpn_type降水类型

update 接口更新时间

status 接口状态

中国景点天气预报

全国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

请求参数

返回数据说明

basic基础信息

update接口更新时间

status接口状态

daily_forecast天气预报

历史前一天天气

请求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

请求参数

返回数据说明

basic 基础信息

status 接口状态

daily_weather 当天天气

hourly_weather 逐小时预报

中国极端天气灾害预警

• 获取当前时间点全国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

请求参数

返回数据说明

basic 基础信息（指定地区）

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

update 接口更新时间

status 接口状态

alarm 灾害预警（指定地区）

alarm_list 灾害预警（全部地区）

中国空气质量数据

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

请求URL

商业版：

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

免费版：

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

• {air-type}代表不同的天气数据类型，必选，请使用以下值替代：

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

请求URL示例

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

请求参数

返回数据说明

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

返回的数据中，basic，update和status是基本参数，在不同数据类型中都会返回。

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

basic 基础信息

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

update 接口更新时间

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

satuts 接口状态

air_now_city 空气质量实况（城区）

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

air_now_station 空气质量实况（站点）

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

air_forecast 空气质量预报

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

air_hourly 空气质量逐小时预报

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

全球太阳高度数据

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

仅限付费用户使用

请求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

请求参数

返回数据说明

solar_elevation_angle 基础信息

status 接口状态

天气状况代码