Прогноз wetter.com

Прогноз погоды от wetter.com , полученный через общедоступный API погоды Meteonomiqs версии 4.0 .

Прогноз погоды на срок до 14 дней, данные по дням, почасовые значения, текущий час, предупреждения о погоде, данные о Солнце и Луне — все это за один вызов API за один запрос. Адаптер разработан с учетом того, что бесплатный тарифный план позволяет совершать только 100 вызовов в месяц.

Функции

Установка

Установите адаптер через административный интерфейс ioBroker.

ключ API

Для работы требуется ключ, который можно получить у Meteonomiqs . Бесплатный тарифный план в настоящее время включает 100 звонков в месяц, что точно соответствует расписанию по умолчанию. Ключ хранится в зашифрованном виде в конфигурации экземпляра.

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

Общий

Расписание

Время выборки — это таблицаHH:MM плюс приоритет . Значение по умолчанию:

Каждая установка сдвигает эти временные интервалы на фиксированное смещение до 15 минут, определяемое по UUID установки ioBroker — в противном случае каждая установка этого адаптера обращалась бы к API в одну и ту же минуту. Смещение одинаково для всех трех временных интервалов, поэтому промежутки между ними остаются точно такими, как настроено. Фактически используемое время записывается в журнал при запуске.

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

бюджет API

Три запроса в день приводят к 93 звонкам за 31 день месяца — на 7 меньше, чем 100 звонков в бесплатном плане. Вместо того чтобы достигать предела в конце месяца, каждый запрос имеет свой приоритетный уровень:

Запрос уровня N выполняется только до тех пор, пока оставшийся бюджет позволяет обрабатывать N вызовов в день до конца месяца.

Когда ситуация становится напряженной, вечерний сбор данных прекращается первым, затем дневной. Ночной сбор данных длится дольше всего и в экстренной ситуации переключается на сбор данных через день, вместо того чтобы прекращаться вовсе. Подтверждено в течение целого смоделированного месяца:

Счетчик представляет собой локальную оценку — API не сообщает об оставшемся объеме квоты. Только HTTP-код 429 является эталонным.info.reset_counter Если вам когда-либо понадобится, он обнулит это значение.

Данные

Все данные поступают из одного и того же API-ответа, поэтому включение большего количества групп не требует дополнительных вызовов — только больше объектов. Примерные размеры на 7 дней прогноза:

На Raspberry Pi разумным компромиссом является отображение почасовых значений за сутки.

Дерево штата

meteonomiqs.0
├── info
│   ├── connection            Connected to the API
│   ├── status                ok / no API key / HTTP 429 / …
│   ├── last_sync             Last successful fetch
│   ├── requests_month        Local estimate of calls used this month
│   ├── requests_left         Remaining calls
│   ├── force_update          Button: fetch now (skips the cooldown)
│   └── reset_counter         Button: reset the monthly counter
├── current                   The hour in progress, refreshed hourly
│   ├── temp, weather_text, weather_icon, is_night, …
│   ├── temp_min_today, temp_max_today, sunrise, sunset
│   ├── valid                 false when no data covers this hour
│   └── source                Which state the values were copied from
├── day_0 … day_N
│   ├── date, day_name, temp_min, temp_max, weather_icon, …
│   ├── warn_active, warn_severity_int
│   ├── astro                 sunrise, sunset, moon phase, day length …
│   ├── spaces                morning, afternoon, evening, night
│   └── hourly                00 … 23
├── forecast_json
└── hourly_json

Две вещи, которые стоит знать об этом дереве.

day_N.spaces.nightЭто ночь после этого дня. Следовательно, ее минимум приходится на ранние часы.day_N+1 Чтениеday_0.spaces.night.temp_min Отображает сегодняшний минимум, а не вчерашний.

wind_significantпоясняет значение значка. API помечает сильный ветер в имени файла значка (d_w_60.svg вместоd_60.svg ) независимо отwarn_active В течение дня может наблюдаться изменение направления ветра без какого-либо официального предупреждения, поэтому значок и штаты, выдающие предупреждения, могут расходиться.

current — как это работает

current отражает структуруdaswetter иopen-meteo-weather адаптеры, с двумя преднамеренными выборами:

