天气时光机

平台: API iOS Android

获取最近10天的天气历史再分析数据。

例如今天是12月30日,最多可获取12月20日至12月29日的天气历史数据。

和风天气额外提供了2000年至今的历史再分析气象数据,通过数据文件的形式发送,如需要长时间的历史气象数据数据,请提供下列信息,发送邮件至sales@qweather.com,我们将有专人与你联系:

  • 企业名称
  • 联系方式
  • 所需要的城市或坐标
  • 所需要的时间范围
接口代码(枚举) 接口 数据类
INQUIRE_TYPE_HISTORICAL_WEATHER 历史天气 WeatherHistoricalBaseClass

请求参数

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

  • location(必选)需要查询的地区,仅支持LocationID,LocationID可通过城市搜索服务获取。例如 location=101010100
  • date(必选)选择日期,最多可选择最近10天(不包含今天)的数据。日期格式为yyyyMMdd,例如 date=20200531
  • appKey(必选)用户认证key,请参考如何获取你的KEY。例如 appKey=123456789ABC
  • lang多语言设置,当数据不匹配你设置的语言时,将返回英文或其本地语言结果。可选语言请参考多语言参数
  • unit数据单位设置,可选值包括unit=m(公制单位,默认)和unit=i(英制单位)。更多选项和说明参考度量衡单位

示例代码

    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);

返回数据

  • 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 数据许可或版权声明,可能为空