Aller au contenu
POST AI agent ready /v1/weather/current

API Météo - Conditions actuelles par ville ou coordonnées

Renvoie les données météorologiques actuelles pour un emplacement spécifié par le nom de la ville ou la latitude/longitude. La réponse comprend la température (avec sensation), l'humidité, les précipitations, la vitesse et la direction du vent, la couverture nuageuse, un code météo numérique et une description lisible par l'homme.

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

Contenu dynamique basé sur la météo locale

Personnalisez les bannières de la page d'accueil ou les recommandations de produits en fonction de la météo locale du visiteur. Un site de vente au détail peut promouvoir des parapluies lorsqu'il pleut ou de la crème solaire par temps clair, augmentant ainsi les taux de conversion avec une pertinence contextuelle.

Planification de la logistique et des itinéraires de livraison

Vérifiez les conditions météorologiques le long des itinéraires de livraison avant d’envoyer des chauffeurs. Signalez les itinéraires soumis à des vents violents ou à de fortes précipitations afin que les répartiteurs puissent réacheminer ou retarder les expéditions afin de protéger les marchandises et la sécurité des conducteurs.

IoT et domotique intelligente

Interrogez les données météorologiques actuelles pour déclencher des actions de maison intelligente. Fermez les stores motorisés lorsque la couverture nuageuse descend en dessous de 20 %, activez les arroseurs uniquement lorsque les précipitations sont nulles ou ajustez les points de consigne du thermostat en fonction de la température ressentie.

Frequently asked questions

Dois-je utiliser le nom ou les coordonnées de la ville ?
L’un ou l’autre fonctionne. Le nom de la ville est pratique pour les entrées destinées aux utilisateurs. Les coordonnées sont plus précises et évitent toute ambiguïté lorsque plusieurs villes partagent le même nom (par exemple, « Springfield » existe dans plus de 30 États américains).
Quelle unité de température est renvoyée ?
Les températures sont renvoyées en Celsius par défaut. Le champ unité dans la réponse le confirme. Convertissez en Fahrenheit côté client avec la formule F = C * 9/5 + 32.
À quelle fréquence les données météorologiques sont-elles mises à jour ?
Les données météorologiques sont actualisées toutes les 15 minutes à partir de sources en amont. Pour la plupart des applications, la mise en cache des réponses pendant 10 à 15 minutes de votre côté est sûre et réduit les appels d'API.
Que représente le champ Weather_code ?
Le Weather_code est un code numérique d'interprétation météorologique de l'OMM. Valeurs courantes : 0 = ciel clair, 1-3 = partiellement nuageux, 45/48 = brouillard, 51-67 = bruine/pluie, 71-77 = neige, 80-82 = averses de pluie, 95+ = orage. Le champ de description fournit l’étiquette lisible par l’homme.
Que se passe-t-il si ni la ville ni les coordonnées ne sont fournies ?
Le point de terminaison renvoie une erreur vous demandant de fournir soit un nom de ville, soit une paire latitude/longitude. Au moins un paramètre d'emplacement est requis.

Get your API key

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

Sign up free View full docs