Documentation

Wind Energy Prediction API

Product Overview

Wind Energy Prediction API provides a forecast of expected electricity generation for wind turbines at a specified location.

The API combines high-resolution wind forecasts with turbine performance parameters to estimate the expected power output.

The forecast is provided with a 15-minute time step and covers up to 16 days ahead, enabling accurate planning for renewable energy operations, grid management, and energy trading.

The API allows users to configure turbine characteristics and operational parameters to better reflect the real-world performance of specific wind turbines.

API request

Endpoint

GET

/wind-heights/1.0/forecast/power_generation

Example of the API request

https://demo.openweathermap.org/wind-
heights/1.0/forecast/power_generation?lat=40.7128&lon=-74.006&altitude_meters=10&turbine_power_w=80000&cut_in_speed=1&appid=YOUR_API_KEY

API request parameters

Required parameters

Parameter	Type	Description
lat	float	Latitude of the location
lon	float	Longitude of the location
altitude_meters	integer	Height of the wind turbine hub above ground level in meters
turbine_power_w	integer	Rated power of the wind turbine in watts

Optional turbine configuration parameters

These parameters allow tuning the turbine power curve and operational characteristics. If not provided, the API uses default values.

Parameter	Type	Default value	Description
cut_in_speed	float	3.0	Wind speed (m/s) at which the turbine starts generating power
rated_speed	float	12.0	Wind speed (m/s) at which the turbine reaches rated power output
cut_out_speed	float	25.0	Wind speed (m/s) at which the turbine shuts down to prevent damage
reference_density	float	1.225	Reference air density (kg/m³) used for power calculations
gas_constant_dry_air	float	287.05	Gas constant for dry air used in density calculations
availability_factor	float	0.95	Fraction of time the turbine is available for operation (accounts for maintenance and downtime)
electrical_losses	float	0.97	Efficiency factor accounting for electrical system losses
wake_losses	float	0.90	Efficiency factor accounting for wake effects and aerodynamic losses in wind farms

API response example

{
  "latitude": 40.7128,
  "longitude": -74.006,
  "altitude_meters": 10,
  "elevation_meters": 5,
  "target_pressure_hpa": 1011,
  "turbine_power_w": 80000,
  "step_minutes": 15,
  "timestamp": "2026-03-16T11:10:41.896670",
  "forecast_data": [
    {
    "forecast_timestamp": "2026-03-16T00:00:00",
    "temperature_1011hPa": {
      "value": 6.13,
      "units": "Celsius",
      "height": 1011
    },
    "wind_1011hPa": {
      "speed": 6.8,
      "direction": 112.4,
      "units": {
      "speed": "m/s",
        "direction": "degrees"
      },
      "height": 1011
    },
    "generated_power_w": 12397.56
    },
    {
      "forecast_timestamp": "2026-03-16T00:15:00",
      "temperature_1011hPa": {
        "value": 6.23,
        "units": "Celsius",
        "height": 1011
      },
      "wind_1011hPa": {
        "speed": 6.81,
        "direction": 113.7,
        "units": {
          "speed": "m/s",
          "direction": "degrees"
        },
        "height": 1011
      },
      "generated_power_w": 12448.03
    },
    {
      "forecast_timestamp": "2026-03-16T00:30:00",
      "temperature_1011hPa": {
        "value": 6.33,
        "units": "Celsius",
        "height": 1011
      },
      "wind_1011hPa": {
        "speed": 6.83,
        "direction": 115.1,
        "units": {
          "speed": "m/s",
          "direction": "degrees"
        },
        "height": 1011
      },
      "generated_power_w": 12553.86
    },
  …
  ],
  "algorithm_parameters": {
    "cut_in_speed": 1,
    "rated_speed": 12,
    "cut_out_speed": 25,
    "reference_density": 1.225,
    "gas_constant_dry_air": 287.05,
    "availability_factor": 0.95,
    "electrical_losses": 0.97,
    "wake_losses": 0.9,
    "use_density_correction": true
  }
}

API response fields

