Pular para o conteúdo
POST AI agent ready /v1/weather/current

API meteorológica - Condições atuais por cidade ou coordenadas

Retorna dados meteorológicos atuais para um local especificado pelo nome da cidade ou latitude/longitude. A resposta inclui temperatura (com sensação), umidade, precipitação, velocidade e direção do vento, cobertura de nuvens, um código meteorológico numérico e uma descrição legível por humanos.

Parameters

string

City name to look up weather for. Provide either city or lat/lng.

number

Latitude of the location. Use with lng.

number

Longitude of the location. Use with lat.

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

Conteúdo dinâmico baseado no clima local

Personalize banners da página inicial ou recomendações de produtos com base no clima local do visitante. Um site de varejo pode promover guarda-chuvas quando está chovendo ou protetor solar durante o céu limpo, aumentando as taxas de conversão com relevância contextual.

Logística e planejamento de rotas de entrega

Verifique as condições meteorológicas ao longo das rotas de entrega antes de enviar os motoristas. Sinalize rotas com ventos fortes ou precipitação intensa para que os despachantes possam redirecionar ou atrasar remessas para proteger as mercadorias e a segurança do motorista.

IoT e automação residencial inteligente

Pesquise dados meteorológicos atuais para acionar ações domésticas inteligentes. Feche as persianas motorizadas quando a cobertura de nuvens cair abaixo de 20%, ative os sprinklers somente quando a precipitação for zero ou ajuste os pontos de ajuste do termostato com base na temperatura ambiente.

Frequently asked questions

Devo usar o nome da cidade ou coordenadas?
Qualquer um funciona. O nome da cidade é conveniente para entradas do usuário. As coordenadas são mais precisas e evitam ambiguidades quando várias cidades compartilham o mesmo nome (por exemplo, "Springfield" existe em mais de 30 estados dos EUA).
Qual unidade de temperatura é retornada?
As temperaturas são retornadas em Celsius por padrão. O campo da unidade na resposta confirma isso. Converta para Fahrenheit do lado do cliente com a fórmula F = C * 9/5 + 32.
Com que frequência os dados meteorológicos são atualizados?
Os dados meteorológicos são atualizados a cada 15 minutos a partir de fontes upstream. Para a maioria dos aplicativos, armazenar respostas em cache por 10 a 15 minutos é seguro e reduz as chamadas de API.
O que o campo weather_code representa?
O weather_code é um código numérico de interpretação meteorológica da WMO. Valores comuns: 0 = céu claro, 1-3 = parcialmente nublado, 45/48 = neblina, 51-67 = garoa/chuva, 71-77 = neve, 80-82 = pancadas de chuva, 95+ = trovoada. O campo de descrição fornece o rótulo legível.
O que acontece se nem a cidade nem as coordenadas forem fornecidas?
O endpoint retorna um erro solicitando que você forneça um nome de cidade ou um par lat/lng. Pelo menos um parâmetro de localização é obrigatório.

Get your API key

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