Обновляется ежечасно, а не только при получении данных.current Папка, которая обновляется только при запросе к API, к вечеру устареет на семь часов. Отдельный почасовой таймер копирует значения каждый полный час — это ничего не стоит, поскольку почасовые данные уже находятся в дереве объектов.

Чтение происходит из состояний, а не из кэша. Чтение из кэшированной полезной нагрузки привело бы к...current Пустое поле после каждого перезапуска адаптера до следующего запланированного запроса. Чтение изday_N.hourly.HH.* Всегда работает.

День решается посредствомdate_iso а не фиксированный индекс. Между полуночью и первым запросом данных за день "сегодняшний день" всё ещё существует.day_1 — жестко закодированныйday_0 Это приводило бы к неправильному отображению значений в этом окне каждую ночь.

current Это прогноз на текущий час, а не измерение. Для получения значений в реальном времени потребуется.../nowcast или/stations конечные точки, стоимость каждого запроса которых составляет один вызов и которые не вписываются в тарифный план на 100 вызовов.

Разработка

npm install          # install dependencies
npm run build        # compile TypeScript to build/
npm run watch        # rebuild on change
npm run check        # type check without emitting
npm run lint         # ESLint
npm run test:ts      # unit tests
npm run test:package # validate package.json / io-package.json
npm run test:integration  # boots a real js-controller
npm run translate    # @iobroker/adapter-dev translation helper

Локальный тестовый экземпляр с сервером разработки :

npm install --global @iobroker/dev-server
dev-server setup
dev-server watch

Данные о погоде © wetter.com GmbH / Meteonomiqs . Этот адаптер не связан с wetter.com.

Changelog

0.2.7 (2026-09-06)

• Raised the required @iobroker/adapter-core to ^3.4.3 ([W0034]) and the release-script license plugin to ^5.2.2 ([S0064]). Both caret ranges already resolved to those versions; only the declared minimums lagged behind, so nothing changes at runtime

0.2.6 (2026-08-16)

• The buttons info.force_update and info.reset_counter are write-only now. A state with role button carries no value to read, and read: true made the admin offer it as a readable one (repository review)
• The warn_severity_int states in the day, day-section and hourly subtrees carry the generic value role. value.severity is not part of the ioBroker role catalogue (repository review)
• Both corrections reach existing installations on the next adapter start — the object metadata is compared and rewritten on drift

0.2.5 (2026-08-16)

• The field tables are covered by tests now: 138 of them, running every getter against a hand-built API response, plus the structural rules — unique ids, both label languages, roles from the ioBroker catalogue, unit and precision only on numbers. Every leaf of the fixture carries a value that appears nowhere else, so a getter reading min where it should read max cannot pass
• The admin translations moved to the short i18n form, admin/i18n/<lang>.json instead of admin/i18n/<lang>/translations.json ([S5601])
• Added .vscode/settings.json with the ioBroker JSON schemas for io-package.json and jsonConfig.json ([S4036])
• Nothing changes for an installation: no state, no role, no unit and no configuration option is affected

0.2.4 (2026-08-16)

• Raised the minimum admin version to 7.8.23 and @types/node to the major that matches engines.node — both proposed by the ioBroker bot

0.2.3 (2026-08-16)

• Installing from GitHub works again without an install lifecycle script. The compiled build/ folder is committed to the repository, which is what the repository checker asks for ([E5019]), so the prepare script added in 0.2.1 could be dropped again ([E0092])
• Trimmed common.news in io-package.json to the seven entries the repository builder keeps ([E1032]); the older ones moved to CHANGELOG_OLD.md ([W6020])

0.2.2 (2026-08-16)

• Removed mocha from the devDependencies. It is a dependency of @iobroker/testing, so npm hoists it and the test scripts still find the binary — this clears the last error the repository checker reported ([E0063])

0.2.1 (2026-08-16)

• The adapter can be installed straight from GitHub again. Since the compiled build/ folder was removed from the repository ([E5019]), a GitHub installation had nothing to start; a prepare script now makes npm compile the TypeScript sources during such an installation. Installing from npm is unaffected — the published package already contains the compiled files

License

The MIT License (MIT)

Copyright (c) 2026 Schimi szymon.haiduk@world-mg.de

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.