Resources
Premium Wind Power

Create Resource

Create a new premium wind power site. Required fields: name, latitude, longitude, capacity. Optional fields with defaults: rotor_diameter (100m), hub_height (80m), number_of_turbines (1), cut_in_wind_speed (3 m/s), cut_out_wind_speed (25 m/s), rated_wind_speed (12 m/s), allow_negative_power (false).

post/resources/wind_power_site

Request body

namestring required

The name of the resource.

latitudenumber double required

The latitude of the resource. Must be a decimal number between -90 and 90.

longitudenumber double required

The longitude of the resource. Must be a decimal number between -180 and 180.

capacitynumber double nullable required

The site capacity (rated power × number of turbines) in MW.

resource_idstring

The unique identifier of the resource.

rotor_diameternumber double nullable

Average diameter of turbine rotor in metres. Must be between 20 and 200.

rated_powernumber double nullable

Average turbine rated power in MW. Must be between 0.1 and 15000.

hub_heightnumber double nullable

Average height of turbine hub in metres. Must be between 10 and 200. Defaults to 80.

number_of_turbinesinteger nullable

Total number of turbines at site. Must be between 1 and 500. Defaults to 1.

cut_in_wind_speednumber double nullable

Minimum wind speed for generation in m/s. Must be between 0 and 10. Defaults to 3.

cut_out_wind_speednumber double nullable

Maximum wind speed before shutdown in m/s. Must be between 15 and 35. Defaults to 25.

rated_wind_speednumber double nullable

Wind speed at rated power in m/s. Must be between 8 and 20. Defaults to 12.

allow_negative_powerboolean nullable

Whether forecasts for this site may contain negative power values. Defaults to false. This setting is used when predictions are produced; the API does not modify forecast values.

grid_export_limitnumber double nullable

Optional maximum power export allowed by the site's grid connection, in MW. Omit this field when no limit is configured. Values >= 0 configure a limit. Value of -1 is treated as no configured limit. A configured limit will be in effect the next time predictions are updated.

Response

OK

resource_idstring

The unique identifier of the resource.

namestring

The name of the resource.

latitudenumber double

The latitude of the resource. Must be a decimal number between -90 and 90.

longitudenumber double

The longitude of the resource. Must be between -180 and 180.

capacitynumber double nullable

The site capacity (rated power × number of turbines) in MW.

rotor_diameternumber double nullable

Average diameter of turbine rotor in metres. Must be between 20 and 200.

rated_powernumber double nullable

Average turbine rated power in MW. Must be between 0.1 and 15000.

hub_heightnumber double nullable

Average height of turbine hub in metres. Must be between 10 and 200. Defaults to 80.

number_of_turbinesinteger nullable

Total number of turbines at site. Must be between 1 and 500. Defaults to 1.

cut_in_wind_speednumber double nullable

Minimum wind speed for generation in m/s. Must be between 0 and 10. Defaults to 3.

cut_out_wind_speednumber double nullable

Maximum wind speed before shutdown in m/s. Must be between 15 and 35. Defaults to 25.

rated_wind_speednumber double nullable

Wind speed at rated power in m/s. Must be between 8 and 20. Defaults to 12.

allow_negative_powerboolean nullable

Whether forecasts for this site may contain negative power values. Defaults to false. This setting is used when predictions are produced; the API does not modify forecast values.

grid_export_limitnumber double nullable

Optional maximum power export allowed by the site's grid connection, in MW. Omit this field when no limit is configured. Values >= 0 configure a limit. Value of -1 is treated as no configured limit. A configured limit will be in effect the next time predictions are updated.

Changes