实时天气预警

根据指定经纬度查询全球国家和地区正在生效的官方天气预警信息。

请求路径#

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

参数#

路径参数

latitude^必选

number

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

number

所需位置的经度。十进制，最多支持小数点后两位。例如 116.41

查询参数

localTime

boolean

是否返回查询地点的本地时间

可选值： false UTC时间（默认），true 本地时间
lang

string

多语言设置

请求示例#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/weatheralert/v1/current/39.92/116.41'

请将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
  
  数据唯一标识
- attributions
  
  array
  
  数据归因信息或声明，必须与当前数据共同显示
- zeroResult
  
  boolean
  
  true 表示请求成功，但无数据返回，例如查询地点无预警
alerts

array

预警信息列表
- id
  
  string
  
  本条预警信息的唯一标识
- senderName
  
  string
  
  预警发布机构的名称，可能为空
- issuedTime
  
  date-time
  
  原始预警信息生成的时间，实际发布或接收时间会略有延迟
- messageType
  
  object
  
  预警信息的类型/性质
  - code
    
    string
    信息性质的代码。可选值：
    
    alert 初始且活跃的预警信息
    
    update 更新并取代了在 messageType.supersedes 中指定预警信息
    
    cancel 取消了在 messageType.supersedes 中指定预警信息。cancel 性质的预警信息的有效期为 1 小时
  - supersedes
    
    array
    
    当前预警取代了之前预警的列表
- eventType
  
  object
  
  预警事件类型
  - name
    
    string
    
    事件名称
  - code
    
    string
    
    事件代码
- urgency
  
  string
  预警信息的紧迫程度，可选值:
  - immediate 必须立刻采取行动
  - expected 应尽快采取行动（通常在 1 小时内）
  - future 应在近期采取行动
  - past 事件已不再发生
  - unknown 紧迫性未知
- severity
  
  string
  预警信息的严重程度，可选值:
  - unknown：严重性未知
  - minor：对生命或财产构成的威胁极小或没有已知威胁
  - moderate：对生命或财产可能构成威胁
  - severe：对生命或财产构成的重大威胁
  - extreme：对生命或财产构成的严重威胁
- certainty
  
  string
  预警信息的确定性或可信度，可选值：
  - observed 事件已经发生或正在发生
  - likely 发生概率 ≥ 50%
  - possible 有可能发生，概率 ≤ 50%
  - unlikely 预计不会发生，概率接近 0
  - unknown 确定性未知
- icon
  
  string
  
  预警对应的图标代码
- color
  
  object
  
  预警信息 RGBA 颜色表示
  - code
    
    string
    
    颜色代码，可选值: white、gray、green、blue、yellow、amber、orange、red、purple、black
  - red
    
    number
    
    红色分量值，取值范围 [0, 255]
  - green
    
    number
    
    绿色分量值，取值范围 [0, 255]
  - blue
    
    number
    
    蓝色分量值，取值范围 [0, 255]
  - alpha
    
    number
    
    透明度分量值，取值范围 [0, 1]
- effectiveTime
  
  date-time
  
  预警信息的生效时间
- onsetTime
  
  date-time
  
  预警事件预计开始的时间，可能为空
- expireTime
  
  date-time
  
  预警信息的失效时间
- headline
  
  string
  
  预警信息的简要描述或标题
- description
  
  string
  
  预警信息的详细描述
- criteria
  
  string
  
  当前预警信息的触发标准或条件，仅供参考，可能滞后于官方标准
- responseTypes
  
  array
  
  对当前预警的应对方式的类型代码，可能为空
- instruction
  
  string
  
  对当前预警的防御指南或行动指导，可能为空