Просмотр кода страницы Получение онлайн прогноза погоды

{{QuoteRed|Уровень сложности ВЫСОКИЙ. Подходит только для продвинутых пользователей, кто понимает как работают глобальные сценарии и умеет работать с кодом}}

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

Для всех сервисов, кроме Yr.no - требуется получение API ключей. То есть вам нужно зарегистрироваться в сервисе как разработчик и получить API ключ, который потом необходимо вставить в один ключевой глобальный сценарий, который обязателен для работы всех остальных в наборе. 
{{QuoteYellow|Все шаблоны можно скачать и импортировать в сценарии вашего Sprut.hub как показано [[Сценарии в 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 Скачать шаблоны всех сценариев одним архивом]

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

=== Глобальные сценарии ===
1. [[Получение онлайн прогноза погоды#Главный глобальный сценарий для работы всех остальных "Погода Переменные и другие украшательства"|Глобальный сценарий '''"Погода Переменные и другие украшательства"''']] 
{{QuoteYellow|{{Color|red|ЕДИН ДЛЯ ВСЕХ СЦЕНАРИЕВ. ИМПОРТИРУЕТСЯ В ЕДИНСТВЕННОМ ЭКЗЕМПЛЯРЕ}}. Хранит в себе данные API и различные функции по преобразованию различных показаний в "человеческие цифры". {{Color|red|Является обязательным}} для работы всех остальных}}
2. Глобальный '''"Погода Яндекс"''' - отвечает за получение информации из Яндекса

3. Глобальный '''"Погода Openweather"''' - отвечает за получение информации из OpenWeather

4. Глобальный '''"Погода AccuWeather"''' - отвечает за получение информации из AccuWeather

5. Глобальный '''"Погода Yr.no"''' - отвечает за получение информации из Yr.no

=== Блочные сценарии для каждого сервиса ===
#Блочный '''AccuWeather City ID''' - отвечает за получение ID вашего города из координат, указанных в первом глобальном сценарии. Полученные данные вставить так же в первый глобальный сценарий в поле '''accuweather_city'''
#Блочный '''"Погода AccuWeather в Телеграм"''' - отправляет данные в Телеграм
# Блочный '''"Погода AccuWeather"''' - устанавливает значения виртуальных датчиков
# Блочный '''"Погода Яндекс в Телеграм"''' - отправляет данные в Телеграм
# Блочный '''"Погода Яндекс"''' - устанавливает значения виртуальных датчиков
# Блочный '''"Погода Yr.no датчики"''' - устанавливает значения виртуальных датчиков
# Блочный '''"Погода Yr.no в Телеграм"''' - отправляет данные в Телеграм
# Блочный '''"Погода OpenWeather в Телеграм"''' - отправляет данные в Телеграм
# Блочный '''"Погода OpenWeather"''' - устанавливает значения виртуальных датчиков
{{Color|red|Ни один блочный сценарий не будет работать если не настроен глобальный сценарий с переменными и украшательствами и соответствующий сервису глобальный сценарий, получающий данные.}} 

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

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

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

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

* [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]] обязательный глобальный сценарий '''№1 "Погода Переменные и другие украшательства"'''
* Заполнить [[Получение онлайн прогноза погоды#Главный глобальный сценарий для работы всех остальных "Погода Переменные и другие украшательства"|координаты и API ключи в глобальном сценарии Погода Переменные и другие украшательства]]
* При использовании сервиса AccuWeather - импортировать шаблон блочного сценария '''Accuweather City ID''' для получения ID вашего города и вставить полученный ID города (его видно в логе или в телеграме) в глобальный сценарий №1
* [[Получение онлайн прогноза погоды#Присвоение данных прогноза погоды виртуальным датчикам|Создать виртуальные датчики]] температуры, влажности и другие для отображения показаний как описано в [[Создание виртуальных аксессуаров|инструкции о создании виртуальных аксессуаров]]. Для каждого сервиса погоды - свой набор датчиков.
* Импортировать соответствующий нужному сервису погоды '''глобальный''' сценарий этого сервиса
* Импортировать соответствующий нужному сервису погоды '''блочный сценарий отправки данных в Телеграм'''
* Импортировать соответствующий нужному сервису погоды '''блочный сценарий установки значений датчиков'''
* Прописать ID созданных аксессуаров и датчиков в [[Получение онлайн прогноза погоды#Присвоение данных прогноза погоды виртуальным датчикам|блочном сценарии установки значений датчиков]]
* Пользоваться

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

{{Color|red|В верхней части сценария заполняются координаты и API ключи сервисов. Сам сценарий - находится в глобальных и называется "Погода Переменные и другие украшательства"}}
<syntaxhighlight lang="js" line="1">
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 и координат здесь */

</syntaxhighlight>

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

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

{{QuoteBlue|Для работы, понадобятся [[Получение_онлайн_прогноза_погоды#Структура_сценариев_для_использования|глобальные сценарии №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. Вам необходимо выбрать бесплатный тариф по [https://openweathermap.org/price#weather этой ссылке], а потом сгенерировать свой API ключ, который находится в [https://home.openweathermap.org/myservices личном кабинете].

{{QuoteBlue|Для работы, понадобятся [[Получение_онлайн_прогноза_погоды#Структура_сценариев_для_использования|глобальные сценарии №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''' - Направление ветра ([http://snowfence.umn.edu/Components/winddirectionanddegrees.htm в градусах])
* '''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''' - Время заката

== Яндекс ==
Для работы с Яндекс.Погодой, вам необходимо иметь учетную запись Яндекс.Паспорта и с ее помощью зарегистрироваться в [https://developer.tech.yandex.ru разделе для разработчиков]. Там необходимо подключить API Яндекс.Погоды и подключить бесплатный тариф. После того, как вы его подключите, вам необходимо в настройках сервиса сменить Тестовый тариф на бесплатный тариф '''"Погода на вашем сайте"''', который подразумевает 50 запросов в сутки. 

{{color|red|Несмотря на то, что вы можете выбрать нужный вам тариф "Погода на вашем сайте" при первичном подключении API, в итоге в вашем личном кабинете может все равно показываться Тестовый тариф. Поэтому вам нужно еще раз переключить тариф на нужный.}}
{{QuoteYellow|Если у вас периодически появляется ошибка при обновлении данных - увеличьте время в блочном сценарии с 30 минут на бОльший период. Например 1 час}}
{{QuoteBlue|Для работы, понадобятся [[Получение_онлайн_прогноза_погоды#Структура_сценариев_для_использования|глобальные сценарии №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, потребуется регистрация в системе и после регистрации, необходимо [https://developer.accuweather.com/user/me/apps создать ключ API в разделе My Apps], где вы указываете необходимые параметры и подключение приложения к разделу '''Core Weather.'''

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

{{QuoteBlue|Для работы, понадобятся [[Получение_онлайн_прогноза_погоды#Структура_сценариев_для_использования|глобальные сценарии №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 это выглядит так:<syntaxhighlight lang="js" line="1">
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 +"*",
        "=================================",
        ]);
}
</syntaxhighlight>Где '''Hub.getCharacteristicValue(552,15)''' - это значение характеристики 15 у аксессуара номер 552. Как их узнать у реального датчика температуры, рассказано в [[Аксессуары, сервисы и характеристики#Идентификаторы аксессуара, сервиса и характеристики|этой инструкции]].

== Присвоение данных прогноза погоды виртуальным датчикам ==
Для присвоения значений, полученных из Яндекс Погоды датчикам в Sprut.hub - необходимо создать виртуальное устройство и наполнить его следующими датчиками (в скобках указан номер строки в блоке кода ниже, которая относится к этому датчику):

# Датчик текущей температуры (строка 3)
# Датчик минимальной температуры (строка 4)
# Датчик максимальной температуры (строка 5)
# Датчик температуры "ощущается" (строка 6)
# Датчик влажности (строка 7)
# Датчик атмосферного давления (строка 8)
# Угол - который используется для отображения скорости ветра (строка 9)
[[Файл:Сценарии 025 Датчики погоды.png|центр|обрамить]]
У каждого из этих датчиков есть идентификатор аксессуара и идентификатор нужного вам сервиса. Для датчика температуры - это температура, для датчика влажности это влажность. Необходимо выяснить [[Аксессуары, сервисы и характеристики#Идентификаторы аксессуара, сервиса и характеристики|в соответствии с инструкцией]] - идентификаторы аксессуара и сервиса для "Температура" у каждого датчика температуры из списка и идентификаторы аксессуаров для датчика влажности, давления и скорости ветра.

В указанном примере, например в строке 3: 

590 - это идентификатор аксессуара датчика текущей температуры

13 - это идентификатор сервиса датчика температуры 
<syntaxhighlight lang="js" line="1">
global.ya_request();
if (global.ya.error && !global.ya.temp) {log.warn("Данных Yandex нет: {}", global.ya.error_code)} else {
Hub.getAccessory(590).getService(13).getCharacteristic(HC.CurrentTemperature).setValue(global.ya.temp)
Hub.getAccessory(590).getService(22).getCharacteristic(HC.CurrentTemperature).setValue(global.ya.temp_min_1)
Hub.getAccessory(590).getService(25).getCharacteristic(HC.CurrentTemperature).setValue(global.ya.temp_max_1)
Hub.getAccessory(590).getService(28).getCharacteristic(HC.CurrentTemperature).setValue(global.ya.feels_like)
Hub.getAccessory(590).getService(HS.HumiditySensor).getCharacteristic(HC.CurrentRelativeHumidity).setValue(global.ya.hum)
Hub.getAccessory(590).getService(HS.C_AtmosphericPressureSensor).getCharacteristic(HC.C_CurrentAtmosphericPressure).setValue(global.ya.pressure)
Hub.getAccessory(590).getService(HS.C_AngleMeter).getCharacteristic(HC.C_Angle).setValue(global.ya.wind)
}
</syntaxhighlight>Для остальных сервисов необходимо проделать такие же манипуляции. Все эти блочные сценарии есть в архиве.