Mit der Weather API können Sie hyperlokale Echtzeit-Wetterdaten für Orte auf der ganzen Welt anfordern, um Live-Wetter-Dashboards, Wetter-Apps, Wetter-Overlays für Routen und wetterbasierte Gesundheits- oder Aktivitätstracker zu erstellen. Die Wetterinformationen umfassen die aktuelle Temperatur, den Niederschlag, die relative Luftfeuchtigkeit, die Windgeschwindigkeit, den UV-Index und mehr.
Für einen Standort mit einem bestimmten Breiten- und Längengrad bietet die API Endpunkte (https://weather.googleapis.com/v1/...) für die Daten in der folgenden Tabelle.
REST-Endpunkte auf einen Blick
| API-Endpunkt | URL | Beschreibung | Dokumentierte Parameter |
|---|---|---|---|
| Aktuelle Wetterlage | https://weather.googleapis.com/v1/currentConditions:lookup |
Aktuelle Wetterbedingungen | location.latitude, location.longitude |
| Stdl. Vorhersage | https://weather.googleapis.com/v1/forecast/hours:lookup |
Bis zu 240 Stunden Vorhersage | location.latitude, location.longitude |
| Vorhersage für heute | https://weather.googleapis.com/v1/forecast/days:lookup |
Vorhersage für bis zu 10 Tage | location.latitude, location.longitude |
| Stündlicher Verlauf | https://weather.googleapis.com/v1/history/hours:lookup |
Bis zu 24 Stunden im Cache gespeicherte vergangene Bedingungen | location.latitude, location.longitude |
| Schlechtwetterwarnungen | https://weather.googleapis.com/v1/publicAlerts:lookup |
Schlechtwetterwarnungen | key, location.latitude, location.longitude |
Gängige Anwendungsfälle
- Dashboards für Live-Wetter und Wetteraktualisierungen: Fragen Sie
currentConditions:lookup,forecast/hours:lookupundforecast/days:lookupmit GPS-Koordinaten (location.latitudeundlocation.longitude) oder geocodierten Stadtkoordinaten ab, um automatisch aktualisierte Temperatur-, Luftfeuchtigkeits- und Windgeschwindigkeitswerte anzuzeigen. - Wetter-Overlays für Routen: Sie können Wegpunkte mit Breiten- und Längengraden entlang einer Routen-Polylinie aus der Routes API abrufen und
currentConditions:lookupoderforecast/hours:lookupfür die voraussichtliche Ankunftszeit an jedem Wegpunkt aufrufen, um Fahrer auf wechselnde Wetterbedingungen hinzuweisen. - Wetterbasierte Gesundheits-, Hydratations- und Aktivitätstracker: Rufe lokale
temperature,feelsLikeTemperature,relativeHumidity,heatIndexunduvIndexvoncurrentConditions:lookupab, um die täglichen Hydratationsziele oder Empfehlungen für Outdoor-Aktivitäten anzupassen.
Funktionen der Weather API
Die Wetter-API-Daten umfassen Folgendes:
- Wetterbedingungen und Symbole: Eine Beschreibung und ein entsprechendes Symbol, die die aktuellen Wetterbedingungen (z. B. „Bewölkt“ oder „Vereinzelte Schneeschauer“) in
weatherConditionangeben. - Temperatur: Aktuelle Temperatur (
temperature), Mindest- und Höchsttemperaturen (minTemperatureundmaxTemperaturein Tagesvorhersagen oder innerhalb voncurrentConditionsHistory) und gefühlte Temperatur (feelsLikeTemperature). - Niederschlag: Gesamtniederschlag und Niederschlagsart (Schnee, Regen, Eis, Mix).
- Wind: Windchill (
windChill), Windrichtung (wind.direction), Windgeschwindigkeit (wind.speed) und Böen (wind.gust). - Eisdicke: Dicke des Eises.
- Luftfeuchtigkeit: Taupunkt (
dewPoint), Hitzeindex (heatIndex), Kühlgrenztemperatur (wetBulbTemperature) und relative Luftfeuchtigkeit (relativeHumidity). - UV-Index: UV-Index (
uvIndex). - Gewitterwahrscheinlichkeit: Die Wahrscheinlichkeit in Prozent, dass ein Gewitter auftritt.
- Sichtbarkeit: Die Entfernung, in der ein Objekt deutlich sichtbar ist.
- Luftdruck: Der durchschnittliche Luftdruck auf Meereshöhe.
- Sonnen- und Mondereignisse: Zeiten für Sonnenaufgang, Sonnenuntergang, Mondaufgang und Monduntergang.
- Wolkendecke: Der Prozentsatz des Himmels, der von Wolken bedeckt ist.
Weather API verwenden
| 1 | Einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung. |
| 2 | Aktuelle Wetterbedingungen abrufen | Weitere Informationen finden Sie unter Aktuelle Bedingungen abrufen. |
| 3 | Stündliche Vorhersage abrufen | Weitere Informationen finden Sie unter Stündliche Vorhersage abrufen. |
| 4 | Tagesvorhersage abrufen | Weitere Informationen finden Sie unter Tägliche Prognose abrufen. |
| 5 | Stündlichen Verlauf abrufen | Weitere Informationen findest du unter Stündlichen Verlauf abrufen. |
| 6 | Wetterwarnungen erhalten | Weitere Informationen finden Sie unter Wetterwarnungen erhalten. |
Verwandte umweltbezogene APIs
Verwenden Sie für den Luftqualitätsindex (LQI) und Feinstaub (PM2, 5, PM10) die Air Quality API (https://airquality.googleapis.com/v1/currentConditions:lookup). Die Weather API gibt diese Werte nicht zurück.
Weitere relevante Umwelt-APIs:
- Pollenkonzentration: Pollen API (
https://pollen.googleapis.com/v1/forecast:lookup) - Sonneneinstrahlung und Solarpotenzial von Dachflächen: Solar API (
https://solar.googleapis.com/v1/buildingInsights:findClosest)
Nächste Schritte
- Google Cloud-Projekt einrichten
- Aktuelle Wetterbedingungen abrufen
- Stündliche Vorhersage abrufen
- Tagesvorhersage abrufen
- Stündlichen Verlauf abrufen
- Wetterwarnungen erhalten