WeatherService API-Dokumentation (v2)

Diese Dokumentation beschreibt die WeatherService API, Version v2, die Wettervorhersagen bereitstellt.

Allgemeine Informationen

Die WeatherService API ermöglicht den Abruf von Wetterinformationen, einschließlich aktueller Bedingungen sowie minütlicher, stündlicher und täglicher Vorhersagen. Der Zugriff auf die API erfolgt über HTTP-Endpunkte, die Daten im JSON-Format zurückgeben.

Endpunkte

/api/v2/weather/point

Dieser Endpunkt ruft Wetterdaten für einen bestimmten Punkt ab, der durch Breiten- und Längengrad definiert wird.

HTTP-Methode: GET

Parameter

Parameter	Erforderlich	Typ	Format	Beschreibung
`apiKey`	Yes	string		API-Key zur Authentifizierung
`latitude`	Yes	number	double	Breitengrad des Punkts
`longitude`	Yes	number	double	Längengrad des Punkts
`channel`	No	string		Kanal für die Anfrage
`dateTimeFrom`	No	string	date-time	Start-Datum und -Uhrzeit für die Wetterdaten
`dateTimeUntil`	No	string	date-time	End-Datum und -Uhrzeit für die Wetterdaten
`details`	No	string		Ermöglicht das Anfordern zusätzlicher Wetterinformationen mithilfe vordefinierter ENUM-Werte. Standardmäßig werden nur aktuelle Wetterinformationen bereitgestellt. Mögliche Werte: ADDRESS (Reverse-Geocoding für die angegebenen Koordinaten), MINUTELY_15 (Daten im 15-Minuten-Intervall), HOURLY (Daten im 60-Minuten-Intervall), DAILY (Tagesdaten). Es können mehrere Werte angefordert werden.

Datenmodelle

Address

Definiert eine Adresse.

Property	Type	Nullable	Beschreibung
`country`	string	Yes	Land der Adresse
`district`	string	Yes	Bezirk der Adresse
`zip`	string	Yes	Postleitzahl der Adresse
`city`	string	Yes	Stadt der Adresse
`cityAddOn`	string	Yes	Zusätzliche Stadtinformationen
`cityPart`	string	Yes	Stadtteil der Adresse
`street`	string	Yes	Straße der Adresse
`houseNo`	string	Yes	Hausnummer der Adresse

ProblemDetails

Enthält Details zu einem Fehler.

Property	Type	Nullable	Beschreibung
`type`	string	Yes	Eine URI-Referenz, die den Problemtyp identifiziert
`title`	string	Yes	Eine kurze, für Menschen lesbare Zusammenfassung des Problems
`status`	integer	Yes	Der HTTP-Statuscode für dieses Auftreten des Problems
`detail`	string	Yes	Eine für Menschen lesbare Erläuterung zu diesem spezifischen Auftreten des Problems
`instance`	string	Yes	Eine URI-Referenz, die das konkrete Auftreten des Problems identifiziert

ServiceError

Beschreibt einen Service-Fehler.

Property	Type	Nullable	Beschreibung
`type`	string	Yes	Typ des Fehlers
`message`	string	Yes	Fehlermeldung

WeatherForecastCurrently

Enthält die aktuellen Wetterbedingungen.

Property	Type	Format	Nullable	Beschreibung	Unit
`timestamp`	string	date-time	No	Zeitstempel der Wetterdaten
`interval`	number	float	Yes	Intervall
`temperature2Meters`	number	float	Yes	Temperatur in 2 Metern Höhe	°C
`relativeHumidity2Meters`	number	float	Yes	Relative Luftfeuchtigkeit in 2 Metern Höhe	%
`apparentTemperature`	number	float	Yes	Gefühlte Temperatur	°C
`isDay`	boolean		Yes	Gibt an, ob es Tag ist
`precipitation`	number	float	Yes	Niederschlagsmenge	mm
`rain`	number	float	Yes	Regenmenge	mm
`showers`	number	float	Yes	Schauermenge	mm
`snowfall`	number	float	Yes	Schneefallmenge	cm
`weatherCode`	integer	int32	Yes	Wettercode
`cloudCover`	number	float	Yes	Bewölkungsgrad in Prozent	%
`pressureMsl`	number	float	Yes	Luftdruck auf Meereshöhe	hPa
`surfacePressure`	number	float	Yes	Bodendruck	hPa
`precipitationProbability`	number	float	Yes	Niederschlagswahrscheinlichkeit	%
`dewPoint2Meters`	number	float	Yes	Taupunkttemperatur in 2 Metern Höhe	°C
`visibility`	number	float	Yes	Sichtweite	km
`sunshineDuration`	number	float	Yes	Sonnenscheindauer in Sekunden	s
`windSpeed10Meters`	number	float	Yes	Windgeschwindigkeit in 10 Metern Höhe	km/h
`windDirection10Meters`	number	float	Yes	Windrichtung in 10 Metern Höhe	°
`windGusts10Meters`	number	float	Yes	Windböen in 10 Metern Höhe	km/h

