Получение онлайн прогноза погоды: различия между версиями

Материал из Sprut.hub Wiki
Метка: wikieditor
Строка 10: Строка 10:


* [https://wiki.spruthub.ru/images/b/b6/%D0%A1%D1%86%D0%B5%D0%BD%D0%B0%D1%80%D0%B8%D0%B8_%D0%BF%D0%BE%D0%B3%D0%BE%D0%B4%D1%8B.zip Скачать шаблоны сценариев] для дальнейшего импорта их в Sprut.hub
* [https://wiki.spruthub.ru/images/b/b6/%D0%A1%D1%86%D0%B5%D0%BD%D0%B0%D1%80%D0%B8%D0%B8_%D0%BF%D0%BE%D0%B3%D0%BE%D0%B4%D1%8B.zip Скачать шаблоны сценариев] для дальнейшего импорта их в Sprut.hub
* [[Сценарии в Sprut.hub - основные элементы управления#Общее окно управления сценариями|Импортировать в Sprut.hub]] обязательный глобальный сценарий '''"Погода Переменные и другие украшательства"'''
* [[Сценарии в Sprut.hub - основные элементы управления#Общее окно управления сценариями|Импортировать в Sprut.hub]] обязательный глобальный сценарий '''№1 "Погода Переменные и другие украшательства"'''
* Заполнить [[Получение онлайн прогноза погоды#Главный глобальный сценарий для работы всех остальных "Погода Переменные и другие украшательства"|координаты и API ключи в глобальном сценарии Погода Переменные и другие украшательства]]
* Заполнить [[Получение онлайн прогноза погоды#Главный глобальный сценарий для работы всех остальных "Погода Переменные и другие украшательства"|координаты и API ключи в глобальном сценарии Погода Переменные и другие украшательства]]
* При использовании сервиса AccuWeather - импортировать шаблон блочного сценария Accuweather City ID для получения ID вашего города и вставить полученный ID города (его видно в логе или в телеграме) в глобальный сценарий №1
* При использовании сервиса AccuWeather - импортировать шаблон блочного сценария '''Accuweather City ID''' для получения ID вашего города и вставить полученный ID города (его видно в логе или в телеграме) в глобальный сценарий №1
* [[Создание виртуальных аксессуаров|Создать виртуальные датчики]] температуры, влажности и другие для отображения показаний
* [[Создание виртуальных аксессуаров|Создать виртуальные датчики]] температуры, влажности и другие для отображения показаний
* Импортировать соответствующий нужному сервису погоды '''глобальный''' сценарий этого сервиса
* Импортировать соответствующий нужному сервису погоды '''глобальный''' сценарий этого сервиса

Версия от 19:54, 16 декабря 2022

Данный набор сценариев, состоит из глобальных и блочных сценариев. Глобальные занимаются запросом данных, локальные отправляют показания в Telegram и обновляют показания виртуальных датчиков.

Для всех сервисов, кроме Yr.no - требуется получение API ключей. То есть вам нужно зарегистрироваться в сервисе как разработчик и получить API ключ, который потом необходимо вставить в один ключевой глобальный сценарий, который обязателен для работы всех остальных в наборе.

Все шаблоны можно скачать и импортировать в сценарии вашего Sprut.hub как показано в инструкции

Архив с шаблонами

Скачать шаблоны всех сценариев одним архивом

Как пользоваться

  • Скачать шаблоны сценариев для дальнейшего импорта их в Sprut.hub
  • Импортировать в Sprut.hub обязательный глобальный сценарий №1 "Погода Переменные и другие украшательства"
  • Заполнить координаты и API ключи в глобальном сценарии Погода Переменные и другие украшательства
  • При использовании сервиса AccuWeather - импортировать шаблон блочного сценария Accuweather City ID для получения ID вашего города и вставить полученный ID города (его видно в логе или в телеграме) в глобальный сценарий №1
  • Создать виртуальные датчики температуры, влажности и другие для отображения показаний
  • Импортировать соответствующий нужному сервису погоды глобальный сценарий этого сервиса
  • Импортировать соответствующий нужному сервису погоды блочный сценарий отправки данных в Телеграм
  • Импортировать соответствующий нужному сервису погоды блочный сценарий установки значений датчиков
  • Прописать ID созданных аксессуаров и датчиков в блочном сценарии установки значений датчиков
  • Пользоваться

Структура сценариев для использования

Глобальные сценарии

  1. Глобальный сценарий "Погода Переменные и другие украшательства" - ЕДИН ДЛЯ ВСЕХ СЦЕНАРИЕВ. ИМПОРТИРУЕТСЯ В ЕДИНСТВЕННОМ ЭКЗЕМПЛЯРЕ

. Хранит в себе данные API и различные функции по преобразованию различных показаний в "человеческие цифры". Является обязательным

для работы всех остальных.
  1. Глобальный "Погода Яндекс" - отвечает за получение информации из Яндекса
  2. Глобальный "Погода Openweather" - отвечает за получение информации из OpenWeather
  3. Глобальный "Погода AccuWeather" - отвечает за получение информации из AccuWeather
  4. Глобальный "Погода Yr.no" - отвечает за получение информации из Yr.no

Блочные сценарии для каждого сервиса

  1. Блочный AccuWeather City ID - отвечает за получение ID вашего города из координат, указанных в первом глобальном сценарии. Полученные данные вставить так же в первый глобальный сценарий в поле accuweather_city
  2. Блочный "Погода AccuWeather в Телеграм" - отправляет данные в Телеграм
  3. Блочный "Погода AccuWeather" - устанавливает значения виртуальных датчиков
  4. Блочный "Погода Яндекс в Телеграм" - отправляет данные в Телеграм
  5. Блочный "Погода Яндекс" - устанавливает значения виртуальных датчиков
  6. Блочный "Погода Yr.no датчики" - устанавливает значения виртуальных датчиков
  7. Блочный "Погода Yr.no в Телеграм" - отправляет данные в Телеграм
  8. Блочный "Погода OpenWeather в Телеграм" - отправляет данные в Телеграм
  9. Блочный "Погода OpenWeather" - устанавливает значения виртуальных датчиков

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


Блочные сценарии просто запрашивают полученные глобальными сценариями данные и отправляет их по назначению.

То есть, если вам нужны данные Яндекса отправлять в телеграм и присваивать значения датчикам, то вам необходимо будет два глобальных сценария (один главный, с переменными и собственно сам глобальный Яндекса) и два блочных (для датчиков и для телеграма, которые в принципе можно объединить в один).

Пример: Для получения погоды Яндекса, отправки ее в Telegram и присвоения данных виртуальным датчикам, необходимо импортировать Глобальные сценарии №1 и №2, а также блочные сценарии №4 и №5

Главный глобальный сценарий для работы всех остальных "Погода Переменные и другие украшательства"

Обязательный глобальный сценарий, который содержит все переменные с координатами и ключами API для всех сервисов.

В верхней части сценария заполняются координаты и API ключи сервисов. Сам сценарий - находится в глобальных и называется "Погода Переменные и другие украшательства"

var accuweather_api = "" /** API ключ от приложения для Core Weather из личного кабинета https://developer.accuweather.com/user/me/apps */
var yandex_api = "" /** API ключ из личного кабинета https://developer.tech.yandex.ru/services/ */
var openweather_api = "" /** API ключ из личного кабинета OpenWeather https://home.openweathermap.org/api_keys */
var lat = "55.786095" /** Широта вашего местоположения (можно взять из настроек хаба. там же есть карта для выбора точки) */
var lon = "37.577768" /** Долгота вашего местоположения (можно взять из настроек хаба. там же есть карта для выбора точки) */
var accuweather_city = "292929"; /** ID города для сервиса AccuWeather. Заполняется вручную. Получается запросом из отдельного сценария после заполнения ключа API и координат здесь */

Вы можете заполнять не все ключи API а только выбранный вами один сервис, но даже если вы хотите пользоваться данными от Yr.no где не требуется ключ API, вам этот сценарий все равно будет нужен, так как он содержит ваши координаты для прогноза, которые необходимо так же заполнить, как и все остальное

Это главный сценарий, без которого остальные работать не будут

Yr.No

Самый простой и доступный сервис. Не требует регистрации и получения API ключей и каких либо дополнительных действий. Но отдает только часовые показания. То есть когда бы вы ни запросили данные, прогноз будет показываться от начала часа.

Для работы, понадобятся глобальные сценарии №1 и №5, а также блочные сценарии №6 и №7

Необходимо заполнить только координаты в глобальном сценарии №1 и ID виртуальных датчиков для сценария №6

Переменные

  • global.yr.time - Время прогноза
  • global.yr.pressure - Атмосферное давление
  • global.yr.temp - Температура
  • global.yr.cloud - Уровень облачности (%)
  • global.yr.dewpoint - Точка росы
  • global.yr.fog - Уровень тумана (%)
  • global.yr.hum - Относительная влажность
  • global.yr.uv - Уровень ультрафиолета
  • global.yr.wind_deg - Направление ветра (в градусах)
  • global.yr.wind_dir - Направление ветра (текстовое)
  • global.yr.wind - Скорость ветра
  • global.yr.condition_1_hour - Состояние погоды в ближайший час
  • global.yr.condition_6_hours - Состояние погоды в ближайшие 6 часов
  • global.yr.condition_6_hours - Состояние погоды в ближайшие 12 часов
  • global.yr.temp_max_6_hours - Максимальная температура в ближайшие 6 часов
  • global.yr.temp_min_6_hours - Минимальная температура в ближайшие 6 часов
  • global.yr.prec - Уровень осадков в ближайшие 6 часов

OpenWeather

Для работы с этим сервисом, требуется регистрация на сайте и получение ключа API. Вам необходимо выбрать бесплатный тариф по этой ссылке, а потом сгенерировать свой API ключ, который находится в личном кабинете.

Для работы, понадобятся глобальные сценарии №1 и №3, а также блочные сценарии №8 и №9

Необходимо заполнить координаты и API ключ в глобальном сценарии №1 и ID виртуальных датчиков для сценария №9

Переменные для сценариев

  • global.ow.time - Время прогноза
  • global.ow.temp - Температура
  • global.ow.hum - Влажность
  • global.ow.pressure - Давление (мм. рт. ст.)
  • global.ow.wind - Скорость ветра (м/с)
  • global.ow.gust - Порывы ветра (м/с)
  • global.ow.wind_deg - Направление ветра (в градусах)
  • global.ow.wind_deg_text - Направление ветра в текстовом формате
  • global.ow.feels_like - Температура (Ощущается)
  • global.ow.temp_min - Минимальная температура
  • global.ow.temp_max - Максимальная температура
  • global.ow.clouds - Уровень облачности (%)
  • global.ow.visibility - Видимость (м)
  • global.ow.condition - Описание погоды (текстовое, для использования в Телеграм)
  • global.ow.sunrise - Время восхода
  • global.ow.sunset - Время заката

Яндекс

Для работы с Яндекс.Погодой, вам необходимо иметь учетную запись Яндекс.Паспорта и с ее помощью зарегистрироваться в разделе для разработчиков. Там необходимо подключить API Яндекс.Погоды и подключить бесплатный тариф. После того, как вы его подключите, вам необходимо в настройках сервиса сменить Тестовый тариф на бесплатный тариф, который подразумевает 50 запросов в сутки.

Для работы, понадобятся глобальные сценарии №1 и №2, а также блочные сценарии №4 и №5

Необходимо заполнить координаты и API ключ в глобальном сценарии №1 и ID виртуальных датчиков для сценария №5

Переменные

Текущий прогноз

  • global.ya.time - Время текущего прогноза
  • global.ya.forecast_time - Время прогноза будущих периодов
  • global.ya.forecast_date - Дата прогноза будущих периодов
  • global.ya.condition - Описание погоды (текстовое, для использования в Телеграм)
  • global.ya.moon_text - Фаза луны (текстовое поле для использования в Телеграм)
  • global.ya.temp - Температура
  • global.ya.feels_like - Температура (Ощущается)
  • global.ya.hum - Влажность
  • global.ya.wind_direction_ - Направление ветра (символ)
  • global.ya.wind_direction_text - Направление ветра (текстовое поле для использования в Телеграм)
  • global.ya.wind - Скорость ветра (м/с)
  • global.ya.gust - Порывы ветра (м/с)
  • global.ya.sunrise - Время восхода
  • global.ya.sunset - Время заката

Прогноз на следующий период суток (Если текущий период день, то на вечер)

  • global.ya.part_1_name - Наименование периода суток
  • global.ya.condition_1 - Описание погоды
  • global.ya.temp_min_1 - Минимальная температура
  • global.ya.temp_max_1 - Максимальная температура
  • global.ya.feels_like_1 - Температура (Ощущается)
  • global.ya.hum_1 - Влажность
  • global.ya.wind_direction_1_text - Направление ветра (текстовое поле для использования в Телеграм)
  • global.ya.wind_direction_1 - Направление ветра (символ)
  • global.ya.wind_1 - Скорость ветра (м/с)
  • global.ya.gust_1 - Порывы ветра (м/с)
  • global.ya.prec_1 - Вероятность осадков
  • global.ya.prec_period_1 - Продолжительность осадков
  • global.ya.prec_mm_1 - Уровень осадков (мм)

Прогноз на последующий период суток (Если текущий период день, то на ночь)

  • global.ya.part_2_name - Наименование периода суток
  • global.ya.condition_2 - Описание погоды (текстовое, для использования в Телеграм)
  • global.ya.temp_min_2 - Минимальная температура
  • global.ya.temp_max_2 - Максимальная температура
  • global.ya.feels_like_2 - Температура (Ощущается)
  • global.ya.hum_2 - Влажность
  • global.ya.wind_direction_2_text - Направление ветра (текстовое поле для использования в Телеграм)
  • global.ya.wind_dir_2 - Направление ветра (символ)
  • global.ya.wind_2 - Скорость ветра (м/с)
  • global.ya.gust_2 - Порывы ветра (м/с)
  • global.ya.prec_2 - Вероятность осадков
  • global.ya.prec_period_2 - Продолжительность осадков
  • global.ya.prec_mm_2 - Уровень осадков (мм)

AccuWeather

Для работы с сервисом AccuWeather, потребуется регистрация в системе и после регистрации, необходимо создать ключ API в разделе My Apps, где вы указываете необходимые параметры и подключение приложения к разделу Core Weather.

Получение погоды в системе работает несколько "по хитрому", поэтому вам для начала потребуется получить ID вашего города. Для этого вам надо загрузить дополнительный блочный шаблон для получения данных под названием AccuWeather City ID, который использует координаты, указанные в главном сценарии с переменными и украшательствами и отправляет вам в лог и в телеграм ID вашего города, который вы прописываете в переменную accuweather_city в том же глобальном сценарии, где указаны координаты. Его надо выполнить только один раз и получив ID города, этот сценарий можно удалить.

Для работы, понадобятся глобальные сценарии №1 и №4, а также блочные сценарии №1, №2 и №3

Необходимо однократно выполнить блочный сценарий №1, взять из лога или из сообщения в Телеграм ID города и заполнить поле accuweather_city и API ключ в глобальном сценарии №1, а также ID виртуальных датчиков для сценария №3

Переменные

  • global.acc.time - Время прогноза
  • global.acc.condition - Описание погоды (текстовое, для использования в Телеграм)
  • global.acc.cloud - Уровень облачности (%)
  • global.acc.temp - Температура
  • global.acc.temp_min - Минимальная температура
  • global.acc.temp_max - Максимальная температура
  • global.acc.real_temp - Температура RealTemp (зарегистрированная торговая марка AccuWeather)
  • global.acc.real_shade - Температура RealTemp в тени
  • global.acc.apparent_temp - Температура (Ощущается)
  • global.acc.wind_chill_temp - Температура (Ощущается открытой кожей)
  • global.acc.hum - Влажность
  • global.acc.indoor_hum - Влажность воздуха попадающего в помещение с улицы
  • global.acc.dewpoint - Точка росы
  • global.acc.uv - Уровень ультрафиолета
  • global.acc.uv_text - Уровень ультрафиолета (текстовое, для использования в Телеграм)
  • global.acc.wind - Скорость ветра (м/с)
  • global.acc.gust - Порывы ветра (м/с)
  • global.acc.wind_dir - направление ветра (английский символ)
  • global.acc.wind_dir_text - направление ветра (текстовое)
  • global.acc.wind_deg - направление ветра (в градусах)
  • global.acc.wind_deg_text - направление ветра (текстовое, вычисленное из градусов)
  • global.acc.visibility - видимость (км)
  • global.acc.pressure - атмосферное давление (мм.рт.ст.)
  • global.acc.precip - уровень осадков (мм)

Добавить показания реального датчика к прогнозу

Если у вас есть реальный датчик уличной температуры и вы хотите добавить его показания к прогнозу, то его надо просто добавить в список данных, отправляемых в блочном шаблоне.

На примере OpenWeather это выглядит так:

global.ow_request();
if (global.ow.error && !global.ow.temp) {log.warn("Данных OpenWeather нет: {}", global.ow.error_code); global.sendToTelegram(["Данных OpenWeather нет","Причина: " +  global.ow.error_code])} else {

global.sendToTelegram(["*Прогноз OpenWeather*",
        "=================================",
        "Данные получены в *: " + global.ow.time + "*",
        "=================================",
        "На улице *" + global.ow.condition + "*",
        "Облачность: *" + global.ow.clouds + "%*",
        "Видимость: *" + global.ow.visibility + " м.*",
        "---------------------------------------------",
        "Температура (факт):* " + Hub.getCharacteristicValue(552,15) + " °C*",
        "Температура (прогноз):* " + global.ow.temp + " °C*",
        "Ощущается:* " + global.ow.feels_like +" °C*",
        "---------------------------------------------",        
        "Минимальная: *" + global.ow.temp_min + "°C*",
        "Максимальная: *" + global.ow.temp_max + "°C*",
        "---------------------------------------------",        
        "Относительная влажность:* " + global.ow.hum + " %*",
        "---------------------------------------------",
        "Атмосферное давление: *" + global.ow.pressure + " мм.рт.ст.*",
        "---------------------------------------------",
        "Ветер: *" + global.ow.wind_deg_text +"*", 
        "Скорость ветра: *" + global.ow.wind + " м/с*", 
        "С порывами до: *" + global.ow.gust + " м/с*",
        "---------------------------------------------",
        "Восход: *" + global.ow.sunrise +"*",
        "Закат:    *" + global.ow.sunset +"*",
        "=================================",
        ]);
}

Где Hub.getCharacteristicValue(552,15) - это значение характеристики 15 у аксессуара номер 552. Как их узнать у реального датчика температуры, рассказано в этой инструкции.