天气生活指数

和风天气生活指数API接口为中国和海外城市提供详细的生活指数实况和预报数据,包括:

  • 中国生活指数:舒适度指数、洗车指数、穿衣指数、感冒指数、运动指数、旅游指数、紫外线指数、空气污染扩散条件指数、空调开启指数、过敏指数、太阳镜指数、化妆指数、晾晒指数、交通指数、钓鱼指数、防晒指数
  • 海外生活指数:运动指数、洗车指数、紫外线指数、钓鱼指数

请求URL

当天生活指数预报 HTTP GET

  • 商业版 https://api.qweather.com/v7/indices/1d?{请求参数}
  • 开发版 https://devapi.qweather.com/v7/indices/1d?{请求参数}

3天生活指数预报 HTTP GET

  • 商业版 https://api.qweather.com/v7/indices/3d?{请求参数}

请求参数

请求参数包括必选和可选参数,如不填写可选参数将使用其默认值,参数之间使用&进行分隔。

location 必选

需要查询地区的LocationID或以逗号分隔的经度/纬度坐标(十进制),LocationID可通过城市搜索服务获取。例如: location=101010100location=116.41,39.92

key 必选

用户认证密钥,参考如何获取你的KEY。支持数字签名方式认证。例如:key=12334567890ABC

type 必选

生活指数数据类型ID,包括洗车指数、穿衣指数、钓鱼指数等。可以一次性获取多个类型的生活指数,多个类型用英文,分割。例如: type=3,5。具体生活指数的ID和等级参考文档下方。各项生活指数并非适用于所有城市。

gzip 可选

对接口进行压缩,可大幅节省网络消耗、减少接口获取延迟。默认开启gzip

  • y 使用gzip方式压缩,默认
  • n 不使用压缩

lang 可选

多语言,默认中文,例如lang=en。具体的语言参数值请参考多语言参数。当一些城市不存在对应的语言时,将返回英文或其本地语言结果。

返回数据

参数 描述 示例值
code API状态码,具体含义请参考状态码 200
updateTime 当前API的最近更新时间 2013-12-30T01:45+08:00
fxLink 该城市的天气生活指数自适应网页,可嵌入网站或应用 http://hfx.link/ae45
daily.date 预报日期 2018-05-30
daily.type 生活指数预报类型 2
daily.name 生活指数预报类型的名称 舒适度指数
daily.level 生活指数预报等级 1
daily.category 生活指数预报级别名称 舒适
daily.text 生活指数预报的详细描述,可能为空 白天温度适宜,风力不大,相信您在这样的天气条件下,应会感到比较清爽和舒适。
refer.sources 原始数据来源,可能为空  
refer.license 数据许可证  

生活指数等级

生活指数等级仅供参考,等级有可能会进行调整。当选择type=0时,不能再选择其他指数。

名称 TYPE 级别名称(对应等级数值)
全部生活指数 0  
运动指数 1 适宜(1)、较适宜(2)、较不宜(3)
洗车指数 2 适宜(1)、较适宜(2)、较不宜(3)、不宜(4)
穿衣指数 3 寒冷(1)、冷(2)、较冷(3)、较舒适(4)、舒适(5)、热(6)、炎热(7)
钓鱼指数 4 适宜(1)、较适宜(2)、不宜(3)
紫外线指数 5 最弱(1)、弱(2)、中等(3)、强(4)、很强(5)
旅游指数 6 适宜(1)、较适宜(2)、一般(3)、较不宜(4)、不适宜(5)
花粉过敏指数 7 极不易发(1)、不易发(2)、较易发(3)、易发(4)、极易发(5)
舒适度指数 8 舒适(1)、较舒适(2)、较不舒适(3)、很不舒适(4)、极不舒适(5)、不舒适(6)、非常不舒适(7)
感冒指数 9 少发(1)、较易发(2)、易发(3)、极易发(4)
空气污染扩散条件指数 10 优(1)、良(2)、中(3)、较差(4)、很差(5)
空调开启指数 11 长时间开启(1)、部分时间开启(2)、较少开启(3)、开启制暖空调(4)
太阳镜指数 12 不需要(1)、需要(2)、必要(3)、很必要(4)、非常必要(5)
化妆指数 13 保湿(1)、保湿防晒(2)、去油防晒(3)、防脱水防晒(4)、去油(5)、防脱水(6)、防晒(7)、滋润保湿(8)
晾晒指数 14 极适宜(1)、适宜(2)、基本适宜(3)、不太适宜(4)、不宜(5)、不适宜(6)
交通指数 15 良好(1)、较好(2)、一般(3)、较差(4)、很差(5)
防晒指数 16 弱(1)、较弱(2)、中等(3)、强(4)、极强(5)

请求和返回示例

3天生活指数预报

// 北京3天运动指数与洗车指数
// 商业版:https://api.qweather.com/v7/indices/3d?type=1,2&location=101010100&key=xxx
// 开发版:https://devapi.qweather.com/v7/indices/3d?type=1,2&location=101010100&key=xxx
// 请将示例请求URL中的KEY更换成你自己的KEY

{
  "code": "200",
  "updateTime": "2020-06-21T12:57+08:00",
  "daily": [
    {
      "date": "2020-06-21",
      "type": "1",
      "name": "运动指数",
      "level": "2",
      "category": "较适宜",
      "txt": "天气较好,但因气温较高且风力较强,请适当降低运动强度并注意户外防风。"
    },
    {
      "date": "2020-06-21",
      "type": "2",
      "name": "洗车指数",
      "level": "2",
      "category": "较不宜",
      "txt": "较不宜洗车,未来一天无雨,风力较大,如果执意擦洗汽车,要做好蒙上污垢的心理准备。"
    },
    {
      "date": "2020-06-22",
      "type": "1",
      "name": "运动指数",
      "level": "2",
      "category": "较适宜",
      "txt": "天气较好,但因气温较高且风力较强,请适当降低运动强度并注意户外防风。"
    },
    {
      "date": "2020-06-22",
      "type": "2",
      "name": "洗车指数",
      "level": "3",
      "category": "较不宜",
      "txt": "较不宜洗车,未来一天无雨,风力较大,如果执意擦洗汽车,要做好蒙上污垢的心理准备。"
    },
    {
      "date": "2020-06-23",
      "type": "1",
      "name": "运动指数",
      "level": "2",
      "category": "较适宜",
      "txt": "天气较好,较适宜进行各种运动,但因天气热,请适当减少运动时间,降低运动强度。"
    },
    {
      "date": "2020-06-23",
      "type": "2",
      "name": "洗车指数",
      "level": "1",
      "category": "适宜",
      "txt": "适宜洗车,未来持续两天无雨天气较好,适合擦洗汽车,蓝天白云、风和日丽将伴您的车子连日洁净。"
    }
  ],
  "refer": {
    "sources": [],
    "license": [
      "commercial license"
    ]
  }
}