Skip to main content

OpenWeatherMap

Версия: 1.26.0

Этот агент обеспечивает интеграцию с OpenWeatherMap, обеспечивая доступ к данным о погоде через One Call 3.0 API.

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

Конфигурация агента​

В следующей таблице описаны поддерживаемые атрибуты конфигурации и их назначение:

Атрибут

Описание

Требуется

По умолчанию

Ключ API

Ключ API для API OpenWeatherMap. Должен иметь доступ к API One Call 3.0.

Да

-

Опрос в миллисекундах

Интервал опроса в миллисекундах.

Нет

3600000

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

Предоставление погодных ресурсов​

Предоставить ресурс погоды — это вспомогательный атрибут, который предоставляет Ресурту погоды соответствующие атрибуты и ссылки на агенты, если этот флажок установлен. После создания актива флажок автоматически сбрасывается. Подготовленный актив будет отображаться как дочерний элемент агента.

Для атрибутов, связанных с этим агентом, в следующей таблице описаны поддерживаемые поля Agent Link в дополнение к стандартным полям Agent Link:

Атрибут

Описание

Требуется

По умолчанию

Свойство погоды

Свойство погоды, которое будет использоваться для связанного атрибута.

Да

-

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

Важные примечания​

– Для объекта, содержащего связанные атрибуты, должно быть установлено местоположение. Агент использует это местоположение для получения данных о погоде из API OpenWeatherMap.

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

Уведомление о лицензии: атрибуция документации OpenRemote