Wind API
Wind API
This spec covers REST endpoint:
/wind-heights/1.0/forecastThe Wind API provides wind speed and direction forecasts at specific altitudes above ground level. The API calculates atmospheric pressure levels corresponding to the requested altitude and returns detailed wind and temperature forecasts at 15-minute intervals.
Get Current Pollen
HTTP
http://demo.openweathermap.org/wind-heights/1.0/forecast?http://demo.openweathermap.org/wind-heights/1.0/forecast?lat=40.7128&lon=-74.006&altitude_meters=100&max_hours=2&appid=CLIENT_API_KEYName | Type | Required | Description |
lat | number | ✓ | Latitude in decimal degrees (-90...90) |
lon | number | ✓ | Longitude in decimal degrees (-180...180) |
altitude_meters | number | ✓ | Target altitude above ground level in meters (0 to 1,000) |
appid | string | ✓ | Open Weather API key |
max_hours | number | - | Maximum number of hours for forecast data |
{
"latitude": 40.7128,
"longitude": -74.006,
"altitude_meters": 100,
"elevation_meters": 5,
"target_pressure_hpa": 1001,
"timestamp": "2025-08-28T11:04:21.528243",
"step_minutes": 15,
"forecast_data": [
{
"forecast_timestamp": "2025-08-28T00:00:00",
"wind_1001hPa": {
"speed": 6.6,
"direction": 324.6,
"units": {
"speed": "m/s",
"direction": "degrees"
},
"height": 1001
},
"temperature_1001hPa": {
"value": 20.34,
"units": "Celsius",
"height": 1001
}
},
{
"forecast_timestamp": "2025-08-28T00:15:00",
"wind_1001hPa": {
"speed": 6.33,
"direction": 324.9,
"units": {
"speed": "m/s",
"direction": "degrees"
},
"height": 1001
},
"temperature_1001hPa": {
"value": 20.25,
"units": "Celsius",
"height": 1001
}
},
// …hourly steps up to requested/available horizon
}HTTP | Meaning | Payload example |
400 | Validation error (e.g., missing/invalid required parameter lat, lon, altitude_meters) | {"error":"Missing lat/lon parameters in query"} |
401 | Unauthorized (bad appid) | {"cod":401,"message":"Invalid API key"} |
429 | Rate limited | {"cod":429,"message":"Too many requests"} |
500 | Internal server error | {"cod":500,"message":"Internal error"} |