ВАЖНОЕ ЗАМЕЧАНИЕ: ДАННЫЙ ПЛАГИН СЕЙЧАС ПОДДЕРЖАН!
(Продолжайте читать — у меня есть и хорошие новости)
Open Weather прекратила поддержку API 2.5, на котором основан этот плагин. Они предлагают API 3.0, который бесплатен, но для подписки на API требуется кредитная карта. Я не заинтересован в том, чтобы дать какой-либо компании возможность автоматически взимать с меня плату за что-то в будущем, когда/если они решат это сделать. Я почти уверен, что на самом деле этого никогда не произойдет, но могу сказать, что я абсолютно уверен, что этого не произойдет, если у них нет информации о моей кредитной карте. Кроме того, если бы они начали взимать плату с пользователей этого плагина (около 10 000 пользователей) по какой-то непредвиденной причине, это вызвало бы недовольство многих людей мной, и это было бы, по меньшей мере, неприятно...
Еще один момент заключается в том, что между этими двумя API достаточно различий, поэтому, по сути, потребуется полная перезапись плагина, что приводит к моим хорошим новостям... Я почти завершил новый плагин погоды, основанный на Visual Crossing Weather. API. Подписка бесплатна и не требует ничего, кроме вашего адреса электронной почты. Вы можете зарегистрироваться здесь. Он предлагает множество замечательных функций, которых не было в Open Weather. Например, было 15 полных дней прогноза, в то время как в Open Weather было только 5, и в течение 21 часа из каждых 24 день 1 и 5 не возвращали полные данные за эти дни. VCW API также возвращает почасовые данные за каждый из этих 15 дней, тогда как OW возвращает данные только блоками по 3 часа. Другие приятные функции, которые предлагает VCW API и отсутствует OW API, — это оповещения о погоде, данные возвращаются по местному времени, а не по Гринвичу (преобразования не требуются). Документация по API также намного лучше и имеет активный форум поддержки. В целом, это просто более приятный API для работы.
Если вы хотите попробовать новый плагин прямо сейчас, вы можете найти плагин Visual Crossing Weather здесь. Он имеет некоторые большие улучшения по сравнению со старым плагином. Теперь у него есть 5 мест, для которых вы можете получить данные о погоде, а не только одно. Я удвоил количество шаблонов погоды с 4 до 8. Теперь в строке состояния есть 2 строки, которые можно переключать каждые 30 секунд. По умолчанию первый содержит информацию о погоде на сегодня, второй отображает информацию о погоде на завтра. Обратите внимание, что хотя работа над этим все еще находится в стадии разработки, в нем уже работают почти все функции (две функции, которые я все еще хочу добавить, еще не завершены). Документации на данный момент также практически не существует, хотя у меня есть полный список текущих созданных макросов (уже около 4000), и он отображается в удобном для чтения табличном формате. Я также загрузил файл main.js, если вы хотите выполнить установку вручную или можете использовать плагин BRAT, который сделает всю работу за вас. Для всех, кто желает принять участие в бета-тестировании, было бы огромной помощью, если бы они могли предоставить какие-либо отзывы.
Обратите внимание, что API должен был быть прекращен 3 недели назад, но на данный момент он все еще возвращает данные. Это может прекратиться в любой момент!!! К счастью, это продолжалось так долго, поскольку это дало мне время написать новый плагин. Я попрошу удалить этот плагин из списка плагинов сообщества, когда API перестанет работать или я добавлю новый плагин в список плагинов сообщества.
Спасибо всем пользователям плагина с момента его создания, Уильям Маккивер.
' | %desc% | Current Temp: %temp%°C | Feels Like: %feels%°C | '
'%desc% • Current Temp: %temp%°C • Feels Like: %feels%°Cn'
'%name%: %dateMonth4% %dateDay2% - %timeH2%:%timeM% %ampm1%nCurrent Temp: %temp%°C • Feels Like: %feels%°CnWind: %wind-speed% km/h from the %wind-dir%^ with gusts up to %wind-gust% km/h^nSunrise: %sunrise% • Sunset: %sunset%n'
'%icon% %dateMonth4% %dateDay2% %dateYear1% • %timeH2%:%timeM% %ampm1% • %desc%<br> Recorded Temp: %temp% • Felt like: %feels%<br> Wind: %wind-speed% km/h from the %wind-dir%^ with gusts up to %wind-gust% km/h^<br> Sunrise: %sunrise% • Sunset: %sunset%'
'%icon% %dateMonth4% %dateDay2% %dateYear1% • %timeH2%:%timeM% %ampm1% • %desc%<br> Current Temp: %temp% • Feels like: %feels%<br> Wind: %wind-speed% km/h from the %wind-dir%^ with gusts up to %wind-gust% km/h^<br> Sunrise: %sunrise% • Sunset: %sunset%'
Форматировать строку три...
Форматировать четвертую строку...
Примечание. Символы n
не требуются при редактировании в настройках. Просто введите return
, чтобы добавить новую строку, и n
будет добавлен в сохраненный файл настроек. <br>
в строковых форматах 3 и 4 необходимы для использования в HTML.
См. EXAMPLE.md для демонстрации того, как я использую это в своем ежедневном шаблоне.
Введите здесь свой ключ API OpenWeather (обязательно)
Для работы плагина требуется бесплатный ключ API OpenWeather. Перейдите на https://openweathermap.org, чтобы зарегистрироваться и получить ключ. Прямая ссылка на страницу регистрации https://home.openweathermap.org/users/sign_up.
Примечание. Вам нужно будет подтвердить свой адрес электронной почты, после чего ключ API будет отправлен вам по электронной почте. Сам ключ может занять пару часов, прежде чем он будет активирован. Вся эта информация будет включена в электронное письмо, которое они отправят вам.
Этот API геокодирования возвращает название запрошенного местоположения, штат, страну, широту и долготу, что позволяет вам выбрать правильное местоположение. Это полезно в тех случаях, когда ваш город имеет общее название, используемое другими городами. Чтобы использовать это, введите название своего города в текстовое поле и нажмите кнопку Get location
. Вам будет предложен список из 5 мест на выбор.
Примечание. Рекомендуется использовать новую команду Use Geocoding API to get location (recommended)
чтобы заполнить ее за вас.
Введите название вашего города (этот параметр обязателен, если не определены широта и долгота). Примечание. Если вы получаете неверные данные, попробуйте указать коды штата и страны. Их можно ввести как {название города}, {код штата}, {код страны}. Например. Саут-Бенд, Вашингтон, США (запятые обязательны). Если у вас по-прежнему возникают проблемы с получением правильных данных, используйте вместо этого настройки широты и долготы.
Примечание. Рекомендуется использовать новую команду Use Geocoding API to get location (recommended)
чтобы заполнить ее за вас.
Введите широту вашего города (настройка широты и долготы переопределяет настройку местоположения).
Обратите внимание, что запросы API по названию города устарели, хотя они по-прежнему доступны для использования. Предпочтительный метод — использовать широту и долготу.
Примечание. Рекомендуется использовать новую команду Use Geocoding API to get location (recommended)
чтобы заполнить ее за вас.
Введите долготу вашего города (настройка широты и долготы переопределяет настройку местоположения).
Обратите внимание, что запросы API по названию города устарели, хотя они по-прежнему доступны для использования. Предпочтительный метод — использовать широту и долготу.
Здесь можно выбрать метрическую, британскую и стандартную единицы измерения. (Примечание: стандарт указан в Кельвинах, что в большинстве случаев бесполезно)
Доступны поддерживаемые языки (всего 46 языков). Примечание. Это относится только к тексту, возвращаемому API Open Weather. Это не меняет текст в определенных строках погоды. Если вы хотите, чтобы текст в строках погоды по умолчанию был на другом языке, вам нужно будет отредактировать их непосредственно в настройках.
Папка, которую необходимо исключить из автоматической замены строк шаблона. Это должно быть установлено в папке шаблонов ваших хранилищ. Исключение включает в себя любые подпапки внутри выбранной папки.
Определите здесь строки погоды (доступно 4 строки + 1 для строки состояния)
Совет: Эти строки могут содержать все что угодно, а не только информацию о погоде.
Включить или выключить отображение текущей погоды в строке состояния
Определите здесь строку погоды в строке состояния.
Интервал времени для обновления погоды, отображаемой в строке состояния и DIV (1, 5, 10, 15, 20, 30 или 60 минут)
Эти макросы, содержащиеся в строке погоды, будут заменены соответствующими данными.
%desc%
%desc-em%
%icon%
— см. примечание ниже.%icon2x%
— см. примечание ниже.%temp%
%feels%
%tempmin%
%tempmax%
%pressure%
%humidity%
%pressure-sl%
%pressure-gl%
%visibility%
%wind-speed%
- км/ч для метрической системы, мили в час для британской системы мер%wind-speed-ms%
- м/с (метров в секунду)%wind-dir%
— например. Северо-Запад%wind-gust%
— см. примечание ниже.%clouds%
(в процентах)%rain1h%
(в миллиметрах)%rain3h%
(в миллиметрах)%snow1h%
(в миллиметрах)%snow3h%
(в миллиметрах)%precipitation1h%
(в миллиметрах — дождь или снег)%precipitation3h%
(в миллиметрах — дождь или снег)%sunrise%
- 08:30:30 (24-часовой формат)%sunset%
- 19:30:30 (24-часовой формат)%name%
— например. Эдмонтон%latitude%
– например. 46,66%longitude%
— например. -123,80%aqinumber%
— от 1 до 5 (порядок соответствует списку строк)%aqistring%
— «Хорошо», «Удовлетворительно», «Умеренно», «Плохо», «Очень плохо» (порядок соответствует списку чисел)%dateYear1%
- 2022 г.%dateYear2%
- 22%dateMonth1%
- 1%dateMonth2%
- 01%dateMonth3%
– январь%dateMonth4%
– январь%dateDay1%
- 2%dateDay2%
- 02%ampm1%
— «АМ»%ampm2%
— «есть»%timeH1%
- 23 (24 часа)%timeH2%
- 1 (12 часов)%timeM%
- 05%timeS%
- 05 Примечание. Прогноз на 5 дней возвращается с шагом в 3 часа (всего 40 объектов данных). Это означает, что данные, возвращаемые API, начинаются не в 12:00 завтрашнего дня, а для следующего трехчасового фрагмента доступных данных. Это означает, что только один раз в день вы можете получить полный прогноз на 5 дней (незадолго до полуночи). В остальное время вы получите частичные данные за сегодняшний день и частичные данные за последний день. Вам необходимо будет учитывать это при определении строк погоды. Чтобы вам было проще, я включил заполнители %next12%
, %next24%
и %next48%
(см. пример заполнителя) и добавлю больше в будущем.
Примечание. Заполнители представляют собой объекты прогноза на 3 часа и имеют номера 00, 01, 02, ... 39 в заполнителях.
%fyear_00%
до %fyear_39%
— прогнозный год. Например. 2024 год
%fmonth_00%
до %fmonth_39%
— месяц прогноза, например. 05
%fdate_00%
до %fdate_39%
— дата прогноза. Например. 26
%fhours_00%
до %fhours_39%
— прогнозируемые часы, например. 18
%fmins_00%
до %fmins_39%
— минуты прогноза, например. 00 (всегда будет 00)
%fsecs_00%
до %fsecs_39%
— прогнозируемые секунды, например. 00 (всегда будет 00)
%dt_localtime_00%
до %dt_localtime_39%
— прогноз локальной строки даты и времени. Например. 2024-05-26 18:00:00
%d_localtime_00%
до %d_localtime_39%
— прогнозируемая строка местной даты. Например. 2024-05-26
%ds_localtime_00%
до %ds_localtime_39%
— короткая строка прогноза местной даты. Например. 05-26
%t_localtime_00%
до %t_localtime_39%
— прогнозируемая строка местного времени. Например. 18:00:00
%ts_localtime_00%
до %ts_localtime_39%
— короткая строка прогноза местного времени. Например. 18:00
%ftemp_00%
до %ftemp_39%
— прогнозируемая температура. Например. 15
%ffeels_00%
до %ffeels_39%
— прогноз ощущается как температура. Например. 14
%fclouds_00%
до %fclouds_39%
— прогнозируемое облачное покрытие. Например. 99
%fpop_00%
до %fpop_39%
— вероятность осадков. Например. 100
%fpod_00%
до %fpod_39%
— часть дня (n — ночь, d — день). Например. д
%fvis_00%
до %fvis_39%
— видимость в футах. Например. 10000
%fhum_00%
до %fhum_39%
— процент влажности. Например. 70
%ftempmax_00%
до %ftempmax_39%
— максимальная температура. Например. 16
%ftempmin_00%
до %ftempmin_39%
— минимальная температура. Например. 15
%fground_00%
до %fground_39%
— давление на уровне земли в миллибарах. Например. 928
%fsea_00%
до %fsea_39%
— давление на уровне моря в миллибарах. Например. 1007
%fdesc_00%
до %fdesc_39%
— описание погоды. Например. Легкий дождь
%fmaindesc_00%
до %fmaindesc_39%
— основное описание погоды. Например. Дождь
%fdescem_00%
до %fdescem_39%
— смайлики с описанием погоды, например. ?️
%ficonurl_00%
до %ficonurl_39%
— URL-адрес значка погоды. Например. https://openweathermap.org/img/wn/10d.png
%ficonurl2x_00%
до %ficonurl2x_39%
— URL-адрес значка погоды в двойном размере. Например. https://openweathermap.org/img/wn/[email protected]
%fwindspeed_00%
до %fwindspeed_39%
— скорость ветра в милях в час. Например. 7
%fwindspeedms_00%
до %fwindspeedms_39%
— скорость ветра в метрах в секунду. Например. 2
%fwinddeg_00%
до %fwinddeg_39%
— направление ветра в градусах. Например. 198
%fwinddir_00%
до %fwinddir_39%
— направление ветра. Например. Юг
%fwindgust_00%
до %fwindgust_39%
— порывы ветра в милях в час. Например. 7
%fwindgustms_00%
до %fwindgustms_39%
— порывы ветра метров в секунду. Например. 2
%next12%
— список прогнозов на ближайшие 12 часов. Например...
%next24%
— список прогнозов на ближайшие 24 часа. Например...
%next48%
— список прогнозов на ближайшие 48 часов. Например...
%icon%
и %icon2x%
— заменяются тегом изображения <img src={Icon Url} />
Это более полезно, если оно встроено в блок кода div.
%wind-gust%
Эти данные возвращаются API только в том случае, если условие существует. Чтобы отображать строковые данные только в том случае, если они существуют, вы можете окружить их символами курсора.
Например: Winds %wind-speed% km/h^ with gusts up to %wind-gust% km/h^
При использовании данных о порывах ветра это преобразуется в: Winds 10 km/h with gusts up to 20 km/h
Без данных о порывах ветра это будет преобразовано в: Winds 10 km/h
(Текст, окруженный курсорами, будет удален)
OpenWeather: Insert weather string one
— вставляет первую строку погоды в текущий документ.OpenWeather: Insert weather string two
— вставляет вторую строку погоды в текущий документ.OpenWeather: Insert weather string three
— вставляет третью строку погоды в текущий документ.OpenWeather: Insert weather string four
— вставляет четвертую строку погоды в текущий документ.OpenWeather: Replace template string
. При этом все вхождения строк %weather1%
, %weather2%
, %weather3%
и %weather4%
будут заменены соответствующими определенными строками погоды. См. также Поддержка шаблонов. Вы можете поместить следующие строки в свои шаблоны, и при создании нового документа с использованием шаблона они будут автоматически заменены соответствующими строками погоды.
%weather1%
— вставляет строку погоды One.%weather2%
— вставляет строку погоды два.%weather3%
— вставляет строку погоды Три.%weather4%
— вставляет строку погоды четыре. Вы можете вставить следующий DIV в свои документы, чтобы обеспечить динамическую погоду, которая обновляется с частотой, установленной в настройках «Обновление частоты» . weather_historical_3
— это статическая температура на момент создания документа, а weather_current_1
— динамическая. См. EXAMPLE.md для демонстрации того, как я использую их в своем ежедневном шаблоне.
< div class =" weather_historical_3 " > %weather3% </ div >
< div class =" weather_current_1 " > </ div >
Вы можете использовать следующий класс для вставки соответствующих строк погоды
и...