Weather Indices

Weather Indices API provides real-time and forecast data including:

  • Weather Indices in China: Comfort Indices, Car Wash Indices, Dressing Indices, Cold Indices, Sports Indices, Travel Indices, UV Indices, Air Pollution Indices, Air Conditioning Indices, Allergy Indices, Sunglasses Indices, Makeup Indices, Sunshine Indices, Traffic Indices, Fishing Indices, Sun Protection Indices
  • Weather Indices worldwide: Sports Indices, Car Wash Indices, UV Indices, Fishing Indices

Request URL #

Today Indices

  • Prohttps://api.qweather.com/v7/indices/1d?[params]
  • Devhttps://devapi.qweather.com/v7/indices/1d?[params]

3 Days of Indices

  • Prohttps://api.qweather.com/v7/indices/3d?[params]

Request Parameters #

All parameters are separated by &. If no optional parameters are set, the default value will be used.

location

The location to be queried, support LocationID or comma-separated longitude and latitude, LocationID can be obtained by GeoAPI.

For example: location=101010100 or location=116.41,39.92

key

API authentication key, please refer to How To Get Your Key. Support Signature Authentication.

For example: key=12334567890ABC

type

Weather indices type ID, including car wash index, clothing index, fishing index, etc. You can get multiple types of weather indices at one time, and multiple types are separated by comma, e.g., type=3,5, and all indices type see Indices Constant.

lang

Multi-language settings, only support Chinese and English for this data.

  • zh Chinese, default
  • en English

Response #

// Sport and car wash indices for Beijing
// Pro: https://api.qweather.com/v7/indices/3d?type=1,2&location=101010100&lang=en&key=YOUR_KEY
// Dev: https://devapi.qweather.com/v7/indices/3d?type=1,2&location=101010100&lang=en&key=YOUR_KEY

{
  "code": "200",
  "updateTime": "2021-02-06T16:36+08:00",
  "fxLink": "http://hfx.link/2ax2",
  "daily": [
    {
      "date": "2021-02-06",
      "type": "2",
      "name": "Car Wash",
      "level": "2",
      "category": "Good",
      "text": "较适宜洗车,未来一天无雨,风力较小,擦洗一新的汽车至少能保持一天。"
    },
    {
      "date": "2021-02-06",
      "type": "1",
      "name": "Sport",
      "level": "3",
      "category": "Bad",
      "text": "天气较好,但考虑天气寒冷,推荐您进行室内运动,户外运动时请注意保暖并做好准备活动。"
    }
  ],
  "refer": {
    "sources": [
      "Weather China"
    ],
    "license": [
      "commercial license"
    ]
  }
}
Parameters Description
code

API status code, please refer to Status Code

updateTime

API last update time

fxLink

Responsive web page of this data, for embedded in website or APP

daily.date

Forecast date

daily.type

Weather indices forecast type ID

daily.name

Name of weather indices type

daily.level

Weather indices level

daily.category

Weather indices category name

daily.text

Description of the weather indices, may be null

refer.sources

Data source and other statements, may be null

refer.license

Data license, may be null

Indices Constant #

The weather indices level is for reference only, and the level may be adjusted.

Name Type Level (Category)
All indices 0  
Sports 1 Excellent (1), Good (2), Poor (3)
Car Wash 2 Excellent (1), Good (2), At Risk (3), Poor (4)
Clothing 3 Freezing (1), Cold (2), Cooler (3), Cool (4), Comfort (5), Hot (6), Heat (7)
Fishing 4 Good (1), Moderate (2), Poor (3)
UV 5 Very Low (1), Low (2), Moderate (3), High (4), Extreme (5)
Travel 6 Excellent (1), Good (2), Moderate (3), Fair (4), Poor (5)
Allergy 7 Beneficial (1), Neutral (2), At Risk (3), High Risk (4), Extreme Risk (5)
Comfort 8 Excellent (1), Good (2), Moderate (3), Poor (4), Bad (5), Worse (6), Worst (7) )
Cold 9 Healthy (1), Moderate (2), Unhealthy (3), Hazardous (4)
Air Pollution 10 Excellent (1), Good (2), Moderate (3), Bad (4), Poor (5)
Air-Conditioner 11 On (1), Advise (2), Neutral (3), Heating Mode (4)
Sunglasses 12 No (1), Recommend (2), Advise (3), Need (4), Necessary (5)
Makeup 13 Hydrating (1), Moisturizing and sun protection (2), Oil control and sun protection (3), Prevent dehydration and sun protection (4), Oil control (5), Prevent dehydration (6), Sun protection (7), Moisturizing (8)
Air-Cure 14 Excellent (1), Good (2), Moderate (3), At Risk (4), Bad (5), Poor (6)
Traffic 15 Excellent (1), Good (2), Moderate (3), Poor (4), Bad (5)
SPF 16 Very Low (1), Low (2), Moderate (3), High (4), Extreme (5)