ioBroker.open-meteo-weather

Важная информация:

В этот адаптер теперь интегрированы Open Meteo Weather и Open Meteo PV Forecast. Поддержка Open Meteo PV Forecast прекращена.

Этот адаптер использует библиотеки Sentry для автоматического сообщения разработчикам об исключениях и ошибках в коде. Для получения более подробной информации и инструкций по отключению сообщений об ошибках, пожалуйста, обратитесь к документации Sentry-Plugin ! Использование системы отчетности Sentry начинается с версии js-controller 3.0.

Я использую собственный сервер Sentry на базе Glitchtip.

Адаптер сервиса прогнозирования погоды и солнечной активности Open-Meteo для ioBroker.

Этот адаптер предоставляет точные данные о погоде, прогнозы, информацию о качестве воздуха, содержании пыльцы и прогнозы выработки солнечной энергии на основе данных Open-Meteo.com . Он бесплатен для некоммерческого использования (менее 10 000 вызовов API в день) и не требует регистрации ключа API, что делает процесс настройки чрезвычайно простым.

Если адаптер столкнется с такими проблемами, как тайм-ауты или ошибки сервера, вы можете проверить состояние сервера Open-Meteo .

Особенности Погода

• Актуальные данные о погоде: получение данных о температуре, влажности, атмосферном давлении и ветре в режиме реального времени.
• 15-минутный прогноз с максимальным количеством 16 наборов данных на следующие 4 часа.
• Гибкие прогнозы: настраиваемое количество дней прогноза и почасовое разрешение.
• Качество воздуха и пыльца: Дополнительные данные по твердым частицам (PM2.5, PM10), а также различным видам пыльцы (ольха, береза, трава и т. д.).
• Автоматическая очистка: Адаптер автоматически очищает структуру объекта, если периоды прогнозирования сокращаются или изменяются в конфигурации.
• Поддержка нескольких языков: Поддерживает 11 языков (включая английский, немецкий, польский, русский, французский, китайский и др.).
• Система единиц измерения: Плавное переключение между метрической (°C, км/ч) и имперской (°F, миль/ч) системами.
• Добавление нескольких местоположений: Добавьте несколько местоположений.
• Ночные иконки: Вы можете выбрать один из двух наборов ночных иконок: «Светлый» и «Темный». Это упрощает подбор иконки под фон вашего помещения.

Значки направления ветра

В настройках адаптера можно выбрать один из двух стилей отображения направления ветра:

• Направление ветра (куда дует ветер): это стандартная настройка. Стрелка указывает направление ветра. (Например: при северном ветре стрелка указывает на юг).

• Источник ветра (место, откуда дует ветер): В этом стиле используются значки из подпапки direct_2. Стрелка указывает на источник ветра. (Например: северный ветер обозначается стрелкой, указывающей на север, или конкретным значком «источника»).

Данные о качестве воздуха

Адаптер предоставляет актуальные данные о качестве воздуха и ежедневный прогноз на ближайшие дни (с возможностью настройки на 1, 3 или 6 дней).

Эффективная обработка данных: В то время как API Open-Meteo предоставляет только необработанные почасовые данные, этот адаптер интеллектуально агрегирует эти значения. Он автоматически рассчитывает суточные максимумы для всех загрязняющих веществ и уровней пыльцы. Это позволяет получить наиболее актуальные данные (пиковые уровни воздействия) без перегрузки базы данных сотнями почасовых точек данных.

Функции:

• Ежедневные пиковые значения: Получите максимально ожидаемые значения для PM2.5, PM10, озона и различных типов пыльцы.

• Удобочитаемый формат: Уровень пыльцы автоматически сопоставляется с описательными категориями (например, «Отсутствует», «Низкий», «Умеренный», «Высокий»).

• Интеллектуальная очистка: объекты для прогнозируемых дней автоматически создаются или удаляются в зависимости от ваших настроек, чтобы поддерживать чистоту дерева объектов.

Конфигурация

После установки настройте следующие поля в параметрах экземпляра:

1. Местоположение: Укажите ваше местоположение или желаемое название.
2. Координаты (широта и долгота): Добавьте свои координаты. Вы можете найти их, нажав кнопку «Найти координаты с помощью OpenStreetMap», или оставить поля пустыми, чтобы использовать системные координаты.
3. Часовой пояс: выберите часовой пояс в выпадающем меню; по умолчанию установлено значение «Авто», которое автоматически настраивается в зависимости от ваших координат.
4. Интервал обновления: временной интервал в минутах (по умолчанию: 30 мин).
5. Количество дней прогноза: число дней для ежедневного обзора (0–16 дней).
6. Почасовой прогноз: включите или выключите эту опцию и укажите количество часов (например, следующие 24 часа). Например, hour0 — это текущий час, hour1 — следующий час и так далее.
7. Дополнительные данные: флажки для указания данных о пыльце и качестве воздуха.
8. Единицы измерения: выберите между метрической и имперской системами.

