历史天气和空气质量
适用于 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 |
空气质量的主要污染物,空气质量为优时,返回值为 |
airHourly.pm10 |
PM10 |
airHourly.pm2p5 |
PM2.5 |
airHourly.no2 |
二氧化氮 |
airHourly.so2 |
二氧化硫 |
airHourly.co |
一氧化碳 |
airHourly.o3 |
臭氧 |
refer.sources |
原始数据来源,或数据源说明,可能为空 |
refer.license |
数据许可或版权声明,可能为空 |