Grid Weather Hourly Forecast

Weather forecast data based on numerical models, to provide hourly weather forecasts at specified coordinates around the world, with a spatial resolution of 3-5 kilometers.

Hint: The grid weather data is based on Numerical Weather Prediction (NWP) models, and it is not suitable for comparison with observation station data. For station-based city weather data, please refer to the City Weather API. Grid weather uses UTC+0 as the time zone.

Parameters

GridWeatherParameter

Sample code

Swift

Task{
    do {
        let parameter = GridWeatherParameter(longitude: 116.41, latitude: 39.92)
        /*
        * Hourly Forecast by Grid (24hrs)
        */
        let _ = try await QWeather.instance
            .grid24h(parameter)
        
        /*
        * Hourly Forecast by Grid (72hrs)
        */
        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);
    }
};

/*
* Hourly Forecast by Grid (24hrs)
*/
[QWeatherObjc grid24h:parameter completionHandler:handler];

/*
* Hourly Forecast by Grid (72hrs)
*/
[QWeatherObjc grid72h:parameter completionHandler:handler];

Response

GridHourlyResponse

• code See Status Code
• updateTime API last update time
• fxLink Responsive web page of this data, for embedded in website or APP
• hourly.fxTime Forecast time
• hourly.temp temperature
• hourly.icon Icon code for weather conditions. See also QWeather Icons
• hourly.text Weather conditions
• hourly.wind360 Wind direction in azimuth degree
• hourly.windDir Wind direction
• hourly.windScale Wind scale
• hourly.windSpeed Wind speed, KM/H
• hourly.humidity Relative humidity in percent
• hourly.precip Accumulated precipitation in the current hour
• hourly.cloud Cloud cover in percent, may be null
• hourly.dew Dew point temperature, may be null
• refer.sources Data source and other statements, may be null
• refer.license Data license, may be null