天气指数预报

平台: API iOS Android

获取中国和全球城市天气生活指数预报数据。

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

请求URL

当天生活指数
https://api.qweather.com/v7/indices/1d?{查询参数}
未来3天生活指数
https://api.qweather.com/v7/indices/3d?{查询参数}

如果是免费订阅,将上述API Host更改为devapi.qweather.com。参考免费订阅可用的数据

请求参数

请求参数包括必选和可选参数,参数之间使用&进行分隔。

  • key(必选)用户认证key,请参考如何获取你的KEY。支持数字签名方式进行认证。例如 key=123456789ABC
  • location(必选)需要查询地区的LocationID或以英文逗号分隔的经度,纬度坐标(十进制,最多支持小数点后两位),LocationID可通过GeoAPI获取。例如 location=101010100location=116.41,39.92
  • type(必选)生活指数的类型ID,包括洗车指数、穿衣指数、钓鱼指数等。可以一次性获取多个类型的生活指数,多个类型用英文,分割。例如type=3,5。具体生活指数的ID和等级参考天气指数信息。各项生活指数并非适用于所有城市。
  • lang多语言设置,请阅读多语言文档,了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。

请求示例

北京市运动指数与洗车指数

curl -L -X GET --compressed 'https://api.qweather.com/v7/indices/1d?type=1,2&location=101010100&key=YOUR_KEY'

返回数据

返回数据是JSON格式并进行了Gzip压缩

{
  "code": "200",
  "updateTime": "2021-12-16T18:35+08:00",
  "fxLink": "http://hfx.link/2ax2",
  "daily": [
    {
      "date": "2021-12-16",
      "type": "1",
      "name": "运动指数",
      "level": "3",
      "category": "较不宜",
      "text": "天气较好,但考虑天气寒冷,风力较强,推荐您进行室内运动,若户外运动请注意保暖并做好准备活动。"
    },
    {
      "date": "2021-12-16",
      "type": "2",
      "name": "洗车指数",
      "level": "3",
      "category": "较不宜",
      "text": "较不宜洗车,未来一天无雨,风力较大,如果执意擦洗汽车,要做好蒙上污垢的心理准备。"
    }
  ],
  "refer": {
    "sources": [
      "QWeather"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}
  • code 请参考状态码
  • updateTime 当前API的最近更新时间
  • fxLink 当前数据的响应式页面,便于嵌入网站或应用
  • daily.date 预报日期
  • daily.type 生活指数类型ID
  • daily.name 生活指数类型的名称
  • daily.level 生活指数预报等级
  • daily.category 生活指数预报级别名称
  • daily.text 生活指数预报的详细描述,可能为空
  • refer.sources 原始数据来源,或数据源说明,可能为空
  • refer.license 数据许可或版权声明,可能为空

等级和类型

了解天气生活指数的等级和类型,请访问天气指数信息