OpenMeteo Notify

Прогноз погоды и официальные предупреждения о погоде через Open-Meteo, DWD и MeteoAlarm

Текущий релиз
0.2.0
Разработчик
ipod86
Лицензия
MIT

Адаптер ioBroker для прогнозов погоды Open-Meteo

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

Основные моменты

Уведомления о погоде через менеджер уведомлений ioBroker

Адаптер отправляет индивидуальные уведомления о настраиваемых погодных событиях — предупреждениях о штормах, оповещениях о грозах и официальных предупреждениях национальных метеорологических служб (DWD для Германии, MeteoAlarm для Европы). Все адреса уведомлений (Telegram, электронная почта, Pushover и т. д.) настраиваются централизованно через менеджер уведомлений ioBroker — отдельная настройка для каждого адаптера не требуется.

Настраиваемый HTML-виджет

Адаптер генерирует готовую к использованию точку данных в формате HTML (widget ), который можно встроить непосредственно в VIS, vis-2 или любую панель управления ioBroker — без использования внешних инструментов или ручного CSS. Тема (светлая/темная), прозрачность фона, прозрачность карточки, размер шрифта и цвет карточки — все это можно настроить непосредственно в параметрах адаптера.

Анимированные обои/заставка с погодой

Адаптер генерирует автономные анимированные обои с погодными условиями для каждого местоположения — полноэкранную анимацию на холсте (дождь, снег, туман, молния, солнечные блики, звезды), управляемую реальными текущими погодными условиями, а не вручную, что идеально подходит в качестве заставки для планшета, крепящейся на стену, или фона для приборной панели/дисплея.

  • Реальные погодные эффекты — направление/скорость ветра влияют на перенос осадков и тумана, количество осадков масштабируется в зависимости от интенсивности частиц, положение Солнца и Луны (и фаза Луны) соответствуют реальным астрономическим данным (SunCalc) для заданного местоположения.
  • Официальный предупреждающий баннер — активные предупреждения DWD/MeteoAlarm отображаются в виде настраиваемого текстового баннера, элементы наложения, которые могут столкнуться с препятствием, автоматически смещаются в сторону.
  • Для каждого местоположения используется собственное фоновое изображение — по умолчанию устанавливается фотография, которую можно заменить в любое время через Администрирование → Файлы, при этом файл называется в соответствии с местоположением.
  • Самообновление без REST API — загружает небольшой сопутствующий JSON-файл из той же папки, полная перезагрузка страницы не требуется.
  • Дополнительная функция карусели местоположений — переключение между несколькими настроенными местоположениями с помощью стрелок влево/вправо.
  • Независимый интервал обновления в реальном времени — обновляется только информация о текущих условиях и обои (0/5/10/15/30 мин), отдельно от основного интервала обновления прогноза.
  • Настраивается через специальную вкладку «Обои» в административной панели (положение, цвета, размеры шрифтов, часы, предупреждения) с предварительным просмотром в реальном времени, имитирующим распространенные разрешения экрана.
  • Доступен напрямую по URL-адресу для каждого экземпляра веб-сайта (current.wallpaper_url_<instance> ) — привязка VIS не требуется

Поиск по адресу в полном тексте

Местоположение не обязательно вводить в виде прямых координат. В пользовательском интерфейсе настроек доступен поиск по адресу в свободной текстовой форме — просто введите город, адрес или регион, и координаты будут определены автоматически. Для каждого местоположения отображается предварительный просмотр в OpenStreetMap. Можно настроить несколько местоположений одновременно.

Прогноз на срок до 16 дней

В зависимости от выбранной метеорологической модели, доступны ежедневные прогнозы на срок до 16 дней — значительно больше, чем типичные 5–7 дней у большинства адаптеров.

Сводные тексты о погоде

Адаптер генерирует сводки погоды на естественном языке.current.summary ,dayX.summary_day ,dayX.summary_night ) на 11 языках , с использованием стандартных пороговых значений DWD для температуры, ветра и осадков, включая риск гроз на основе CAPE.

