API Description: Forecast of PV and Wind Power Generation by Coordinates

(plan "Predict solar and wind")

The API forecasts electricity generation from solar and wind power plants by coordinates and date, using weather forecasts from Project // Eol 🌬️// and validated calculation models.

Delivery Method:
RestAPI (JSON)

Authentication and limitations:
The API requires a valid access token (parameter - token) in the request parameters. Access is granted to registered users with an active Predict solar and wind package.

Request parameters

!!! Date (parameter - date) must be in the format YYYY-MM-DD (only the date, no time)
Required parameters:
token: string — user's unique access token
lat: float — latitude of the calculation point
lon: float — longitude of the calculation point
date: string — calculation date in YYYY-MM-DD format
kind: string — generation type: ses (solar power plant, default) or ves (wind power plant)

For kind=ses (solar power plants), the following parameters are available:
tilt: panel tilt angle in degrees (default is 30)
azimuth: panel azimuth in degrees (default is 180)
panel_power: power of one panel in watts (default is 300)
panel_kol: number of panels (default is 1)
module_efficiency: panel efficiency coefficient (default is 0.185)
albedo: surface albedo where the panel is installed (default is 0.2)
pvrow_height: panel length in meters (default is 2)
pvrow_width: panel width in meters (default is 1)
pitch: distance between panel rows in meters
temp_coeff: temperature coefficient (default is -0.00306)

For kind=ves (wind power plants), the following parameters are available:
hub_height: hub height of the turbine from 65 to 150 meters (default is 100)
manufacturer: turbine manufacturer (default is Vestas). Select only from those listed in the Wind Turbine Power Curve Reference, because the power curves in the database are being loaded (it is possible to load the power curves you provide, please contact us for details) - email: mantesum@projecteol.ru)
model: turbine model (default is V112/3000). Select accordingly and consistent with the manufacturer only from those listed in the Wind Turbine Power Curve Reference
turb_kol: number of turbines (default is 1)

Internal process

1. The user's coordinates are rounded to the nearest 0.25° to match nodes in the global weather forecast grid from Project // Eol 🌬️//
2. Request parameters are passed to the corresponding calculation model depending on the plant type (parameter - kind) power plants
3. Internally, the process involves:
  • Obtaining forecast weather data (wind speed, temperature, pressure, GHI, DNI, etc.)
  • Calculating power generation using calculation models depending on the plant type (parameter - kind)
  • Aggregating results into an array [date/hour → power]

Response format (successful response, power in kW):
{ "status": "done", "result": [
...
  {
     "dt": "2025-05-22T06:00:00",
     "power": 0.05326
  },
  {
     "dt": "2025-05-22T07:00:00",
     "power": 0.15313
  },
  ...
] }

Examples of available API requests (by coordinates for all hours of the day):
For a single solar panel without selecting additional parameters (with standard specifications: panel power 300 W, panel tilt angle 30 degrees, etc.):
https://projecteol.ru/api/forecast_energy/?lat=45&lon=37&date=2025-05-22&kind=ses&token={YOUR_TOKEN}
For a single solar panel with selected panel power (parameter - panel_power) of 500 W:
https://projecteol.ru/api/forecast_energy/?lat=45&lon=37&date=2025-05-22&kind=ses&panel_power=500&token={YOUR_TOKEN}
For a single solar panel with selected panel power (parameter - panel_power) of 500 W and panel efficiency coefficient (parameter - module_efficiency) of 0.15:
https://projecteol.ru/api/forecast_energy/?lat=45&lon=37&date=2025-05-22&kind=ses&panel_power=500&module_efficiency=0.15&token={YOUR_TOKEN}
For fifteen (parameter - panel_kol) solar panels with selected panel power (parameter - panel_power) of 500 W and panel efficiency coefficient (parameter - module_efficiency) of 0.15:
https://projecteol.ru/api/forecast_energy/?lat=45&lon=37&date=2025-05-22&kind=ses&panel_kol=15&panel_power=500&module_efficiency=0.15&token={YOUR_TOKEN}


For a single wind turbine without selecting additional parameters (with standard specifications: hub height 100 meters, manufacturer - Vestas, model - V112/3000):
https://projecteol.ru/api/forecast_energy/?lat=45&lon=37&date=2025-05-22&kind=ves&token={YOUR_TOKEN}
For two (parameter - turb_kol) wind turbines, other specifications are standard: hub height 100 meters, manufacturer - Vestas, model - V112/3000:
https://projecteol.ru/api/forecast_energy/?lat=45&lon=37&date=2025-05-22&kind=ves&turb_kol=2&token={YOUR_TOKEN}
For two (parameter - turb_kol) wind turbines with hub height (parameter - hub_height) of 130 meters above ground (default manufacturer - Vestas, model - V112/3000):
https://projecteol.ru/api/forecast_energy/?lat=45&lon=37&date=2025-05-22&kind=ves&turb_kol=2&hub_height=130&token={YOUR_TOKEN}
For two (parameter - turb_kol) wind turbines with hub height (parameter - hub_height) of 130 meters above ground (default manufacturer - Vestas, model - V112/3000):
https://projecteol.ru/api/forecast_energy/?lat=45&lon=37&date=2025-05-22&kind=ves&turb_kol=2&hub_height=130&token={YOUR_TOKEN}
For two (parameter - turb_kol) wind turbines with hub height (parameter - hub_height) of 130 meters above ground, manufacturer (parameter - manufacturer) - Siemens, model (parameter - model) - SWT113/2300:
https://projecteol.ru/api/forecast_energy/?lat=45&lon=37&date=2025-05-22&kind=ves&turb_kol=2&hub_height=130&manufacturer=Siemens&model=SWT113/2300&token={YOUR_TOKEN}