Weather Warning

Weather Warning API for getting real-time local severe weather warning around the world.

You can also first get a list of all cities in a given country or region where warnings are currently in effect via Weather Warning City List API.

Request URL

  • Prohttps://api.qweather.com/v7/warning/now?[params]
  • Devhttps://devapi.qweather.com/v7/warning/now?[params]

Request Parameters

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

key

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

For example: key=12334567890ABC

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

Weather warnings are not available in all cities, see supported countries or regions for weather warnings.

lang

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

  • zh Chinese, default
  • en English

Response

If there is no warning information in the queried location, the warning field is empty.

// Xiamen's weather warning 
// Pro API: https://api.qweather.com/v7/warning/now?location=101230201&lang=en&key=YOUR_KEY
// Dev API: https://devapi.qweather.com/v7/warning/now?location=101230201&lang=en&key=YOUR_KEY

{
  "code": "200",
  "updateTime": "2021-10-10T12:14+08:00",
  "fxLink": "http://hfx.link/3565",
  "warning": [
    {
      "id": "10123020120211010110800706404402",
      "sender": "Xiamen_meteorological_observatory",
      "pubTime": "2021-10-10T11:08+08:00",
      "title": "Xiamen meteorological observatory issued a yellow typhoon warning [level III / heavy]",
      "startTime": "2021-10-10T11:15+08:00",
      "endTime": "2021-10-11T11:15+08:00",
      "status": "active",
      "level": "Yellow",
      "type": "11B01",
      "typeName": "Typhoon",
      "text": "At 11:08 on October 10, 2021, Xiamen meteorological observatory issued a typhoon yellow warning signal: this year s No. 18 typhoon \"compass\" (tropical storm level) today at 08:00, the center is about 890 km east by north of Manila, the Philippines, and the maximum wind force near the center is level 8 (20 m / s). It is expected that the typhoon center will move northwest at a speed of about 25 kilometers per hour, and then turn to the West. Affected by the \"compass\" and cold air, the maximum northeast wind in Siming District, Huli District, Haicang District and Jimei District can reach 6 ~ 7 and gust 8 ~ 9 from day to night, Xiamen inland sea and bridges, high-altitude mountainous areas 8 ~ 9 and gust 10 ~ 11, Chongwu to Dongshan coastal area 9 ~ 10 and gust 11 ~ 12; In the southern Taiwan Strait, there are 10 ~ 11 levels and 12 gusts. Please take precautions. Tongan District and Xiang an District, please pay attention to the release of early warning signals.",
      "related": ""
    },
    {
      "id": "10123020120211010093800616071831",
      "sender": "Xiamen_meteorological_observatory",
      "pubTime": "2021-10-10T09:38+08:00",
      "title": "Xiamen meteorological observatory issued a yellow gale warning [level III / heavy]",
      "startTime": "2021-10-10T09:45+08:00",
      "endTime": "2021-10-11T09:45+08:00",
      "status": "active",
      "level": "Yellow",
      "type": "11B06",
      "typeName": "Gale",
      "text": "At 09:38 on October 10, 2021, Xiamen meteorological observatory continued to issue the yellow warning signal of strong wind: affected by the typhoon \"compass\" and cold air, the wind in Jimei District, Haicang District, Huli District, Siming District and coastal areas will still be strong in the next 12 hours. It is expected that the maximum wind force in inland sea, bridges and high-altitude mountainous areas can reach 7-8 and gust 9-10; From Chongwu to Dongshan coast, the maximum can reach level 8 ~ 9 and gust level 10 ~ 11; In the south of the Taiwan Strait, the maximum can reach 9 ~ 10 and gust 11 ~ 12. Please take precautions! Tongan District and Xiang an District, please pay attention to the release of early warning signals.",
      "related": "10123020120211009213700075228006"
    }
  ],
  "refer": {
    "sources": [
      "12379"
    ],
    "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

warning.id

The unique ID of this warning, which can be used to determine whether this warning already exists.

warning.sender

Warning issuing unit, may be null

warning.pubTime

Warning release time

warning.title

Title of warning

warning.startTime

Warning start time, may be null

warning.endTime

End time of warning, may be null

warning.status

Warning status, may be null
active Early warning or first warning
update Warning information update
cancel cancel warning

warning.level

Warning level

warning.type

Warning type ID

warning.typeName

Warning type name

warning.text

Description of the warning

warning.related

The warning ID associated with this warning, returned when the warning status is cancel or update. May be null

refer.sources

Data source and other statements, may be null

refer.license

Data license, may be null

More Warning Resource