Погодные данные для продукта

https://meteotrust.ru

Передавайте ключ в заголовке Authorization. Ключ создаётся и отзывается в личном кабинете.

curl -H "Authorization: Bearer mt_live_…" "https://meteotrust.ru/v1/current?lat=55.7558&lon=37.6173&fields=temperature_c,humidity_pct,precipitation_mm"

Основные запросы

• GET /v1/current — текущая погода
• GET /v1/hourly?hours=24 — почасовой прогноз
• GET /v1/daily?days=7 — дневной прогноз
• GET /v1/consensus — согласованный прогноз
• POST /v1/decision — решение для автоматизации
• GET /v1/usage — расход и лимит тарифа

Готовые методы

/v1/consensus возвращает согласованный прогноз и уровень уверенности:

GET /v1/consensus?lat=55.7558&lon=37.6173

/v1/decision формирует действие для умного дома:

POST /v1/decision
Authorization: Bearer ВАШ_API_KEY
{ "lat": 55.7558, "lon": 37.6173, "decision_type": "building" }

Ключ передаётся в заголовке Authorization. Внутренние данные провайдеров в ответ не входят.

Выберите только нужные поля

Параметр fields уменьшает ответ. Доступны 20 параметров: температура, ощущаемая температура, минимальная и максимальная температура, влажность, осадки и снег, ветер и порывы, направление ветра, облачность, давление, видимость, UV-индекс, состояние и код погоды, время наблюдения, восход и закат.

{ "data": { "temperature_c": 10.8, "feels_like_c": 9.7, "visibility_km": 10 }, "meta": { "request_id": "req_…", "schema_version": "1.0" } }

Единый формат MeteoTrust

• temperature_c, feels_like_c — температура, °C
• temp_min_c, temp_max_c — диапазон температуры, °C
• humidity_pct — влажность, %
• precipitation_mm, snow_mm — осадки и снег, мм
• wind_speed_ms, wind_gust_ms — ветер и порывы, м/с
• cloud_cover_pct, pressure_hpa — облачность и давление
• visibility_km, uv_index — видимость и UV
• weather_condition, weather_code — состояние и код погоды
• observed_at, sunrise_at, sunset_at — время в UTC

Запрос для контроллера

Система умного дома выполняет HTTPS-запрос с API-ключом. Для действий используйте Decision API: отопление, охлаждение, риск дождя и безопасность маркиз.

POST /v1/decision
Authorization: Bearer mt_live_…
{ "lat": 55.7558, "lon": 37.6173, "decision_type": "building" }

Что означает отказ

• 401 — ключ отсутствует или недействителен
• 403 — доступ запрещён тарифом или аккаунт заблокирован
• 422 — проверьте координаты или список fields
• 429 — превышен лимит запросов
• 502/503 — временная проблема получения данных

Ответ без внутренних данных

Все источники нормализуются на сервере. Клиент получает только выбранные погодные поля, метаданные запроса и решение — без сырых ответов, названий провайдеров и API-ключей поставщиков.

Подключение умного дома

В Loxone Config создайте Virtual HTTP Input. Ключ вставляется в URL между https:// и @:

https://ВАШ_API_KEY:x@meteotrust.ru/v1/current?lat=59.9386&lon=30.3141&fields=temperature_c,humidity_pct,precipitation_mm

Для команд используйте шаблоны: "temperature_c":\v, "humidity_pct":\v, "precipitation_mm":\v. Рекомендуемый период опроса — 600 секунд.

REST-сенсоры

Добавьте в configuration.yaml. API-ключ храните в secrets.yaml, а не в открытом файле.

rest:
  - resource: https://meteotrust.ru/v1/current?lat=55.7558&lon=37.6173&fields=temperature_c,humidity_pct,precipitation_mm
    scan_interval: 600
    headers:
      Authorization: !secret meteotrust_authorization
    sensor:
      - name: MeteoTrust температура
        value_template: "{{ value_json.data.temperature_c }}"
        unit_of_measurement: "°C"
      - name: MeteoTrust влажность
        value_template: "{{ value_json.data.humidity_pct }}"
        unit_of_measurement: "%"

В secrets.yaml: meteotrust_authorization: Bearer mt_live_....

Через Home Assistant или шлюз

KNX-шина обычно не выполняет HTTPS-запросы напрямую. Используйте Home Assistant с KNX/IP-интерфейсом или шлюз автоматизации. Home Assistant получает MeteoTrust через REST-сенсор, затем отправляет значение в групповой адрес KNX.

Температура MeteoTrust → sensor.meteotrust_temperature
→ автоматизация Home Assistant
→ KNX group address 5/1/1 (DPT 9.001)

Для влажности и осадков создайте отдельные групповые адреса. Адреса и типы данных должны соответствовать вашей KNX-инсталляции.