Виджет погоды

Этот адаптер предлагает два способа отображения данных о погоде в вашей визуализации:

1. Встроенный виджет (стандартный)

Начиная с версии 3.1.0 , адаптер может автоматически генерировать предварительно настроенный HTML-виджет для каждого местоположения.

Способ применения:

1. Включить: Установите флажок «Создать виджет» в настройках экземпляра для вашего местоположения.
2. Найти состояние: Адаптер создаст состояние с именемhtmlWidget (подopen-meteo-weather.0.yourLocation.htmlWidget ).
3. В VIS/VIS2: * Перетащите стандартный виджет "HTML" на ваше представление.
   • Установите свойство "HTML" этого виджета в соответствии с привязкой вашего состояния:{open-meteo-weather.0.yourLocation.htmlWidget} .
   • Отрегулируйте ширину и высоту контейнера виджета в соответствии с содержимым.

Настройка: Основные параметры, такие как размер шрифта, время и дни прогноза погоды, можно изменять только в конфигурации адаптера.

Идеально подходит для: Пользователей, которым нужен быстрый, красивый и не требующий обслуживания дисплей.

Примечание: Для оптимального отображения в браузерах на настольных компьютерах не используйте дополнительные CSS-границы или тени в настройках редактора VIS. Виджет поставляется со своим собственным оптимизированным стилем.

2. Расширенный скрипт виджета (полная настройка)

Если вы хотите внести существенные изменения в дизайн, добавить собственный CSS-код или расширить логику:

• Ссылка: Используйте скрипт виджета VIS2-widget-script-om-weather .
• Лучше всего подходит для: опытных пользователей, желающих получить полный контроль над каждым HTML-тегом и свойством CSS.

Иконки и визуализация

Адаптер предоставляет динамические пути к значкам, которые можно использовать непосредственно в визуализациях, таких как vis, iQontrol или Jarvis .

• Значки погоды: находятся в разделеweather.current.icon_url Адаптер автоматически различает день и ночь (например, Солнце и Луна).
• Направление ветра: Статические траектории подwind_direction_icon Отобразить стрелку компаса, соответствующую значению градуса (направление отображения можно выбрать).
• Предупреждение о порывах ветра: под ним отображается предупреждающий значок.wind_gust_icon для скорости ветра выше примерно 39 км/ч (Bft 6), с уровнями 0–4.
• Значки фаз Луны: Значки Луны можно найти в разделеmoon_phase_icon Они отображают фазы Луны.
• Разнообразие значков: вы можете выбрать между статическими и анимированными (от basmilius ) значками.

Данные (фрагмент)

Если вам не нужны прогнозы погоды, оставьте поле «Местоположение» пустым, штаты вводиться не будут.

Функция «Прогноз солнечной активности» (если включена)

• Поддержка нескольких местоположений: поддержка нескольких фотоэлектрических систем/мест, например, для восточной/западной ориентации.
• Почасовой прогноз: подробный прогноз выработки электроэнергии, температуры, облачности и продолжительности солнечного сияния.
• Ежедневный прогноз: Сводка ожидаемого потребления энергии (Вт·ч) на срок до 14 дней.
• 15-минутный прогноз: 15-минутный прогноз на текущий день и 24 часа.
• Физическое моделирование:
  • Наклон и азимут: расчет интенсивности излучения на основе ориентации панели.
  • Температура фотоэлектрического модуля: оценка температуры ячейки с учетом температуры окружающей среды, интенсивности излучения и скорости ветра (модель Файмана).
  • Продолжительность солнечного сияния: Перевод продолжительности солнечного сияния в минуты в час.
• Агрегация: автоматическое суммирование данных по всем местоположениям (общий прогноз) за сутки, час и 15 минут.
• Системная интеграция: автоматическое получение координат местоположения из конфигурации системы ioBroker, если они не заданы вручную.
• Температура фотоэлектрического модуля: Расчетная температура фотоэлектрического модуля, рассчитанная на основе модели Файмана.

Точки данных (объекты)

Для каждого заданного местоположения создается канал со следующими точками данных:

Прогноз на 15 минут (15-min-forecast.0 - 95 ), (24 часа текущего дня), если включено

Информация: для расчета температуры фотоэлектрического модуля необходимы параметры temperature_2m и wind_spread_10m.

При необходимости эту опцию можно выбрать отдельно, в противном случае данные о погоде уже включены в расчеты.

Ежедневный прогноз (daily-forecast.dayX )

Прогноз в формате JSON (location_folder ) если включено

Почасовой прогноз (hourly-forecast.hourX )

Информация: для расчета температуры фотоэлектрического модуля необходимы параметры temperature_2m и wind_spread_10m.