Функции

  • Бесплатно и без ключа API – Open-Meteo — это бесплатный API для прогноза погоды с открытым исходным кодом.
  • Несколько местоположений — настройте столько местоположений, сколько вам нужно, для каждого из которых будет доступен поиск адреса и предварительный просмотр карты.
  • Резервный вариант определения местоположения системы — использует координаты системы ioBroker, если местоположение не указано.
  • Настраиваемый диапазон прогноза – до 16 дней в сутки, до 16 дней в час.
  • Настраиваемый интервал обновления – 60 мин, 120 мин или ежедневно в 01:00.
  • Единицы измерения : температура (°C / °F), скорость ветра (км/ч, м/с, миль/ч, узлов), количество осадков (мм / дюйм).
  • 5 наборов иконок погоды с предварительным просмотром в реальном времени в настройках:
    • Метеоконтраст от Баса Милиуса – статический PNG (по умолчанию)
    • Метеоконтансы Баса Милиуса – анимированный SVG-файл
    • Анимированные иконки погоды amCharts в формате SVG (дождь/снег/гром: нет варианта день/ночь)
    • Иконки погоды amCharts – статический SVG (дождь/снег/гроза: нет варианта день/ночь)
    • Метеорологические символы ВМО OGC – Папуа-Новая Гвинея
  • Значки дня/ночи – значки Meteocons и amCharts с прозрачной/облачной погодой переключаются на ночные варианты в зависимости от погоды.is_day
  • Направление ветра – градусы, текст компаса (С/СВ/В/…), эмодзи стрелки (⬆️↗️…), иконка стрелки в формате SVG.
  • Сила ветра – шкала Бофорта (0–12) с иконками Бофорта от Meteocons.
  • info.lastUpdate – метка времени последнего успешного обновления

Дополнительные группы данных (переключаемые индивидуально, каждая с опцией "также почасовая")

ГруппаПо умолчаниюТочки данных
Качество воздуханаeuropean_aqi, PM10, PM2.5, NO₂, CO, dust, ozone →current.air_quality /hXX.air_quality
Астрономиянавосход солнца, закат солнца, солнечный полдень, максимальная высота солнца над горизонтом, фаза луны, восход луны, закат луны →dayX.astronomy /hXX.astronomy
Сельское хозяйство / Солнечная энергетикавыключенныйсолнечное излучение, CAPE, температура почвы, освещенность →*.agriculture
Индексы комфортавыключенныйиндекс жары, ветровое охлаждение, индекс влажности, УФ-индекс →*.comfort
Пыльцавыключенныйольха, береза, трава, полынь, олива, амброзия с текстом разного уровня →dayX.pollen /hXX.pollen
Предупреждения DWDвыключенныйОфициальные предупреждения от Deutscher Wetterdienst (только для Германии) →location.warnings.*

Когда группа отключена, каналы с данными, относящиеся к ней, автоматически удаляются при следующем обновлении.

Официальные предупреждения о погоде

Адаптер интегрирует официальные предупреждения о погоде от национальных метеорологических служб. Включите их с помощью переключателя «Официальные предупреждения о погоде» . Служба выбирается автоматически на основе координат местоположения:

СтранаУслугаПокрытие
Германия (DE)DWD – Deutscher WetterdienstВсе типы предупреждений, 4 уровня серьезности
страны ЕСМетеосигналВсе типы предупреждений, сопоставление на основе полигонов.
ДругойНедоступно (используйте рассчитанные предупреждения Open-Meteo)

Предупреждения хранятся вlocation.warnings.* независимо от источника. Аwarnings.source точка данных показывает"DWD" или"MeteoAlarm" .

Установка

Установите через административный интерфейс ioBroker (найдите "openmeteo-notify").

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

