实时天气预警

平台: API

根据指定的经纬度坐标，查询中国和全球正在生效的官方天气预警信息。阅读实用资料-预警以了解预警信息支持的国家和地区、事件类型等必要信息。

请求路径

/weatheralert/v1/current/{latitude}/{longitude}

参数

路径参数

latitude(必选)所需位置的纬度。十进制，最多支持小数点后两位。例如 39.92
longitude(必选)所需位置的经度。十进制，最多支持小数点后两位。例如 116.41

查询参数

localTime是否返回查询地点的本地时间。true 返回本地时间，false 返回UTC时间（默认）。
lang多语言设置，请阅读多语言文档，了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。

请求示例

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your_api_host/weatheralert/v1/current/39.90/116.40'

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

返回数据

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

{
  "metadata": {
    "tag": "ec71f87d59c5db45281fecc9f25d136f638ba414ff0a4c4e97258e6d30218aac",
    "zeroResult": false,
    "attributions": [
      "https://developer.qweather.com/attribution.html",
      "当前预警数据可能存在延迟或信息过时，以官方数据发布为准。"
    ]
  },
  "alerts": [
    {
      "id": "202510241119105837988676",
      "senderName": "临桂区气象台",
      "issuedTime": "2025-10-24T11:19+08:00",
      "messageType": {
        "code": "update",
        "supersedes": [
          "202510181140100706230391"
        ]
      },
      "eventType": {
        "name": "大风",
        "code": "1006"
      },
      "urgency": null,
      "severity": "minor",
      "certainty": null,
      "icon": "1006",
      "color": {
        "code": "blue",
        "red": 30,
        "green": 50,
        "blue": 205,
        "alpha": 1
      },
      "effectiveTime": "2025-10-24T11:19+08:00",
      "onsetTime": "2025-10-24T11:19+08:00",
      "expireTime": "2025-10-25T11:19+08:00",
      "headline": "临桂区气象台更新大风蓝色预警信号",
      "description": "临桂区气象台24日11时19分继续发布大风蓝色预警信号：预计未来24小时内临桂将出现6级（或阵风7级）以上大风，请做好防范。",
      "criteria": "24小时内可能受大风影响，平均风力可达6级以上，或者阵风7级以上；或者已经受大风影响，平均风力为6～7级，或者阵风7～8级并可能持续。",
      "responseTypes": [],
      "instruction": "1. 政府及有关部门按照职责做好防大风工作。\n2. 关好门窗，加固围板、棚架、广告牌等易被风吹动的搭建物，妥善安置易受大风影响的室外物品，遮盖建筑物资。\n3. 相关水域水上作业和过往船舶采取积极的应对措施，如回港避风或者绕道航行等。\n4. 行人注意尽量少骑自行车，刮风时不要在广告牌、临时搭建物等下面逗留。\n5. 有关部门和单位注意森林、草原等防火。"
    }
  ]
}

metadata.tag 数据标签
metadata.zeroResult true 表示请求成功，但无数据返回，例如查询地点无预警
metadata.attributions 数据来源或声明，开发者必须将此内容与当前数据一起展示
alerts.id 本条预警信息的唯一标识
alerts.senderName 预警发布机构的名称，可能为空
alerts.issuedTime 原始预警信息生成的时间，实际发布或接收时间会略有延迟
alerts.messageType.code 预警信息性质的代码，开发者可以了解当前预警是新发布的还是对之前预警的更新。
alerts.messageType.supersedes 当前预警取代或取消后续预警ID的列表，仅在 messageType.code 为 update 或 cancel 时返回。
alerts.eventType.name 预警事件类型的名称
alerts.eventType.code 预警事件类型的代码
alerts.urgency 预警信息的紧迫程度，可能为空
alerts.severity 预警信息的严重程度
alerts.certainty 预警信息的确定性或可信度，可能为空
alerts.icon 预警对应的图标代码
alerts.color.code 预警信息的颜色代码
alerts.color.red 预警信息颜色的红色分量值（RGBA），范围 0–255
alerts.color.green 预警颜色的绿色分量值（RGBA），范围 0–255
alerts.color.blue 预警颜色的蓝色分量值（RGBA），范围 0–255
alerts.color.alpha 预警颜色的透明度分量值（RGBA），范围 0-1
alerts.effectiveTime 预警信息的生效时间，可能为空
alerts.onsetTime 预警事件预计开始的时间，可能为空
alerts.expiredTime 预警信息的失效时间
alerts.headline 预警信息的简要描述或标题
alerts.description 预警信息的详细描述
alerts.criteria 当前预警信息的触发标准或条件。仅供参考，可能滞后于官方标准。可能为空
alerts.instruction 对当前预警的防御指南或行动指导，可能为空
alerts.responseTypes 对当前预警的应对方式的类型代码，可能为空