<!-- block-id: overview -->

## 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.

<!-- block-id: request -->

### API request

### Endpoint

### GET

```text
/wind-heights/1.0/forecast/power_generation
```

### Example of the API request

```text
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
```

<!-- block-id: params -->

## 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

```json
{
  "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
  }
}
```

<!-- block-id: response_fields -->

### 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.