ПараметрОписаниеПо умолчанию
Места расположенияПоиск по имени + адрес в свободной текстовой форме или координаты; предварительный просмотр карты OSM.местоположение системы ioBroker
Прогнозируемые дниДиапазон суточного прогноза (1–16)7
Почасовые дниДни с почасовыми данными (0–16)3
Единица измерения температуры°C или °F°С
единица измерения скорости ветракм/ч, м/с, миль/ч, кНкм/ч
Единица измерения осадковмм или дюйммм
Набор иконокНабор иконок погоды с предварительным просмотром в реальном времени.Метеоконтраст статический
Интервал обновления60 мин / 120 мин / ежедневно в 01:0060 мин
Тема виджетаСветлая или темная тема для HTML-виджетасвет
Прозрачность фона виджетаПрозрачность фона HTML-виджета100%
Прозрачность карточки виджетаПрозрачность карточки HTML-виджета100%
размер шрифта виджетаРазмер шрифта в HTML-виджете14px
Цвет карточки виджетацвет фона карты#ffffff
Компактный видИспользуйте компактную разметку в HTML-виджете.выключенный
Качество воздухаВключить индекс качества воздуха (AQI) + измерение уровня твердых частицна
Качество воздуха – также почасовая оценкаПочасовой индекс качества воздуха/количество дневных часов нижеhXX.air_qualityвыключенный
АстрономияВключить данные о Солнце и Лунена
Астрономия – также ежечасноЭхоастрономические данные за каждый часвыключенный
Сельское хозяйство / Солнечная энергетикаВключите параметры радиации, CAPE и температуры почвы.выключенный
Сельское хозяйство – также почасовая оплатаПочасовые сельскохозяйственные данныевыключенный
Индексы комфортаВключите отображение индекса жары, индекса охлаждения ветром, индекса влажности и УФ-индекса.выключенный
Комфорт – также почасовая оплатаПочасовые данные о комфортевыключенный
ПыльцаВключить сбор данных о пыльце (только для Европы)выключенный
Пыльца – также ежечасноПочасовое содержание пыльцы по видамвыключенный
Предупреждения о погоде от DWDВключить данные DWD (только для Германии)выключенный
Официальные предупреждения в качестве уведомленияОтправляйте официальные предупреждения (Германия: DWD, ЕС: MeteoAlarm) через систему уведомлений ioBroker.выключенный
Предупреждение о штормеРасчеты произведены на основе прогноза Open-Meteo по всему миру.выключенный
Предупреждение о грозеРасчеты произведены на основе прогноза Open-Meteo по всему миру.выключенный
Срок выполнения заказа (в часах)За сколько часов до грозы следует рассылать предупреждения о шторме/грозе2

Точки данных

Адаптер создает точки данных в рамкахopenmeteo-notify.<instance>.<location> .

Текущая погода (current )

