天气灾害预警

适用于 iOS SDK v4.9+

天气灾害预警服务可以获取中国及全球多个国家或地区实时天气灾害预警数据,了解更多预警信息

灾害预警

接口代码(枚举) 接口 数据类
INQUIRE_TYPE_WARNING 灾害预警 WarningBaseClass

请求参数

请求参数包括必选和可选参数,如不填写可选参数将使用其默认值。

location

需要查询地区的LocationID或以逗号分隔的经度/纬度坐标(十进制,最多支持小数点后两位),LocationID可通过GeoAPI服务获取。例如: location=101010100location=116.41,39.92

天气预警并非在所有地区可用,了解天气预警支持的国家或地区

appKey

用户认证key,请参考如何获取你的KEY。例如 appKey=123456789ABC

lang

多语言设置,默认中文,本数据仅支持中文和英文。可选语言请参考多语言参数

示例代码

 
    QWeatherConfigInstance.publicID = @"publicID";
    QWeatherConfigInstance.appKey = @"key";
    QWeatherConfigInstance.appType = APP_TYPE_BIZ;    
    QWeatherConfigInstance.location = @"101010100";
    QWeatherConfigInstance.lang = @"";
    QWeatherConfigInstance.unit = @"";
    [QWeatherConfigInstance weatherWithInquireType: INQUIRE_TYPE_WARNING WithSuccess:^(WarningBaseClass  *responseObject) {
        
        NSLog(@"描述->%@",[responseObject description]);
        
    } faileureForError:^(NSError *error) {
        NSLog(@"error->%@",error);
        
    }];

返回数据

参数 描述
code

API状态码,具体含义请参考状态码

updateTime

当前API的最近更新时间

fxLink

当前数据的响应式页面,便于嵌入网站或应用

warning.id

本条预警的唯一标识,可判断本条预警是否已经存在

warning.sender

预警发布单位,可能为空

warning.pubTime

预警发布时间

warning.title

预警信息标题

warning.startTime

预警开始时间,可能为空

warning.endTime

预警结束时间可能为空

warning.status

预警信息的发布状态

warning.level

预警等级(弃用)该字段已弃用,使用severityseverityColor代替

warning.severity

预警严重等级

warning.severityColor

预警严重等级颜色可能为空

warning.type

预警类型ID

warning.typeName

预警类型名称

warning.urgency

预警信息的紧迫程度可能为空

warning.certainty

预警信息的确定性可能为空

warning.text

预警详细文字描述

warning.related

与本条预警相关联的预警ID,当预警状态为cancel或update时返回。可能为空

refer.sources

原始数据来源,或数据源说明,可能为空

refer.license

数据许可或版权声明,可能为空

灾害预警列表

获取指定国家或地区当前正在发生预警的城市列表。

接口代码(枚举) 接口 数据类
INQUIRE_TYPE_WARNINGLIST 灾害预警城市列表 WarningListClass

请求参数

请求参数包括必选和可选参数,如不填写可选参数将使用其默认值。

range

选择指定的国家或地区。天气预警支持的国家或地区请参考这里,使用ISO 3166格式。例如range=cnrange=fr

appKey

用户认证key,请参考如何获取你的KEY。例如 appKey=123456789ABC

示例代码

 
    QWeatherConfigInstance.publicID = @"publicID";
    QWeatherConfigInstance.appKey = @"key";
    QWeatherConfigInstance.appType = APP_TYPE_BIZ;    
    QWeatherConfigInstance.range = @"cn";
    [QWeatherConfigInstance weatherWithInquireType: INQUIRE_TYPE_WARNINGLIST WithSuccess:^(WarningListClass  *responseObject) {
        
        NSLog(@"描述->%@",[responseObject description]);
        
    } faileureForError:^(NSError *error) {
        NSLog(@"error->%@",error);
        
    }];

返回数据

参数 描述
code

API状态码,具体含义请参考状态码

updateTime

当前API的最近更新时间

warningLocList.locationId

当前国家预警的LocationID

refer.sources

原始数据来源,或数据源说明,可能为空

refer.license

数据许可或版权声明,可能为空

预警类型和等级

查看预警类型和等级