POST AI agent ready /v1/weather/current

Wetter-API – Aktuelle Bedingungen nach Stadt oder Koordinaten

Gibt aktuelle Wetterdaten für einen durch Stadtnamen oder Breiten-/Längengrad angegebenen Standort zurück. Die Antwort umfasst Temperatur (mit Gefühlen), Luftfeuchtigkeit, Niederschlag, Windgeschwindigkeit und -richtung, Wolkendecke, einen numerischen Wettercode und eine für Menschen lesbare Beschreibung.

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

Dynamische Inhalte basierend auf dem lokalen Wetter

Personalisieren Sie Homepage-Banner oder Produktempfehlungen basierend auf dem lokalen Wetter des Besuchers. Eine Einzelhandelsseite kann bei Regen für Regenschirme oder bei klarem Himmel für Sonnenschutzmittel werben und so die Konversionsraten mit kontextbezogener Relevanz erhöhen.

Logistik- und Lieferroutenplanung

Überprüfen Sie die Wetterbedingungen entlang der Lieferrouten, bevor Sie Fahrer entsenden. Kennzeichnen Sie Routen mit starkem Wind oder starkem Niederschlag, damit Disponenten Sendungen umleiten oder verzögern können, um die Sicherheit von Waren und Fahrern zu schützen.

IoT und Smart-Home-Automatisierung

Fragen Sie aktuelle Wetterdaten ab, um Smart-Home-Aktionen auszulösen. Schließen Sie motorisierte Jalousien, wenn die Bewölkung unter 20 % sinkt, aktivieren Sie Sprinkler nur, wenn es keinen Niederschlag gibt, oder passen Sie die Thermostat-Sollwerte an die gefühlte Temperatur an.

Frequently asked questions

Soll ich den Namen oder die Koordinaten der Stadt verwenden?

Beides funktioniert. Der Stadtname ist praktisch für benutzerseitige Eingaben. Koordinaten sind präziser und vermeiden Mehrdeutigkeiten, wenn mehrere Städte denselben Namen haben (z. B. „Springfield“ existiert in über 30 US-Bundesstaaten).

Welche Temperatureinheit wird zurückgegeben?

Temperaturen werden standardmäßig in Celsius zurückgegeben. Das Einheitenfeld in der Antwort bestätigt dies. Konvertieren Sie clientseitig in Fahrenheit mit der Formel F = C * 9/5 + 32.

Wie oft werden die Wetterdaten aktualisiert?

Wetterdaten werden alle 15 Minuten von vorgelagerten Quellen aktualisiert. Bei den meisten Anwendungen ist das Zwischenspeichern von Antworten für 10–15 Minuten auf Ihrer Seite sicher und reduziert API-Aufrufe.

Was stellt das Feld „Weather_Code“ dar?

Der Weather_code ist ein numerischer WMO-Wetterinterpretationscode. Übliche Werte: 0 = klarer Himmel, 1-3 = teilweise bewölkt, 45/48 = Nebel, 51-67 = Nieselregen/Regen, 71-77 = Schnee, 80-82 = Regenschauer, 95+ = Gewitter. Das Beschreibungsfeld stellt die für Menschen lesbare Beschriftung bereit.

Was passiert, wenn weder Stadt noch Koordinaten angegeben werden?

Der Endpunkt gibt einen Fehler zurück und fordert Sie auf, entweder einen Stadtnamen oder ein Lat/Lng-Paar anzugeben. Mindestens ein Standortparameter ist erforderlich.

Get your API key

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