Точка данныхОписаниеЕдиница
temperatureТекущая температура°C/°F
feels_likeОщущаемая температура – это совокупность тепла, влажности и ветра.°C/°F
weathercodeМетеорологический код ВМО (0 = ясное небо, 95/99 = гроза) – полная таблица: ВМО 4677
descriptionУдобочитаемое описание погоды (на 11 языках)
iconЭмодзи погоды
icon_urlURL значка погоды (значок можно выбрать в настройках)
precipitationОбщее количество осадков за последний часмм/дюйм
rainКоличество осадков за последний часмм/дюйм
snowfallСнегопад за последний чассм
snow_depthТекущая глубина снега на землесм
cloudcoverОблачность%
humidityОтносительная влажность%
dew_pointТочка росы – температура, при которой воздух становится насыщенным; температура, близкая к температуре воздуха, означает высокую влажность.°C/°F
pressureАтмосферное давление, приведенное к среднему уровню моря (MSL)гПа
visibilityГоризонтальная видимостьм
is_daytrue между восходом и закатом солнцалогический
windspeedСкорость ветра (единицы измерения на выбор: км/ч, м/с, миль/ч, узлов)км/ч …
windgustsМаксимальная скорость порывов ветракм/ч …
winddirectionНаправление ветра (метеорологическое: направление, откуда дует ветер)°
winddirection_textТекст, указывающий направлениеС/СВ/…
winddirection_iconЭмодзи «Стороны направления»⬆️↗️…
winddirection_icon_urlзначок стрелки направления ветра URL
windbeaufortСила ветра по шкале Бофорта (0 = штиль, 8 = штормовой ветер, 12 = ураган)0–12
windbeaufort_icon_urlURL-адрес значка Бофорта
air_quality.*Индекс качества воздуха (AQI), PM10, PM2.5, NO₂, CO, пыль, озон (если включено)
pollen.*Текущее количество опрашиваемых устройств каждого типа (если включено)Зерна/м³
agriculture.solar_radiationКоротковолновое солнечное излучение на уровне земли (если включено)Вт/м²
agriculture.capeCAPE – Конвективная потенциальная энергия: энергия, доступная для развития грозовых явлений; > 500 Дж/кг = значительный риск, > 2000 Дж/кг = высокий риск (если он существует).Дж/кг
agriculture.soil_tempТемпература почвы на глубине 0 см (если включена)°C/°F
comfort.heat_indexИндекс жары (Ротфус) – показатель того, насколько жарко ощущается температура и влажность; значимыми считаются только значения ≥ 27 °C и ≥ 40 % относительной влажности.null в противном случае (если включено)°C/°F
comfort.windchillОщущаемая температура из-за ветра (NWS) – насколько холодно ощущается температура из-за ветра; имеет значение только температура ≤ 10 °C и скорость ветра > 4,8 км/ч.null в противном случае (если включено)°C/°F
comfort.humidexИндекс влажности (Humidex, канадская формула) – комбинированный индекс дискомфорта от жары и влажности; значения выше 40 вызывают дискомфорт, выше 46 – опасность (если эта функция включена).°C/°F
comfort.humidex_levelУровень дискомфорта по шкале Humidex: 1 = отсутствует (<29) · 2 = незначительный (29–34) · 3 = заметный (35–39) · 4 = сильный (40–45) · 5 = опасный (≥46) (если включено)1–5
comfort.uv_indexУФ-индекс (0–11+) – интенсивность ультрафиолетового излучения на уровне земли (если включено).
comfort.uv_levelУровень защиты от УФ-излучения (шкала ВОЗ):low (0–2, без защиты)moderate (3–5, солнцезащитный крем) ·high (6–7) ·very_high (8–10) ·extreme (≥11) (если включено)

Ежедневный прогноз (day1day16 )

