天气预警（弃用）

平台: API

天气灾害预警API可以获取中国及全球多个国家或地区官方发布的实时天气灾害预警数据。

警告：当前API（/v7/warning/now）已弃用，预计在2026年10月1日停止服务。请使用极端天气预警 v1版本替代。

请求路径

/v7/warning/now

参数

查询参数

location(必选)需要查询地区的LocationID或以英文逗号分隔的经度,纬度坐标（十进制，最多支持小数点后两位），LocationID可通过GeoAPI获取。例如 location=101010100 或 location=116.41,39.92
lang多语言设置，请阅读多语言文档，了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。

请求示例

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

请将your_token替换为你的JWT身份认证，将your_api_host替换为你的API Host

返回数据

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

{
  "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"
    ]
  }
}

注意：如果查询的地区当前没有灾害预警信息，返回的warning字段为空。

code 请参考状态码
updateTime 当前API的最近更新时间
fxLink 当前数据的响应式页面，便于嵌入网站或应用
warning.id 本条预警的唯一标识，可判断本条预警是否已经存在
warning.sender 预警发布单位，可能为空
warning.pubTime 预警发布时间
warning.title 预警信息标题
warning.startTime 预警开始时间
warning.endTime 预警结束时间
warning.status 预警信息的发布状态，包括“Active”（发布）和 “Update”（更新）。当预警信息为“Update”时，表示本条预警取代或更新了在related中指定的预警信息。
warning.level 预警等级，该字段已弃用，目前返回为空或未更新的值。请使用severity代替
warning.severity 预警严重程度，包括 “unknown”、“Minor”、“Moderate”、“Severe” 和 “Extreme”
warning.severityColor 预警严重程度对应的颜色，包括 “White”、“Blue”、“Green”、“Yellow”、“Orange”、“Red” 和 “Black”。可能为空
warning.type 预警事件类型ID
warning.typeName 预警事件类型的名称
warning.urgency 预警信息的紧迫程度，可能为空
warning.certainty 预警信息的确定性，可能为空
warning.text 预警详细文字描述
warning.related 与本条预警相关联的预警ID，当预警状态为Update时返回。可能为空
refer.sources 原始数据来源，或数据源说明，可能为空
refer.license 数据许可或版权声明，可能为空