latitude - Latitude of the location, decimal (−90; 90)
longitude - Longitude of the location, decimal (-180; 180)
altitude_meters - Requested turbine hub height above ground level in meters.
elevation_meters - Ground elevation at the requested location in meters above sea level.
target_pressure_hpa - Atmospheric pressure level used to derive wind and temperature values corresponding to the turbine hub height.
turbine_power_w - Rated power of the wind turbine in watts used in the generation calculations.
step_minutes - Temporal resolution of the forecast data in minutes.
timestamp - Time when the forecast was generated.
forecast_data

forecast_data.forecast_timestamp - Timestamp of the forecasted data point.
forecast_data.temperature_1011hPa - Air temperature at the pressure level corresponding to the turbine hub height.

forecast_data.temperature_1011hPa.value - Forecast temperature value.
forecast_data.temperature_1011hPa.units - Units of temperature measurement (Celsius).
forecast_data.temperature_1011hPa.height - Pressure level (hPa) used to derive temperature data.

forecast_data.wind_1011hPa - Wind conditions at the pressure level corresponding to the turbine hub height.

forecast_data.wind_1011hPa.speed - Wind speed.
forecast_data.wind_1011hPa.direction - Wind direction in degrees (meteorological convention).
forecast_data.wind_1011hPa.units.speed - Units of wind speed (m/s).
forecast_data.wind_1011hPa.units.direction - Units of wind direction (degrees).
forecast_data.wind_1011hPa.height - Pressure level (hPa) used to derive wind data.

forecast_data.generated_power_w - Estimated electrical power generation of the wind turbine in watts for the given time step.

algorithm_parameters

algorithm_parameters.cut_in_speed - Wind speed (m/s) at which the turbine starts generating electricity.
algorithm_parameters.rated_speed - Wind speed (m/s) at which the turbine reaches its rated power output.
algorithm_parameters.cut_out_speed - Wind speed (m/s) at which the turbine automatically shuts down for safety.
algorithm_parameters.reference_density - Reference air density (kg/m³) used for turbine power calculations.
algorithm_parameters.gas_constant_dry_air - Gas constant used for dry air density calculations.
algorithm_parameters.availability_factor - Operational availability factor accounting for maintenance downtime.
algorithm_parameters.electrical_losses - Efficiency factor accounting for electrical losses.
algorithm_parameters.wake_losses - Efficiency factor accounting for aerodynamic wake effects in wind farms.
algorithm_parameters.use_density_correction - Indicates whether air density correction was applied in the power generation calculations.

API response example

{
  "latitude": 40.7128,
  "longitude": -74.006,
  "altitude_meters": 10,
  "elevation_meters": 5,
  "target_pressure_hpa": 1011,
  "turbine_power_w": 80000,
  "step_minutes": 15,
  "timestamp": "2026-03-16T11:10:41.896670",
  "forecast_data": [
    {
    "forecast_timestamp": "2026-03-16T00:00:00",
    "temperature_1011hPa": {
      "value": 6.13,
      "units": "Celsius",
      "height": 1011
    },
    "wind_1011hPa": {
      "speed": 6.8,
      "direction": 112.4,
      "units": {
      "speed": "m/s",
        "direction": "degrees"
      },
      "height": 1011
    },
    "generated_power_w": 12397.56
    },
    {
      "forecast_timestamp": "2026-03-16T00:15:00",
      "temperature_1011hPa": {
        "value": 6.23,
        "units": "Celsius",
        "height": 1011
      },
      "wind_1011hPa": {
        "speed": 6.81,
        "direction": 113.7,
        "units": {
          "speed": "m/s",
          "direction": "degrees"
        },
        "height": 1011
      },
      "generated_power_w": 12448.03
    },
    {
      "forecast_timestamp": "2026-03-16T00:30:00",
      "temperature_1011hPa": {
        "value": 6.33,
        "units": "Celsius",
        "height": 1011
      },
      "wind_1011hPa": {
        "speed": 6.83,
        "direction": 115.1,
        "units": {
          "speed": "m/s",
          "direction": "degrees"
        },
        "height": 1011
      },
      "generated_power_w": 12553.86
    },
  …
  ],
  "algorithm_parameters": {
    "cut_in_speed": 1,
    "rated_speed": 12,
    "cut_out_speed": 25,
    "reference_density": 1.225,
    "gas_constant_dry_air": 287.05,
    "availability_factor": 0.95,
    "electrical_losses": 0.97,
    "wake_losses": 0.9,
    "use_density_correction": true
  }
}