格点逐小时天气预报

平台: API iOS Android

基于全球任意坐标的高精度逐小时天气预报,精确到3-5公里范围,包括温度、湿度、大气压、天气状况、风力、风向等。

接口代码 接口 数据类
grid24h 逐小时预报(未来24小时) GridHourlyResponse
grid72h 逐小时预报(未来72小时) GridHourlyResponse

参数

GridWeatherParameter

参数名 参数类型 必选 示例值
longitude Double 116.41
latitude Double 39.92
lang Lang ZH_HANS
unit Unit METRIC

代码示例

Swift

Task{
    do {
        let parameter = GridWeatherParameter(longitude: 116.41, latitude: 39.92)
        /*
        * 逐小时预报(未来24小时)
        */
        let _ = try await QWeather.instance
            .grid24h(parameter)
        
        /*
        * 逐小时预报(未来72小时)
        */
        let _ = try await QWeather.instance
            .grid72h(parameter)

    } catch QWeatherError.errorResponse(let error) {
        print(error)
    } catch {
        print(error)
    }
}

Objective-C

GridWeatherParameter *parameter = [GridWeatherParameter instanceWithLongitude:116.41 latitude:39.92 lang:@(LangZH_HANS) unit:@(UnitMETRIC)];

void (^handler)(GridHourlyResponse *, NSError *) = ^(GridHourlyResponse *response,
    NSError *error) {
    if (response) {
        NSLog(@"%@", response.description);
    }
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    }
};

/*
* 逐小时预报(未来24小时)
*/
[QWeatherObjc grid24h:parameter completionHandler:handler];

/*
* 逐小时预报(未来72小时)
*/
[QWeatherObjc grid72h:parameter completionHandler:handler];

返回数据

GridHourlyResponse

  • code 请参考状态码
  • updateTime 当前API的最近更新时间
  • fxLink 当前数据的响应式页面,便于嵌入网站或应用
  • hourly.fxTime 预报时间
  • hourly.temp 温度,默认单位:摄氏度
  • hourly.icon 天气状况的图标代码,另请参考天气图标项目
  • hourly.text 天气状况的文字描述,包括阴晴雨雪等天气状态的描述
  • hourly.wind360 风向360角度
  • hourly.windDir 风向
  • hourly.windScale 风力等级
  • hourly.windSpeed 风速,公里/小时
  • hourly.humidity 相对湿度,百分比数值
  • hourly.precip 当前小时累计降水量,默认单位:毫米
  • hourly.cloud 云量,百分比数值。可能为空
  • hourly.dew 露点温度。可能为空
  • refer.sources 原始数据来源,或数据源说明,可能为空
  • refer.license 数据许可或版权声明,可能为空