格点逐小时天气预报
基于数值模式的天气预报数据,提供全球指定坐标的逐小时天气预报,分辨率3-5公里。
提示: 格点天气预报是基于数值预报模型生成,不适宜与观测站数据对比。如需基于观测站的城市天气,请使用城市逐小时天气API。格点天气采用UTC 0时区表示时间。
| 接口代码 | 接口 | 数据类 | 
|---|---|---|
| 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数据许可或版权声明,可能为空