WeatherForecastDaily

Liefert tägliche Wettervorhersagedaten.

Property	Type	Format	Nullable	Beschreibung	Unit
`timestamp`	string	date-time	No	Zeitstempel der Vorhersage
`sunrise`	string	date-time	Yes	Uhrzeit des Sonnenaufgangs
`sunset`	string	date-time	Yes	Uhrzeit des Sonnenuntergangs
`temperature2MetersMin`	number	float	Yes	Minimale Temperatur in 2 Metern Höhe	°C
`temperature2MetersMax`	number	float	Yes	Maximale Temperatur in 2 Metern Höhe	°C
`apparentTemperatureMin`	number	float	Yes	Minimale gefühlte Temperatur	°C
`apparentTemperatureMax`	number	float	Yes	Maximale gefühlte Temperatur	°C
`precipitationSum`	number	float	Yes	Gesamtniederschlagsmenge	mm
`precipitationHours`	number	float	Yes	Anzahl der Stunden mit Niederschlag	hours
`precipitationProbabilityMax`	number	float	Yes	Maximale Niederschlagswahrscheinlichkeit	%
`rainSum`	number	float	Yes	Gesamtregenmenge	mm
`showersSum`	number	float	Yes	Gesamtschauermenge	mm
`snowfallSum`	number	float	Yes	Gesamtschneefallmenge	cm
`weatherCode`	integer	int32	Yes	Wettercode
`windSpeed10MetersMax`	number	float	Yes	Maximale Windgeschwindigkeit in 10 Metern Höhe	km/h
`windGusts10MetersMax`	number	float	Yes	Maximale Windböen in 10 Metern Höhe	km/h
`windDirection10MetersDominant`	number	float	Yes	Vorherrschende Windrichtung in 10 Metern Höhe	°
`sunshineDuration`	number	float	Yes	Sonnenscheindauer in Sekunden	s
`daylightDuration`	number	float	Yes	Tageslichtdauer in Sekunden	s
`uvIndexMax`	number	float	Yes	Maximaler UV-Index
`uvIndexClearSkyMax`	number	float	Yes	Maximaler UV-Index bei klarem Himmel
`et0FaoEvapotranspiration`	number	float	Yes	ET0-FAO-Evapotranspiration	mm
`shortwaveRadiationSum`	number	float	Yes	Summe der kurzwelligen Strahlung	MJ/m²

WeatherForecastHourly

Enthält stündliche Wettervorhersagedetails.

