格点每日天气预报
基于数值模式的天气预报数据,提供全球指定坐标的每日天气预报,分辨率3-5公里。
提示: 格点天气预报是基于数值预报模型生成,不适宜与观测站数据对比。如需基于观测站的城市天气,请使用城市每日天气API。格点天气采用UTC 0时区表示时间。
| 接口代码 | 接口 | 数据类 | 
|---|---|---|
| grid3d | 格点3天预报 | GridDailyResponse | 
| grid7d | 格点7天预报 | GridDailyResponse | 
参数
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)
        /*
        * 格点3天预报
        */
        let _ = try await QWeather.instance
            .grid3d(parameter)
        
        /*
        * 格点7天预报
        */
        let _ = try await QWeather.instance
            .grid7d(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)(GridDailyResponse *, NSError *) = ^(GridDailyResponse *response,
    NSError *error) {
    if (response) {
        NSLog(@"%@", response.description);
    }
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    }
};
/*
* 格点3天预报
*/
[QWeatherObjc grid3d:parameter completionHandler:handler];
/*
* 格点7天预报
*/
[QWeatherObjc grid7d:parameter completionHandler:handler];
返回数据
GridDailyResponse
- 
        code请参考状态码
- 
        updateTime当前API的最近更新时间
- 
        fxLink当前数据的响应式页面,便于嵌入网站或应用
- 
        daily.fxDate预报日期
- 
        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.humidity相对湿度,百分比数值
- 
        daily.pressure大气压强,默认单位:百帕
- 
        refer.sources原始数据来源,或数据源说明,可能为空
- 
        refer.license数据许可或版权声明,可能为空