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

Материал из Sprut.hub Wiki
Нет описания правки
Метка: wikieditor
Нет описания правки
Строка 2: Строка 2:


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


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

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

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

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

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

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

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

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

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

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

  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. Как их узнать у реального датчика температуры, рассказано в этой инструкции.