Property	Type	Format	Nullable	Beschreibung	Unit
`timestamp`	string	date-time	No	Zeitstempel der Vorhersage
`temperature2Meters`	number	float	Yes	Temperatur in 2 Metern Höhe	°C
`temperature80Meters`	number	float	Yes	Temperatur in 80 Metern Höhe	°C
`temperature120Meters`	number	float	Yes	Temperatur in 120 Metern Höhe	°C
`temperature180Meters`	number	float	Yes	Temperatur in 180 Metern Höhe	°C
`relativeHumidity2Meters`	number	float	Yes	Relative Luftfeuchtigkeit in 2 Metern Höhe	%
`dewPoint2Meters`	number	float	Yes	Taupunkttemperatur in 2 Metern Höhe	°C
`apparentTemperature`	number	float	Yes	Gefühlte Temperatur	°C
`precipitation`	number	float	Yes	Niederschlagsmenge	mm
`precipitationProbability`	number	float	Yes	Niederschlagswahrscheinlichkeit	%
`rain`	number	float	Yes	Regenmenge	mm
`showers`	number	float	Yes	Schauermenge	mm
`snowfall`	number	float	Yes	Schneefallmenge	cm
`snowDepth`	number	float	Yes	Schneehöhe	cm
`weatherCode`	integer	int32	Yes	Wettercode
`visibility`	number	float	Yes	Sichtweite	km
`windSpeed10Meters`	number	float	Yes	Windgeschwindigkeit in 10 Metern Höhe	km/h
`windSpeed80Meters`	number	float	Yes	Windgeschwindigkeit in 80 Metern Höhe	km/h
`windSpeed120Meters`	number	float	Yes	Windgeschwindigkeit in 120 Metern Höhe	km/h
`windSpeed180Meters`	number	float	Yes	Windgeschwindigkeit in 180 Metern Höhe	km/h
`windDirection10Meters`	number	float	Yes	Windrichtung in 10 Metern Höhe	°
`windDirection80Meters`	number	float	Yes	Windrichtung in 80 Metern Höhe	°
`windGusts10Meters`	number	float	Yes	Windböen in 10 Metern Höhe	km/h
`windDirection120Meters`	number	float	Yes	Windrichtung in 120 Metern Höhe	°
`windDirection180Meters`	number	float	Yes	Windrichtung in 180 Metern Höhe	°
`isDay`	number	float	Yes	Gibt an, ob es Tag ist
`sunshineDuration`	number	float	Yes	Sonnenscheindauer in Sekunden	s
`cloudCover`	number	float	Yes	Bewölkungsgrad in Prozent	%
`cloudCoverLow`	number	float	Yes	Bewölkungsgrad in niedriger Höhe in Prozent	%
`cloudCoverMid`	number	float	Yes	Bewölkungsgrad in mittlerer Höhe in Prozent	%
`cloudCoverHigh`	number	float	Yes	Bewölkungsgrad in großer Höhe in Prozent	%
`pressureMsl`	number	float	Yes	Luftdruck auf Meereshöhe	hPa
`surfacePressure`	number	float	Yes	Bodendruck	hPa
`soilTemperature0Centimeters`	number	float	Yes	Bodentemperatur bei 0 Zentimetern	°C
`soilTemperature6Centimeters`	number	float	Yes	Bodentemperatur bei 6 Zentimetern	°C
`soilTemperature18Centimeters`	number	float	Yes	Bodentemperatur bei 18 Zentimetern	°C
`soilTemperature54Centimeters`	number	float	Yes	Bodentemperatur bei 54 Zentimetern	°C
`soilMoisture0CentimetersTo1Centimeters`	number	float	Yes	Bodenfeuchte 0-1 cm	m³/m³
`soilMoisture1CentimetersTo3Centimeters`	number	float	Yes	Bodenfeuchte 1-3 cm	m³/m³
`soilMoisture3CentimetersTo9Centimeters`	number	float	Yes	Bodenfeuchte 3-9 cm	m³/m³
`soilMoisture9CentimetersTo27Centimeters`	number	float	Yes	Bodenfeuchte 9-27 cm	m³/m³
`soilMoisture27CentimetersTo81Centimeters`	number	float	Yes	Bodenfeuchte 27-81 cm	m³/m³
`evapotranspiration`	number	float	Yes	Evapotranspiration	mm
`vapourPressureDeficit`	number	float	Yes	Dampfdruckdefizit	kPa
`et0FaoEvapotranspiration`	number	float	Yes	ET0-FAO-Evapotranspiration	mm

WeatherForecastMinutely15

Liefert Wetterdaten in 15-Minuten-Intervallen.

