Координаты или название города, период, нужные показатели и единицы измерения.
Погодные значения, единицы, временные отметки и URL запросов; для США — официальные предупреждения.
Кому пригодится
Пользователям и разработчикам, которым нужны погодные данные по выбранному месту.
Требования и ограничения
Получение погоды из публичных API
Скилл запрашивает погодные данные по сети и возвращает значения с единицами, временем и адресом источника. Он охватывает текущую погоду, прогноз, исторические сведения, качество воздуха и официальные предупреждения для США. Основным сервисом в исходнике выбран Open-Meteo, для американских предупреждений — National Weather Service.
Уточнить место и период
Для запроса нужны координаты, период и единицы измерения. Если известен только город, сначала выполняется поиск его координат. При неоднозначном названии важно сопоставить найденное место с запросом пользователя. Поиск адресов и объектов, обратное геокодирование и другие географические задачи исходник передаёт отдельному инструменту.
Выбрать нужный вид данных
Для текущих условий и прогноза используется один маршрут API, для архива и качества воздуха — отдельные. Агент выбирает переменные, которые нужны для ответа: например, температуру, ветер или осадки. В запросах суточных данных учитывается часовой пояс. Глубину архива, горизонт прогноза и доступность последних дат следует сверять с текущей документацией сервиса.
Правильно прочитать ответ
Единицы берутся из полей ответа, а не предполагаются по названию показателя. Время измерения или прогноза сопровождает значения. Числовой код погодного явления переводится в понятное описание. Показатели концентрации частиц и индексы качества воздуха различаются по смыслу, поэтому их нельзя выдавать как одно и то же число.
Обработать официальные предупреждения США
Для National Weather Service исходник предусматривает заголовок User-Agent и чтение события, серьёзности, текста и срока действия предупреждения. Получение точечного прогноза выполняется через ссылку, возвращённую сервисом для координат. Этот маршрут относится к США и не заменяет местные системы предупреждений в других странах.
Вернуть данные вместе с происхождением
Результат содержит запрошенные значения, единицы, временные отметки и точный URL обращения. В исходнике описан доступ без пользовательского API-ключа, но условия бесплатного и коммерческого использования необходимо уточнять перед внедрением. Скилл не охватывает землетрясения, космическую погоду и экономические показатели климата; название каталога не расширяет этот фактический объём.
Автор и источник
Оригинальное название: weather-climate
Автор или репозиторий: SkillMedev/skills
Лицензия: MIT
Открыть первоисточник