POST AI agent ready /v1/weather/current

API погоды — текущие условия по городу или координатам

Возвращает текущие данные о погоде для местоположения, указанного названием города или широтой/долготой. Ответ включает температуру (по ощущениям), влажность, осадки, скорость и направление ветра, облачность, цифровой код погоды и удобочитаемое описание.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/weather/current \
  -H "Content-Type: application/json" \
  -d '{"city":"London","lat":51.5074,"lng":-0.1278}'

When to use this API

Динамический контент, основанный на местной погоде

Персонализируйте баннеры на главной странице или рекомендации по продуктам с учетом местной погоды посетителя. Сайт розничной торговли может рекламировать зонтики во время дождя или солнцезащитные кремы в ясную погоду, повышая коэффициент конверсии с учетом контекста.

Логистика и планирование маршрута доставки

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

Интернет вещей и автоматизация умного дома

Опрашивайте текущие данные о погоде, чтобы активировать действия умного дома. Закрывайте жалюзи с электроприводом, когда облачность падает ниже 20 %, активируйте разбрызгиватели только тогда, когда количество осадков нулевое, или регулируйте уставки термостата в зависимости от комфортной температуры.

Frequently asked questions

Должен ли я использовать название города или координаты?

Либо работает. Название города удобно для ввода данных пользователем. Координаты становятся более точными и позволяют избежать двусмысленности, когда несколько городов имеют одно и то же название (например, Спрингфилд существует более чем в 30 штатах США).

Какая единица измерения температуры возвращается?

По умолчанию температуры возвращаются в градусах Цельсия. Поле единицы измерения в ответе подтверждает это. Преобразование в градусы Фаренгейта на стороне клиента по формуле F = C * 9/5 + 32.

Как часто обновляются данные о погоде?

Данные о погоде обновляются каждые 15 минут из источников, расположенных выше по течению. Для большинства приложений кэширование ответов на 10–15 минут на вашей стороне безопасно и сокращает количество вызовов API.

Что представляет собой поле Weather_code?

Weather_code — это числовой код интерпретации погоды ВМО. Общие значения: 0 = ясное небо, 1–3 = переменная облачность, 45/48 = туман, 51–67 = морось/дождь, 71–77 = снег, 80–82 = ливень, 95+ = гроза. Поле описания содержит удобочитаемую метку.

Что произойдет, если не будет указан ни город, ни координаты?

Конечная точка возвращает ошибку и просит вас указать название города или пару широты и долготы. Требуется хотя бы один параметр местоположения.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.