Точка данныхОписание
date /weekdayДата / день недели
icon /icon_urlЗначок погоды (дневной/ночной вариант)
descriptionОписание погоды
temp_max /temp_minМаксимальная/минимальная температура
feels_like_max /feels_like_minОщущается как максимум/минимум
weathercodeМетеорологический кодекс ВМО
precipitationСумма осадков
rain /snowfallСумма осадков (дождь/снегопад)
rain_probabilityВероятность осадков
windspeed /windgustsМаксимальная скорость ветра / порывы ветра
winddirection /_text /_icon /_icon_urlНаправление ветра
windbeaufort /windbeaufort_icon_urlШкала Бофорта
uv_indexМаксимально допустимый суточный УФ-индекс (с учетом облачности)
uv_index_clear_skyМаксимальный суточный УФ-индекс при условии полного ясного неба – полезно для оценки потенциального уровня УФ-излучения независимо от облачности.
sunshine_hoursКоличество часов фактического солнечного света (прямого излучения)
daylight_hoursОбщее количество часов между восходом и закатом солнца.
cloud_cover_maxМаксимальная облачность в течение дня
temp_mean /feels_like_meanСреднесуточная температура / ощущаемая температура
precipitation_hoursКоличество часов с измеримыми осадками
showersКонвективные (ливневые) осадки – кратковременные, интенсивные; отличаются от непрерывных. rain
snowfall_height_minМинимальная высота над уровнем моря в течение дня, на которой выпадает снег (0 м = от снега до дна долины).
freezing_level_height_minМинимальная высота изотермы 0 °C в течение дня
dew_point_mean /humidity_mean /pressure_meanСреднесуточные значения
air_quality.european_aqi_maxozone_maxМаксимально допустимые суточные значения индекса качества воздуха (AQI), PM10, PM2.5, NO₂, CO, пыли, озона (если включено).
astronomy.sunrise /astronomy.sunsetВосход/закат солнца (если включено)
astronomy.solar_noonВремя наивысшего положения солнца (если включено)
astronomy.solar_elevation_maxУгол наклона Солнца над горизонтом в полдень: 90° = прямо над головой, 0° = горизонт (если включено).
astronomy.moon_phase_valФазы Луны в числовом формате: 0 = новолуние · 0,25 = первая четверть · 0,5 = полнолуние · 0,75 = последняя четверть (если включено)
astronomy.moon_phase_text /_icon_urlФаза Луны в виде текста/значка (если включена)
astronomy.moonrise /astronomy.moonsetВосход/заход Луны (если включено)
agriculture.solar_radiation_sumСуммарное количество солнечной радиации, полученное за день
agriculture.evapotranspirationРеферентное испарение (ET₀) по стандарту ФАО-56 – количество воды, выделяемое растениями и почвой; используется для планирования орошения.
agriculture.lifted_index_minЕжедневный минимум индекса устойчивости атмосферы (Lifted Index): отрицательное значение = неустойчивость/риск шторма, сильно отрицательное значение (< −6) = риск сильных гроз (если включено).
comfort.heat_index_maxМаксимальный индекс жары за день (если включен)
comfort.windchill_minМинимальный дневной показатель ветрового охлаждения (если включен).
comfort.humidex_max /.humidex_levelМаксимальный уровень влажности/дискомфорта (1–5, см. текущий раздел) (если включено)
comfort.uv_index_max /.uv_levelМаксимальный УФ-индекс/уровень (см. текущий раздел) (если включено)
pollen.alderpollen.ragweedМаксимальная суточная концентрация пыльцы + текст уровня (Нет/Низкий/Средний/Высокий) (если включено, только в дни 1–4)

Почасовые значения (day1.hourly.h00h23 )

Температура, ощущаемая температура, осадки, дождь, снегопад, глубина снега, высота снегопада, вероятность дождя, облачность, влажность, точка росы, давление, видимость, текущий день, скорость ветра, направление ветра (текст/эмодзи/иконка), Бофорт, УФ-индекс, высота точки замерзания, код погоды, иконка/URL иконки, описание.

Почасовая оплата (если включено + "также почасово"):

КаналТочки данных
hXX.air_qualityeuropean_aqi, PM10, PM2.5, NO₂, CO, пыль, озон
hXX.astronomyвосход солнца, закат солнца, фаза луны, восход луны, закат луны
hXX.agricultureсолнечное излучение (Вт/м²), CAPE (Дж/кг), температура почвы (°C/°F), освещенность = глобальная наклонная освещенность на плоской поверхности (Вт/м²), индекс подъема (К)
hXX.comfortиндекс жары, ветровая температура, индекс влажности, уровень влажности, индекс ультрафиолетового излучения, уровень ультрафиолетового излучения
hXX.pollenольха… амброзия + текст уровня (Кейне/Нидриг/Миттель/Хох)

Официальные предупреждения (warnings )

