Ir al contenido
POST AI agent ready /v1/weather/current

API meteorológica: condiciones actuales por ciudad o coordenadas

Devuelve datos meteorológicos actuales para una ubicación especificada por nombre de ciudad o latitud/longitud. La respuesta incluye temperatura (con sensación), humedad, precipitación, velocidad y dirección del viento, nubosidad, un código meteorológico numérico y una descripción legible 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

Contenido dinámico basado en el clima local.

Personalice los banners de la página de inicio o las recomendaciones de productos según el clima local del visitante. Un sitio minorista puede promocionar paraguas cuando llueve o protector solar cuando el cielo está despejado, lo que aumenta las tasas de conversión con relevancia contextual.

Logística y planificación de rutas de entrega.

Verifique las condiciones climáticas a lo largo de las rutas de entrega antes de enviar conductores. Marque rutas con fuertes vientos o fuertes precipitaciones para que los despachadores puedan desviar o retrasar los envíos para proteger las mercancías y la seguridad de los conductores.

IoT y domótica inteligente

Consulta los datos meteorológicos actuales para activar acciones en el hogar inteligente. Cierre las persianas motorizadas cuando la nubosidad caiga por debajo del 20%, active los aspersores solo cuando la precipitación sea cero o ajuste los puntos de ajuste del termostato según la temperatura que se sienta.

Frequently asked questions

¿Debo usar el nombre de la ciudad o las coordenadas?
Cualquiera de los dos funciona. El nombre de la ciudad es conveniente para las entradas de cara al usuario. Las coordenadas son más precisas y evitan la ambigüedad cuando varias ciudades comparten el mismo nombre (por ejemplo, "Springfield" existe en más de 30 estados de EE. UU.).
¿Qué unidad de temperatura se devuelve?
Las temperaturas se devuelven en grados Celsius de forma predeterminada. El campo de unidad en la respuesta lo confirma. Convierta a Fahrenheit del lado del cliente con la fórmula F = C * 9/5 + 32.
¿Con qué frecuencia se actualizan los datos meteorológicos?
Los datos meteorológicos se actualizan cada 15 minutos desde fuentes ascendentes. Para la mayoría de las aplicaciones, almacenar en caché las respuestas durante 10 a 15 minutos por su parte es seguro y reduce las llamadas a la API.
¿Qué representa el campo Weather_code?
El código meteorológico es un código numérico de interpretación meteorológica de la OMM. Valores comunes: 0 = cielo despejado, 1-3 = parcialmente nublado, 45/48 = niebla, 51-67 = llovizna/lluvia, 71-77 = nieve, 80-82 = chubascos, 95+ = tormenta eléctrica. El campo de descripción proporciona la etiqueta legible por humanos.
¿Qué pasa si no se proporcionan ni la ciudad ni las coordenadas?
El punto final devuelve un error pidiéndole que proporcione el nombre de una ciudad o un par de latitud/longitud. Se requiere al menos un parámetro de ubicación.

Get your API key

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