Property	Type	Format	Nullable	Beschreibung	Unit
`timestamp`	string	date-time	No	Zeitstempel der Vorhersage
`temperature2Meters`	number	float	Yes	Temperatur in 2 Metern Höhe	°C
`relativeHumidity2Meters`	number	float	Yes	Relative Luftfeuchtigkeit in 2 Metern Höhe	%
`dewPoint2Meters`	number	float	Yes	Taupunkttemperatur in 2 Metern Höhe	°C
`apparentTemperature`	number	float	Yes	Gefühlte Temperatur	°C
`precipitation`	number	float	Yes	Niederschlagsmenge	mm
`rain`	number	float	Yes	Regenmenge	mm
`showers`	number	float	Yes	Schauermenge	mm
`snowfall`	number	float	Yes	Schneefallmenge	cm
`snowfallHeight`	number	float	Yes	Schneefallgrenze	m
`freezingLevelHeight`	number	float	Yes	Höhe der Frostgrenze	m
`sunshineDuration`	number	float	Yes	Sonnenscheindauer in Sekunden	s
`weatherCode`	integer	int32	Yes	Wettercode
`cloudCover`	number	float	Yes	Bewölkungsgrad in Prozent	%
`pressureMsl`	number	float	Yes	Luftdruck auf Meereshöhe	hPa
`precipitationProbability`	number	float	Yes	Niederschlagswahrscheinlichkeit	%
`surfacePressure`	number	float	Yes	Bodendruck	hPa
`windSpeed10Meters`	number	float	Yes	Windgeschwindigkeit in 10 Metern Höhe	km/h
`windSpeed80Meters`	number	float	Yes	Windgeschwindigkeit in 80 Metern Höhe	km/h
`windDirection10Meters`	number	float	Yes	Windrichtung in 10 Metern Höhe	°
`windDirection80Meters`	number	float	Yes	Windrichtung in 80 Metern Höhe	°
`windGusts10Meters`	number	float	Yes	Windböen in 10 Metern Höhe	km/h
`visibility`	number	float	Yes	Sichtweite	km
`lightningPotential`	number	float	Yes	Blitzpotenzial
`cape`	number	float	Yes	CAPE (Convective Available Potential Energy)	J/kg
`isDay`	boolean		Yes	Gibt an, ob es Tag ist
`shortwaveRadiation`	number	float	Yes	Kurzwellenstrahlung	W/m²
`shortwaveRadiationInstant`	number	float	Yes	Momentane Kurzwellenstrahlung	W/m²
`diffuseRadiation`	number	float	Yes	Diffusstrahlung	W/m²
`diffuseRadiationInstant`	number	float	Yes	Momentane Diffusstrahlung	W/m²
`directRadiation`	number	float	Yes	Direktstrahlung	W/m²
`directRadiationInstant`	number	float	Yes	Momentane Direktstrahlung	W/m²
`terrestrialRadiation`	number	float	Yes	Terrestrische Strahlung	W/m²
`terrestrialRadiationInstant`	number	float	Yes	Momentane terrestrische Strahlung	W/m²
`directNormalIrradiance`	number	float	Yes	Direkte Normalstrahlung	W/m²
`directNormalIrradianceInstant`	number	float	Yes	Momentane direkte Normalstrahlung	W/m²
`globalTiltedIrradiance`	number	float	Yes	Globale geneigte Strahlung	W/m²
`globalTiltedIrradianceInstant`	number	float	Yes	Momentane globale geneigte Strahlung	W/m²

WeatherForecastResponse

Das Hauptantwortobjekt mit Copyright-Informationen, Zeitzone, aktuellem Wetter und Vorhersagen.

Property	Type	Nullable	Beschreibung
`copyright`	string	Yes	Copyright-Informationen
`timezone`	string	Yes	Zeitzone
`currently`	WeatherForecastCurrently	No	Aktuelle Wetterbedingungen
`minutely15`	array of WeatherForecastMinutely15	Yes	Array von minütlichen (15-Minuten) Vorhersagen
`hourly`	array of WeatherForecastHourly	Yes	Array von stündlichen Vorhersagen
`daily`	array of WeatherForecastDaily	Yes	Array von täglichen Vorhersagen
`address`	Address	No	Adressinformationen
`errors`	array of ServiceError	Yes	Array von Service-Fehlern

Antworten

HTTP Code	Beschreibung	Content Type	Schema
`200`	Erfolgreich	`application/json`	WeatherForecastResponse
`400`	Bad Request	`application/json`	ProblemDetails
`401`	Unauthorized	`application/json`	ProblemDetails
`500`	Serverfehler	`application/json`	ProblemDetails

Weitere Details zu den Datenmodellen und deren Eigenschaften finden Sie in der Swagger-Dokumentation.

Sie können die OpenAPI-Definition (https://weather.smartmaps.cloud/swagger/v2/swagger.json) auch direkt in Postman, Insomnia oder ähnliche API-Clients importieren.