Точка данныхОписание
warnings.sourceСлужба предупреждений:"DWD" или "MeteoAlarm"
warnings.activeПо меньшей мере одно активное предупреждение
warnings.countКоличество активных предупреждений
warnings.max_levelНаивысший уровень тяжести: 1 = Легкая · 2 = Умеренная · 3 = Тяжелая · 4 = Крайне тяжелая
warnings.max_level_textТекст уровня серьезности
warnings.warning_N.activeПредупреждающий слот N активен
warnings.warning_N.eventТип события
warnings.warning_N.level /.level_textСтепень тяжести
warnings.warning_N.headlineПредупреждающий заголовок
warnings.warning_N.descriptionОписание предупреждения
warnings.warning_N.start /.endСрок действия

(Создается только при включенной функции "Официальные предупреждения о погоде" и обнаружении поддерживаемой страны.)

Сводка и виджет

Точка данныхОписание
current.summaryКраткий обзор погоды на естественном языке с указанием текущих условий (11 языков)
dayX.summary_dayСводка погоды на день (11 языков)
dayX.summary_nightНочной прогноз погоды на предстоящий день (на 11 языках)
weather_shortКраткий текстовый обзор всех дней прогноза погоды.
widgetГотовый к использованию HTML-фрагмент для VIS / vis-2 / дашбордов (настраиваемый внешний вид)
info.lastUpdateОтметка времени последнего успешного обновления

Авторские права на иконку

Отказ от ответственности

Этот адаптер использует данные из следующих сторонних сервисов:

  • Open-Meteo – данные прогноза погоды. Название и логотип Open-Meteo являются собственностью соответствующих владельцев.
  • DWD (Deutscher Wetterdienst) – официальные предупреждения о погоде для Германии. Название и данные DWD являются собственностью Deutscher Wetterdienst.
  • MeteoAlarm – официальные метеорологические предупреждения для европейских стран. Название и данные MeteoAlarm являются собственностью соответствующих владельцев.

Этот адаптер является независимым проектом сообщества и не связан ни с одним из вышеперечисленных сервисов и не поддерживается ими.

Changelog

0.2.0 (2026-09-08)

  • (ipod86) feat: add animated, per-location WMO weather wallpaper (canvas rain/snow/fog/lightning/sun/moon animation), self-updating via a companion JSON file (no REST API needed), with a dedicated admin config tab, an optional location carousel, an independent live-update interval and an official warning banner
  • (ipod86) feat: wallpaper sun/moon position and moon phase follow real astronomical data (SunCalc); rain/fog intensity and wind drift follow real weather data
  • (ipod86) feat: add day/night split for precipitation/thunderstorm probability, wind, rain and snowfall amount
  • (ipod86) fix: treat overlapping DWD warning time-shifts as an update instead of lift+new

0.1.16 (2026-08-17)

  • (ipod86) fix: variable shadowing in fetchDwdWarnings caused every DWD official warning request to fail with "Cannot access 'raw' before initialization", silently freezing the affected warning states
  • (ipod86) fix: guard the official warning update against a single hung request permanently stalling the recurring schedule

0.1.15 (2026-07-19)

  • (ipod86) fix: sanitize widget.id through normalizeId before use as ioBroker object ID path

0.1.14 (2026-07-16)

  • (ipod86) fix: persist warning dedup state across adapter restarts to prevent duplicate notifications on restart
  • (ipod86) fix: deduplicate DWD warnings from combined warnings+vorabInformation API arrays (same event rounded to minute)

0.1.13 (2026-07-15)

  • (ipod86) fix: add random jitter to daily and interval update scheduling to spread cloud load
  • (ipod86) fix: validate warnIntervalMinutes — reset to 15 if < 1
  • (ipod86) fix: remove orphaned i18n keys (iconPreviewAnimated, iconPreviewBasmilius, iconPreviewWmo, openmeteo adapter settings) from all 11 language files
  • (ipod86) fix: warnIntervalMinutes default in admin WarningsPanel corrected to 15
  • (ipod86) chore: bump @mui/material and @mui/icons-material to 9.x, TypeScript to 7.x, Vite to 8.1, suncalc to 2.0

Older changelogs are available in CHANGELOG_OLD.md.

License

MIT License

Copyright (c) 2026 ipod86

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.