实时天气和预报

适用于 iOS SDK v4.8+

天气预报和实况

全国4000+个市县区和海外15万个城市天气数据,包括实时温度、体感温度、风力风向、相对湿度、大气压强、降水量、能见度、露点温度、云量等数据。

接口代码(枚举) 接口 数据类
INQUIRE_TYPE_WEATHER_NOW 实况天气 WeatherBaseClass
INQUIRE_TYPE_WEATHER_3D 3天预报 WeatherBaseClass
INQUIRE_TYPE_WEATHER_7D 7天预报 WeatherBaseClass
INQUIRE_TYPE_WEATHER_10D 10天预报 WeatherBaseClass
INQUIRE_TYPE_WEATHER_15D 15天预报 WeatherBaseClass
INQUIRE_TYPE_WEATHER_24H 24小时预报况 WeatherBaseClass
INQUIRE_TYPE_WEATHER_72H 72小时预报况 WeatherBaseClass
INQUIRE_TYPE_WEATHER_168H 168小时预报况 WeatherBaseClass

请求参数

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

location

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

appKey

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

lang

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

unit

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

示例代码

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

返回数据

参数 描述
code

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

updateTime

当前API的最近更新时间

fxLink

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

now.obsTime

数据观测时间

now.temp

温度,默认单位:摄氏度

now.feelsLike

体感温度,默认单位:摄氏度

now.icon

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

now.text

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

now.wind360

风向360角度

now.windDir

风向

now.windScale

风力等级

now.windSpeed

风速,公里/小时

now.humidity

相对湿度,百分比数值

now.precip

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

now.pressure

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

now.vis

能见度,默认单位:公里

now.cloud

云量,百分比数值。可能为空

now.dew

露点温度。可能为空

daily.fxDate

预报日期

daily.sunrise

日出时间

daily.sunset

日落时间

daily.moonrise

月升时间

daily.moonset

月落时间

daily.moonPhase

月相名称

daily.moonPhaseIcon

月相图标代码,图标可通过天气状况和图标下载

daily.tempMax

预报当天最高温度

daily.tempMin

预报当天最低温度

daily.iconDay

预报白天天气状况的图标代码,图标可通过天气状况和图标下载

daily.textDay

预报白天天气状况文字描述,包括阴晴雨雪等天气状态的描述

daily.iconNight

预报夜间天气状况的图标代码,图标可通过天气状况和图标下载

daily.textNight

预报晚间天气状况文字描述,包括阴晴雨雪等天气状态的描述

daily.wind360Day

预报白天风向360角度

daily.windDirDay

预报白天风向

daily.windScaleDay

预报白天风力等级

daily.windSpeedDay

预报白天风速,公里/小时

daily.wind360Night

预报夜间风向360角度

daily.windDirNight

预报夜间当天风向

daily.windScaleNight

预报夜间风力等级

daily.windSpeedNight

预报夜间风速,公里/小时

daily.precip

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

daily.uvIndex

紫外线强度指数

daily.humidity

相对湿度,百分比数值

daily.pressure

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

daily.vis

能见度,默认单位:公里

daily.cloud

云量,百分比数值。可能为空

hourly.fxTime

预报时间

hourly.temp

温度,默认单位:摄氏度

hourly.icon

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

hourly.text

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

hourly.wind360

风向360角度

hourly.windDir

风向

hourly.windScale

风力等级

hourly.windSpeed

风速,公里/小时

hourly.humidity

相对湿度,百分比数值

hourly.precip

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

hourly.pop

逐小时预报降水概率,百分比数值,可能为空

hourly.pressure

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

hourly.cloud

云量,百分比数值。可能为空

hourly.dew

露点温度。可能为空

refer.sources

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

refer.license

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

分钟降水

分钟级降水提供中国地区未来2小时内每5分钟降水数据、降水类型以及未来2小时的降水概况信息。可实现精确到1公里格点的全国分钟级降雨/降雪预报,为每一分钟的降雨进行预测。

接口代码(枚举) 接口 数据类
INQUIRE_TYPE_WEATHER_MINUTELY 分钟降水 WeatherMinutelyBaseClass

接口参数

location

需要查询地区的以英文逗号分隔的经度,纬度坐标(十进制,最多支持小数点后两位)。例如 location=116.41,39.92

appKey

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

lang

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

示例代码

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

返回数据

参数 描述
code

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

updateTime

当前API的最近更新时间

fxLink

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

summary

分钟降水描述

minutely.fxTime

预报时间

minutely.precip

10分钟累计降水量,单位毫米

minutely.type

降水类型
rain
snow

refer.sources

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

refer.license

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