实时天气预警

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

请求路径#

GET /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.92/116.41?localTime=false&lang=zh'

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

试一下

返回数据#

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