Описание API: прогноз выработки СЭС и ВЭС по координатам

(пакет "Predict solar and wind")

API прогнозирует выработку электроэнергии от солнечных и ветряных электростанций по координатам и дате, используя метеопрогнозы от Проект // Эол 🌬️// и проверенные модели расчёта.

Технология предоставления:
RestAPI (JSON)

Аутентификация и ограничения:
API требует предоставления токена доступа (параметр - token) в параметрах запроса. Доступ предоставляется зарегистрированным пользователям, у которых активен пакет Predict solar and wind.

Параметры запроса

!!! Дата (параметр - date) расчёта в формате YYYY-MM-DD (без указания часов, только дата)
Обязательные параметры:
token: строка — уникальный токен доступа пользователя
lat: float — широта точки расчёта
lon: float — долгота точки расчёта
date: строка — дата расчёта в формате YYYY-MM-DD
kind: строка — тип генерации: ses (солнечная электростанция, по умолчанию) или ves (ветряная электростанция)

Для kind=ses (солнечные электростанции) доступны следующие параметры:
tilt: угол наклона панели, градусы (по умолчанию 30)
azimuth: азимут установки панели, градусы (по умолчанию 180)
panel_power: мощность одной панели, Вт (по умолчанию 300)
panel_kol: количество панелей (по умолчанию 1)
module_efficiency: коэффициент эффективности панели (по умолчанию 0.185)
albedo: коэффициент отражения поверхности, где установлена панель (по умолчанию 0.2)
pvrow_height: длина панели, м (по умолчанию 2)
pvrow_width: ширина панели, м (по умолчанию 1)
pitch: расстояние между рядами, м
temp_coeff: температурный коэффициент (по умолчанию -0.00306)

Для kind=ves (ветряные электростанции) доступны следующие параметры:
hub_height: высота оси турбины от 65 до 150, м (по умолчанию 100)
manufacturer: производитель турбины (по умолчанию Vestas). Выбирать только такие, какие есть в Справочник Кривые мощности ВЭУ, т.к. происходит подгрузка кривых мощностей, находящихся в базе данных (возможна подгрузка предоставленных Вами кривых мощностей, за подробностями просьба обращаться - email: mantesum@projecteol.ru)
model: модель турбины (по умолчанию V112/3000). Выбирать аналогично и в соответствие с manufacturer только такие, какие есть в Справочник Кривые мощности ВЭУ
turb_kol: количество турбин (по умолчанию 1)

Внутренний процесс

1. Координаты пользователя округляются до ближайших значений с шагом 0.25°, соответствующих узлам глобального метеопрогноза в базе данных Проект // Эол 🌬️//
2. Параметры запроса передаются в соответсвующую расчётную модель в зависимости от типа (параметр - kind) электростанции
3. Внутри задачи происходит:
  • Получение прогнозных метеоданных (скорость ветра, температура, давление, GHI, DNI и др.)
  • Расчёт мощности генерации с использованием расчётных моделей в зависимости от типа электростанции (параметр - kind)
  • Агрегация результатов в массив [дата/час → мощность]

Формат ответа (успешный ответ, значение power - кВт):
{ "status": "done", "result": [
...
  {
     "dt": "2025-05-22T06:00:00",
     "power": 0.05326
  },
  {
     "dt": "2025-05-22T07:00:00",
     "power": 0.15313
  },
  ...
] }

Примеры доступных запросов через API (по координатам на все часы суток):
Для одной панели солнечной электростанции без выбора дополнительных параметров (со стандартными характеристиками: мощность панели 300 Вт, угол наклона панели 30 градусов и т.д.):
https://projecteol.ru/api/forecast_energy/?lat=45&lon=37&date=2025-05-22&kind=ses&token={ВАШ_ТОКЕН}
Для одной панели солнечной электростанции с выбором установленной мощности панели (параметр - panel_power) 500 Вт:
https://projecteol.ru/api/forecast_energy/?lat=45&lon=37&date=2025-05-22&kind=ses&panel_power=500&token={ВАШ_ТОКЕН}
Для одной панели солнечной электростанции с выбором установленной мощности панели (параметр - panel_power) 500 Вт и коэффициента эффективности панели (параметр - module_efficiency) 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={ВАШ_ТОКЕН}
Для пятнадцати (параметр - panel_kol) панелей солнечной электростанции с выбором установленной мощности панели (параметр - panel_power) 500 Вт и коэффициента эффективности панели (параметр - module_efficiency) 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={ВАШ_ТОКЕН}


Для одной ветряной турбины без выбора дополнительных параметров (со стандартными характеристиками: высота установки гандолы - 100 метров, производитель - Vestas, модель - V112/3000):
https://projecteol.ru/api/forecast_energy/?lat=45&lon=37&date=2025-05-22&kind=ves&token={ВАШ_ТОКЕН}
Для двух (параметр - turb_kol) ветряных турбин, остальные характеристики стандартные: высота установки гандолы - 100 метров, производитель - Vestas, модель - V112/3000:
https://projecteol.ru/api/forecast_energy/?lat=45&lon=37&date=2025-05-22&kind=ves&turb_kol=2&token={ВАШ_ТОКЕН}
Для двух (параметр - turb_kol) ветряных турбин с высотой (параметр - hub_height) установки гандолы 130 метров над землей (по умолчанию производитель - Vestas, модель - 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={ВАШ_ТОКЕН}
Для двух (параметр - turb_kol) ветряных турбин с высотой (параметр - hub_height) установки гандолы 130 метров над землей (по умолчанию производитель - Vestas, модель - 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={ВАШ_ТОКЕН}
Для двух (параметр - turb_kol) ветряных турбин с высотой (параметр - hub_height) установки гандолы 130 метров над землей, производитель (параметр - manufacturer) - Siemens, модель (параметр - 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={ВАШ_ТОКЕН}