Edit

Weather Warning

Platform: API iOS Android

Get officially issued real-time severe weather warning data around the world.

Hint: For the implementation of weather warnings, see Resource - Warning Info in advance.

Endpoint 

/v7/warning/now

Parameters

Query parameters

  • location(required)The location to be queried, support LocationID or comma-separated longitude and latitude (decimal, up to 2 decimal places), LocationID can be obtained by GeoAPI. Example: location=101010100 or location=116.41,39.92
  • langMulti-language setting, please see Language to find out how our multi-language works and how to set up.

Request example 

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your_api_host/v7/warning/now?location=101230201&lang=en'

Replace your_token and your_api_host with your JWT Authentication and API Host

Response

The response is in JSON format and is Gzip compressed.

{
  "code": "200",
  "updateTime": "2023-04-03T14:20+08:00",
  "fxLink": "https://www.qweather.com/severe-weather/shanghai-101020100.html",
  "warning": [
    {
      "id": "10102010020230403103000500681616",
      "sender": "上海中心气象台",
      "pubTime": "2023-04-03T10:30+08:00",
      "title": "上海中心气象台发布大风蓝色预警[Ⅳ级/一般]",
      "startTime": "2023-04-03T10:30+08:00",
      "endTime": "2023-04-04T10:30+08:00",
      "status": "active",
      "level": "",
      "severity": "Minor",
      "severityColor": "Blue",
      "type": "1006",
      "typeName": "大风",
      "urgency": "",
      "certainty": "",
      "text": "上海中心气象台2023年04月03日10时30分发布大风蓝色预警[Ⅳ级/一般]：受江淮气旋影响，预计明天傍晚以前本市大部地区将出现6级阵风7-8级的东南大风，沿江沿海地区7级阵风8-9级，请注意防范大风对高空作业、交通出行、设施农业等的不利影响。",
      "related": ""
    }
  ],
  "refer": {
    "sources": [
      "12379"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

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

  • code See 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
  • warning.level Warning level (deprecated), Do not use warning.level anymore, this field is deprecated and the value will be null or out of date. Please uses severity and severityColor instead
  • warning.severity Warning severity
  • warning.severityColor Preferred color for severity, may be null
  • warning.type Warning type ID
  • warning.typeName Warning type name
  • warning.urgency The urgency of the warning message, may be null
  • warning.certainty The certainty of the warning message, may be null
  • 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