При необходимости эту опцию можно выбрать отдельно, в противном случае данные о погоде уже включены в расчеты.

sum_peak_locations_15_Minutly (0-95 ) если включено

sum_peak_locations_Daily (dayX ) если включено

sum_peak_locations_Hourly (HourX ) если включено

JSON-данные, если включена эта функция.

Конфигурация

Основные настройки

• Прогнозируемые часы: временной интервал для почасового просмотра (от 3 до 48 часов).
• Дни прогноза: Продолжительность ежедневного прогноза (от 3 до 14 дней).
• Интервал обновления: частота обновления данных (15, 30, 60 минут или один раз перед восходом солнца).

Настройки точек данных

• Скользящий или фиксированный график: Если выбран вариант «Скользящий график», почасовой прогноз всегда будет показывать следующие часы, начиная с текущего. Если выбран вариант «Фиксированный график», почасовой прогноз будет показывать фиксированные временные интервалы (например, 00:00-23:00) независимо от текущего времени.
• 15-минутный прогноз: Если эта функция включена, для 15-минутного прогноза будут созданы дополнительные штаты (до 24 часов на текущий день). Обратите внимание, что доступность 15-минутных данных зависит от API Open-Meteo и может варьироваться в зависимости от местоположения или времени.

Места расположения (таблица)

Для каждого местоположения необходимо задать следующие значения:

1. Имя: Уникальный идентификатор (прошедший очистку по идентификатору объекта).
2. Широта/долгота: координаты GPS (необязательно: в противном случае используются системные значения).
3. Наклон: угол наклона модулей (0° = горизонтальное положение, 90° = вертикальное положение).
4. Азимут: Ориентация (-180° до 180°, 0° = Юг, -90° = Восток, 90° = Запад).
5. Мощность (кВтп): установленная пиковая мощность системы.
6. Часовой пояс: Выбор местного часового пояса (по умолчанию: Авто).

Глобальные параметры, настраиваемые только при наличии нескольких местоположений!

• Сумма за день: Создает каналsum_peak_locations_Daily суммируя выходы всех систем.
• Общая сумма (почасовая): Создает каналsum_peak_locations_Hourly за весь час работы.
• Сумма (за 15 минут): Создает каналsum_peak_locations_15_Minutely за все 15 минут прогноза.

Технические характеристики и расчеты

Модель температуры фотоэлектрической системы

Адаптер использует модель Файмана для оценки температуры модуля. Эта модель учитывает ветровое охлаждение, которое напрямую влияет на эффективность:pvTemp = Ambient Temperature + Irradiance / (25 + 6.84 * Wind Speed) .

Примечание об обновлении

После обновления адаптера рекомендуется удалить все дерево каталогов и позволить ему создаться заново.

Правовые вопросы и авторское право

Иконки и изображения

Анимированные иконки погоды от Баса Милиуса

Статические значки погоды и направления ветра, включенные в этот адаптер, защищены авторским правом его создателя.

• Использование: Эти значки лицензированы для использования в рамках ioBroker. Коммерческое распространение или использование за пределами данного адаптера требует явного согласия автора: h5n1@iknox.de .
• Данные о погоде: Все данные о погоде предоставлены сайтом Open-Meteo.com . Пожалуйста, ознакомьтесь с их условиями использования для коммерческих целей.

Changelog

3.2.1 (2026-09-12)

• (H5N1v2) add 'diffuse_radiation' to 15 min weather forecast.
• (H5N1v2) add node.js 26.x testmatrix
• (H5N1v2) Update dependencies

3.2.0 (2026-09-06)

• (H5N1v2) Adding configurable 15 minute weather forecast with max. 16 Datasets for the next 4 hours.
• (H5N1v2) Update dependencies

3.1.4 (2026-07-18)

• (@GermanBluefox) upscaled the logo
• (@GermanBluefox) Updated TS to 6
• (@GermanBluefox) Corrected image in JsonConfig
• (H5N1v2) Resize logo to 512x512
• (pk68) fix: info.lastUpdate_PV_Forecast is no longer updated if all API calls failed or returned empty data.
• (H5N1v2) fix: PV Forecast sunrise mode now retries automatically after 30 minutes if the API call fails (e.g. HTTP 500 overload). The next day's schedule is only planned after a successful update.
• (H5N1v2) add open-meteo status link in adapter description and README.
• (H5N1v2) fix: made OpenStreetMap link clickable in the admin area.
• (H5N1v2) Update dependencie.

3.1.3 (2026-06-20)

• (H5N1v2) Fixed an issue with object creation caused by an accidental change.

3.1.2 (2026-06-20)

• (mcuiobroker) fix: after adapter update, automatically adjust type and role if they have been changed in new versions.
• (H5N1v2) Update dependencies

License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright (c) 2026 H5N1v2 h5n1@iknox.de