编辑

天气灾害预警

平台: API iOS Android

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

提示：天气预警有较多规则和需要注意的事项，在开始使用天气预警之前，你应该先阅读实用资料-预警信息。

接口代码 接口 数据类
warningNow 天气灾害预警 WarningResponse

参数

WarningNowParameter

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

示例代码

Swift

Task {
    do {
        let parameter = WarningNowParameter(location: "101010100")
        let response = try await QWeather.instance
            .warningNow(parameter)
        print(response)
    } catch QWeatherError.errorResponse(let error) {
        print(error)
    } catch {
        print(error)
    }
}

Objective-C

WarningNowParameter *parameter = [WarningNowParameter instanceWithLocation:@"101010100" lang:@(LangZH_HANS)];
[QWeatherObjc warningNow:parameter completionHandler:^(WarningResponse * _Nullable response, NSError * _Nullable error) {
    if (response) {
        NSLog(@"%@", response.description);
    }
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    }
}];

返回数据

WarningResponse

  • code 请参考状态码
  • updateTime 当前API的最近更新时间
  • fxLink 当前数据的响应式页面，便于嵌入网站或应用
  • warning.id 本条预警的唯一标识，可判断本条预警是否已经存在
  • warning.sender 预警发布单位，可能为空
  • warning.pubTime 预警发布时间
  • warning.title 预警信息标题
  • warning.startTime 预警开始时间，可能为空
  • warning.endTime 预警结束时间，可能为空
  • warning.status 预警信息的发布状态
  • warning.level 预警等级（已弃用），不要再使用这个字段，该字段已弃用，目前返回为空或未更新的值。请使用severity和severityColor代替
  • warning.severity 预警严重等级
  • warning.severityColor 预警严重等级颜色，可能为空
  • warning.type 预警类型ID
  • warning.typeName 预警类型名称
  • warning.urgency 预警信息的紧迫程度，可能为空
  • warning.certainty 预警信息的确定性，可能为空
  • warning.text 预警详细文字描述
  • warning.related 与本条预警相关联的预警ID，当预警状态为cancel或update时返回。可能为空
  • refer.sources 原始数据来源，或数据源说明，可能为空
  • refer.license 数据许可或版权声明，可能为空

预警类型和等级

查看预警类型和等级