天气灾害预警

平台: API iOS Android

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

使用天气预警API,你需要了解更多预警信息

你也可以先通过天气预警城市列表API获取到指定国家或地区当前发生预警的所有城市列表。

接口代码(枚举) 接口 数据类
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 数据许可或版权声明,可能为空

预警类型和等级

查看预警类型和等级