实时天气预警

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

参数

WeatherAlertCurrentParameter

示例代码

Swift

Task {
    do {
        let parameter = WeatherAlertCurrentParameter(longitude: 113.26, 
                                                      latitude: 38.73, 
                                                     localTime: false, 
                                                          lang: .ZH_HANS)
        let response = try await Q.weatherAlertCurrent(parameter)
        print(response)
    } catch QWeatherError.errorResponse(let error) {
        print(error)
    } catch {
        print(error)
    }
}

Objective-C

WeatherAlertCurrentParameter *parameter = [WeatherAlertCurrentParameter instanceWithLongitude: 113.26 
                                                                                     latitude: 38.73 
                                                                                    localTime: NO 
                                                                                         lang: @(LangZH_HANS)];
[QWeatherObjc weatherAlertCurrent:parameter completionHandler:^(WeatherAlertCurrentResponse * _Nullable response, NSError * _Nullable error) {
    if (response) {
        NSLog(@"%@", response.description);
    }
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    }
}];

返回数据

WeatherAlertCurrentResponse

• 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 对当前预警的应对方式的类型代码，可能为空