历史天气和空气质量

适用于 iOS SDK v4.9+

获取最近10天全国历史天气和历史空气质量数据。

接口代码(枚举) 接口 数据类
INQUIRE_TYPE_HISTORICAL_WEATHER 历史天气 WeatherHistoricalBaseClass
INQUIRE_TYPE_HISTORICAL_AIR 历史空气质量 WeatherHistoricalBaseClass

请求参数

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

location

需要查询的地区,仅支持LocationID,LocationID可通过城市搜索服务获取。例如 location=101010100

date

选择日期,最多可选择最近10天(不包含今天)的数据。日期格式为yyyyMMdd,例如 date=20200531

appKey

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

lang

多语言设置,默认中文,当数据不匹配你设置的语言时,将返回英文或其本地语言结果。可选语言请参考多语言参数

unit

度量衡单位参数选择,例如温度选摄氏度或华氏度、公里或英里。默认公制单位

示例代码


     //历史天气
    QWeatherConfigInstance.publicID = @"publicID";
    QWeatherConfigInstance.appKey = @"key";
    QWeatherConfigInstance.appType = APP_TYPE_BIZ;    
    QWeatherConfigInstance.location = @"101010100";
    QWeatherConfigInstance.date = @"20200425";
    [QWeatherConfigInstance weatherWithInquireType:INQUIRE_TYPE_HISTORICAL_WEATHER WithSuccess:^(WeatherHistoricalBaseClass  *responseObject) {
        
        NSLog(@"描述->%@",[responseObject description]);
        
    } faileureForError:^(NSError *error) {
        NSLog(@"error->%@",error);
        
    }];
    //历史空气质量
      QWeatherConfigInstance.publicID = @"publicID";
    QWeatherConfigInstance.appKey = @"key";
    QWeatherConfigInstance.appType = APP_TYPE_BIZ;    QWeatherConfigInstance.location = @"101010100";
    QWeatherConfigInstance.date = @"20200425";
    [QWeatherConfigInstance weatherWithInquireType:INQUIRE_TYPE_HISTORICAL_AIR WithSuccess:^(WeatherHistoricalBaseClass  *responseObject) {
        
        NSLog(@"描述->%@",[responseObject description]);
        
    } faileureForError:^(NSError *error) {
        NSLog(@"error->%@",error);
        
    }];

返回数据

最近历史天气数据

参数 描述
code

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

fxLink

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

weatherDaily.date

当天日期

weatherDaily.sunrise

当天日出时间

weatherDaily.sunset

当天日落时间

weatherDaily.moonrise

当天月升时间

weatherDaily.moonset

当天月落时间

weatherDaily.moonPhase

当天月相名称

weatherDaily.tempMax

当天最高温度

weatherDaily.tempMin

当天最低温度

weatherDaily.precip

当天总降水量,默认单位:毫米

weatherHourly.time

当天时间

weatherHourly.temp

当天每小时温度,默认单位:摄氏度

weatherHourly.icon

当天每小时天气状况图标的代码,图标可通过天气状况和图标下载

weatherHourly.text

当天每小时天气状况的文字描述,包括阴晴雨雪等天气状态的描述

weatherHourly.wind360

当天每小时风向360角度

weatherHourly.windDir

当天每小时风向

weatherHourly.windScale

当天每小时风力

weatherHourly.windSpeed

当天每小时风速,公里/小时

weatherHourly.humidity

当天每小时相对湿度,百分比数值

weatherHourly.precip

当天每小时累计降水量,默认单位:毫米

weatherHourly.pressure

大气压强,默认单位:百帕

refer.sources

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

refer.license

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

最近空气质量历史数据

参数 描述
code

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

fxLink

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

airHourly.pubTime

空气质量数据发布时间

airHourly.aqi

空气质量指数

airHourly.level

空气质量指数等级

airHourly.category

空气质量指数级别

airHourly.primary

空气质量的主要污染物,空气质量为优时,返回值为NA

airHourly.pm10

PM10

airHourly.pm2p5

PM2.5

airHourly.no2

二氧化氮

airHourly.so2

二氧化硫

airHourly.co

一氧化碳

airHourly.o3

臭氧

refer.sources

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

refer.license

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