Die Timeline Weather API ist der einfachste und leistungsfähigste Weg, um Wetterdaten abzurufen. Sie können Daten über jedes beliebige Zeitfenster abrufen, einschließlich Fenstern, die die Vergangenheit, die Gegenwart und die Zukunft umfassen. Die API kümmert sich um die Kombination von historischen Beobachtungen, aktuellen 15-Tage-Vorhersagen und statistischen Wettervorhersagen, um einen einzigen, konsolidierten Datensatz über einen einzigen API-Aufruf zu erstellen.
Suchen Sie die Endpunkt-Dokumente für /forecast und /history?
Unsere bestehenden Wetter-API-Endpunkte für /forecast- und /history-Abfragen werden weiterhin vollständig unterstützt. Die Dokumentation für diese Endpunkte finden Sie hier.
Die Timeline API bietet eine vollständige, globale Wetterdatenabdeckung, sowohl geografisch als auch chronologisch. Sie wählt immer die besten verfügbaren Datenquellen aus, um jede Wetter-API-Anfrage zu beantworten. Diese Quellen umfassen:
- Aktuelle Wetterbedingungen
- Tägliche historische, prognostizierte und statistische Prognosedaten (je nach gewünschten Daten)
- Stündliche historische Beobachtungen und 15-Tage-Vorhersage
- Wetterwarnungen
- Astronomische Beobachtungen, einschließlich Sonnenaufgang, Sonnenuntergang und Mondphasen.
Die Ergebnisdaten werden in einem gängigen JSON-Format bereitgestellt, so dass Sie komplexe zugrunde liegende Datenquellen ignorieren und sich ganz auf Ihren Anwendungsfall der Wetterdaten konzentrieren können. Sie können das Ergebnis auch im CSV-Textformat anfordern, wenn Sie dies bevorzugen.
Timeline Weather API Query Builder
Die Seite der Wetterdatendienste enthält einen vollständigen, interaktiven Abfragegenerator, mit dem Sie Abfragen erstellen und die Ergebnisse direkt in Ihrem Browser sehen können.
API-Anfrage-Typen
Alle Anfragen an die Timeline Weather API verwenden das folgende Formular:
https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/[location]/[date1]/[date2]?key=YOUR_API_KEY
Ort (erforderlich) – ist die Adresse, Teiladresse oder der Breiten- und Längengrad des Ortes, für den die Wetterdaten abgerufen werden sollen. Sie können auch US ZIP Codes verwenden. Wenn Sie mehrere Orte in der gleichen Anfrage übermitteln möchten, sollten Sie unsere Wetter-API für mehrere Orte in Betracht ziehen.
date1 (optional) – ist das Startdatum, für das Wetterdaten abgerufen werden sollen. Wenn auch ein Wert für date2 angegeben wird, stellt dieser das erste Datum dar, für das Wetterdaten abgerufen werden. Wenn kein date2 angegeben wird, werden die Wetterdaten für einen einzelnen Tag abgerufen, und dieses Datum wird in date1 angegeben. Alle Daten und Zeiten sind in der Ortszeit des angegebenen Ortes angegeben. Die Daten sollten im Format jjjj-MM-tt angegeben werden. Zum Beispiel 2020-10-19 für den 19. Oktober 2020 oder 2017-02-03 für den 3. Februar 2017.
Anstelle eines genauen Datums können Sie auch einen dynamischen Datumszeitraum angeben. Siehe unten für weitere Details. Sie können das Datum auch in “UNIX-Zeit” angeben. In diesem Fall geben Sie die Anzahl der Sekunden seit dem 1. Januar 1970 UTC an. Zum Beispiel 1612137600 für Mitternacht am 1. Februar 2021.
Sie können auch die Informationen für eine bestimmte Zeit für ein einzelnes Datum abfragen, indem Sie die Zeit in das Feld date1 im Format yyyy-MM-ddTHH:mm:ss eingeben. Zum Beispiel 2020-10-19T13:00:00.
Die Ergebnisse werden im Feld ‘currentConditions’ zurückgegeben und auf die angeforderte Stunde abgeschnitten (d.h. 2020-10-19T13:59:00 wird Daten zum Zeitpunkt 2020-10-19T13:00:00 zurückgeben).
date2 (optional) – ist das Enddatum, für das Wetterdaten abgerufen werden sollen. Dieser Wert darf nur verwendet werden, wenn ein Wert für date1 angegeben wird. Wenn sowohl date1 als auch date2 angegeben werden, schließt die Abfrage date2 ein und der Zeitraum der Wetterdatenabfrage endet um Mitternacht des date2-Wertes. Alle Datums- und Zeitangaben sind in der Ortszeit des angegebenen Ortes und sollten im Format jjjj-MM-tt angegeben werden.
Wenn kein Datum1 oder Datum2 angegeben wird, ruft die Anfrage die Vorhersage für den gewünschten Ort für die nächsten 15 Tage ab.
Beispiel für eine Prognoseanfrage
Im Folgenden finden Sie die Wettervorhersage für London, Vereinigtes Königreich für die nächsten 15 Tage, beginnend um Mitternacht zu Beginn des aktuellen Tages (Ortszeit des angefragten Ortes).
https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/London,UK?key=YOUR_API_KEY
Beispiel für eine Vorhersageanfrage unter Verwendung von Längen- und Breitengraden
Sie können den Ort auch als “Breitengrad, Längengrad”-Wert übergeben. Zum Beispiel: 38.9697,-77.385
https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/38.9697,-77.385?key=YOUR_API_KEY
Beispiel einer Datumsbereichsabfrage
Im Folgenden werden die Wetterdaten für London, Großbritannien vom 1. Oktober 2020 bis zum 31. Dezember 2020 (einschließlich) abgerufen.
https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/London,UK/2020-10-01/2020-12-31?key=YOUR_API_KEY
Angenommen, das aktuelle Datum ist der 1. November 2020, dann enthält das Ergebnis historische Beobachtungen vom 1. bis 31. Oktober, dann 15 Tage Wettervorhersage und schließlich die verbleibenden Tage die statistische Vorhersage auf der Grundlage der Verarbeitung von Jahren historischer Beobachtungen.
Beispiel einer Datumsbereichsabfrage mit UNIX-Zeit (Epochenzeit)
Nachfolgend sehen Sie dieselbe Abfrage im UNIX-Format der Sekunden seit der UNIX-Zeitepoche 1970. Beachten Sie, dass es sich bei diesen Zeiten um Sekunden in der Zeitzone UTC (GMT/Z) handelt.
https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/London,UK/1601510400/1609372800?key=YOUR_API_KEY
Beispiel für eine spezifische Zeitanfrage
Im Folgenden werden die Wetterdaten für London, Großbritannien für den 15. Dezember 2020 abgerufen und die aktuellen Bedingungen mit den Bedingungen um 13:00 Uhr Ortszeit (13 Uhr Ortszeit) abgefragt.
https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/London,UK/2020-12-15T13:00:00?key=YOUR_API_KEY
Das obige Beispiel enthält die täglichen und stündlichen Details für den Tag der aktuellen Bedingungen (in diesem Fall 2020-12-15). Die Kosten für diese Abfrage betragen daher 24. Wenn Sie nur die spezifischen Zeitdaten und nicht die stündlichen Details benötigen, können Sie die Kosten der Abfrage mit dem Parameter include reduzieren:
https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/London,UK/2020-12-15T13:00:00?key=YOUR_API_KEY&include=current
Diese Abfrage kostet eine.
Beispiel für eine dynamische Periodenabfrage
Anstelle der Angabe eines Datumsbereichs können Sie auch einen dynamischen Zeitraum angeben. Eine Abfrage, die auf einem dynamischen Zeitraum basiert, wird automatisch an den Zeitraum angepasst. In diesem Beispiel verwenden wir den Wert “last30days” für den dynamischen Zeitraum, um Daten für die letzten 30 Tage abzurufen.
https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/London,UK/last30days?key=YOUR_API_KEY
Andere dynamische Periodenwerte sind “heute”, “gestern” und “letztes Jahr”. Eine vollständige Liste der Optionen und weitere Beispiele finden Sie im Artikel Dynamischer Zeitraum.
Mit der Elementeliste und dem Parameter options können Sie nur täglich eine begrenzte Anzahl von Elementen anfordern.
Standardmäßig sind sowohl tägliche als auch stündliche Daten in der Antwort enthalten, zusammen mit allen Wetterdatenelementen der Antwort (siehe unten). Um die Größe des JSON-Ergebnisses zu reduzieren, um die Abfragekosten zu senken, die Netzwerkübertragung zu reduzieren und die Client-Verarbeitung zu beschleunigen, können Sie die Parameter “options” und “elements” verwenden.
In diesem Beispiel werden nur die täglichen Daten abgefragt:
https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/London,UK/last30days?key=YOUR_API_KEY&include=days
Dieses Beispiel fragt die täglichen Daten nur mit Temperaturelementen ab
https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/London,UK/last30days?key=YOUR_API_KEY&include=days&elements=tempmax,tempmin,temp
Beispiel für eine Liste der Elemente des Gradtags
Im Folgenden finden Sie die täglichen Gradtagszahlen für den gewünschten Ort und den gewünschten Zeitraum (in diesem Fall die letzten 30 Tage).
https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/London,UK/last30days?unitGroup=us&key=YOUR_API_KEY&include=days&elements=datetime,tempmax,tempmin,degreedays,accdegreedays°reeDayTempMaxThreshold=86°reeDayTempBase=50
Weitere Informationen zu unseren Optionen für Wachstums-, Kühl- und Heizgradtage finden Sie auf unserer Gradtags-Seite.
Beispiel für eine historische Prognose
Im Folgenden finden Sie die historische Vorhersage für den 1. Mai 2023 für London, Großbritannien. Die historische Vorhersage verwendet den Parameter ‘forecastBasisDate’, um die API anzuweisen, dass die Daten ab dem Basisdatum die Wettervorhersage verwenden sollen, die an diesem Datum erstellt wurde:
https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/London,UK/2023-05-01/2023-05-15?unitGroup=us&key=YOUR_API_KEY&include=days&forecastBasisDate=2023-05-01
Weitere Informationen finden Sie unter Abfrage von Wettervorhersagen aus der Vergangenheit.
Elemente der Industrie
Die Timeline API kann um erweiterte Elemente für Landwirtschaft, Gartenbau und Energie erweitert werden. Dazu gehören Evapotranspiration, Bodentemperatur und -feuchtigkeit, erweiterte Sonneneinstrahlung sowie Windgeschwindigkeiten und -richtungen in größeren Höhen.
Um diese fortschrittlichen Industrieelemente einzubeziehen, besuchen Sie bitte unsere Seiten Landwirtschaft und Gartenbau sowie Wind- und Solarenergie.
Zusätzliche Anfrageparameter
Die folgenden Parameter werden als HTTP-Abfrageparameter angegeben (sie können auch in einer POST-Abfrage übergeben werden).
key (erforderlich) – Ihr API-Schlüssel. Registrieren Sie sich für ein kostenloses Konto auf unserer Seite Wetterdatenservices.
unitGroup (optional) – Das für die Ausgabedaten verwendete Einheitensystem.
Unterstützte Werte sind us, uk, metric, base. Siehe Einheitengruppen und Maßeinheiten für weitere Informationen. Standardmäßig wird das US-Einheitensystem verwendet.
lang (optional) – Legt die Sprache der übersetzbaren Teile der Ausgabe fest, wie z.B. das Feld Bedingungen. Verfügbare Sprachen sind: ar (Arabisch), bg (Bulgarisch), cs (Tschechisch), da (Dänisch), de (Deutsch), el (Neugriechisch), en (Englisch), es (Spanisch) ), fa (Farsi), fi (Finnisch), fr (Französisch), he (Hebräisch), hu, (Ungarisch), it (Italienisch), ja (Japanisch), ko (Koreanisch), nl (Niederländisch), pl (Polnisch), pt (Portugiesisch), ru (Russisch), sk (Slowakisch), sr (Serbisch), sv (Schwedisch), tr (Türkisch), uk (Ukranisch), vi (Vietnamesisch) und zh (Chinesisch). Wenn Sie zusätzlich ‘id’ eingeben, erhalten Sie die rohen Deskriptor-IDs.
Unter Erstellen oder Ändern von Sprachdateien finden Sie weitere Informationen, wie Sie zusätzliche Sprachen hinzufügen können.
include (optional) – Gibt die Abschnitte an, die Sie in die Ergebnisdaten aufnehmen möchten. So können Sie die Abfragekosten und die Latenzzeit verringern. Geben Sie dies als kommagetrennte Liste an. Zum Beispiel: &include=obs,fcst, um die historischen Beobachtungen und Prognosedaten einzuschließen. Die Optionen sind:
- days – tägliche Daten
- hours– stündliche Daten
- alerts– Wetterwarnungen
- current– aktuelle Bedingungen oder Bedingungen zum gewünschten Zeitpunkt.
- events– historische Ereignisse wie Hagel, Tornados, Windschäden und Erdbeben (standardmäßig nicht aktiviert)
- obs – historische Beobachtungen von Wetterstationen
- remote – historische Beobachtungen aus einer entfernten Quelle wie einem Satelliten oder Radar
- fcst – Vorhersage basierend auf 16-Tage-Modellen.
- stats– historische statistische Normalwerte und tägliche statistische Vorhersage
- statsfcst – verwendet die vollständigen statistischen Prognosedaten für Daten in der Zukunft, die über die aktuelle Modellprognose hinausgehen. Erlaubt stündliche statistische Vorhersagen.
elements (optional) – Gibt die spezifischen Wetterelemente, die Sie in die Antwort aufnehmen möchten, in Form einer durch Kommata getrennten Liste an. Zum Beispiel werden mit &elements=tempmax,tempmin,temp nur die Antwort-Elemente tempmax, tempmin und temp angefordert. Die vollständige Liste der verfügbaren Elemente finden Sie in der Antwort unten.
options (optional) – Gibt zusätzliche Optionen für die Anfragen an, um entweder die Art der Daten oder das Format der Ausgabe anzugeben. Unterstützte Werte sind:
- nonulls – entfernt alle Nullwerte aus der JSON-Antwort
- noheaders – entfernt die Kopfzeile aus der CSV-Antwort
contentType (optional) – gibt das Ausgabeformat für die API an. Standardmäßig wird die Ausgabe in JSON formatiert. Sie können auch contentType=csv festlegen, um CSV-formatierte Daten abzurufen.
Beachten Sie, dass das CSV-Format aufgrund von Formatbeschränkungen nicht die vollständige JSON-Ausgabe unterstützt. Sie müssen den Parameter include verwenden, um anzugeben, welchen Abschnitt Sie abrufen möchten. Die von CSV unterstützten Include-Parameter sind Tage, Stunden, Alarme, Ereignisse und Aktuell.
iconSet (optional) – wird verwendet, um auszuwählen, welche Icon-IDs ausgefüllt werden sollen. Weitere Informationen finden Sie unter Definieren des Parameters iconSet in der Wetter-API.
timezone (optional) – gibt die Zeitzone der Eingabe- und Ergebnisdaten und -zeiten an. Wenn nichts angegeben wird, werden alle Datumszeiten als Ortszeiten betrachtet. Wenn Sie festlegen möchten, dass alle Daten als UTC-Datum und -Zeit eingegeben werden, verwenden Sie den Parameter timezone=Z.
maxDistance (optional) Die maximale Entfernung in Metern, die für die Suche nach lokalen Wetterstationen verwendet wird ( Standardmäßig 50 Meilen oder etwa 80km (80.467m). Diese Einstellung wird mit dem Parameter ‘maxStations’ kombiniert, um lokale Wetterstationen zu finden.
maxStations (optional) Die maximale Anzahl von Wetterstationen, die zur Berechnung eines Wetterdatensatzes verwendet werden (Standardwert 3). Näher gelegene Wetterstationen werden deutlich stärker gewichtet als weiter entfernte Stationen.
elevationDifference (optional) Die maximale Höhendifferenz in Metern zwischen dem angefragten Standort und den Wetterstationen. Jede Wetterstation, die entweder niedriger oder höher liegt als diese Einstellung, wird ausgeschlossen. Die Voreinstellung ist ausgeschaltet.
locationNames (optional) bietet einen alternativen Namen für den angeforderten Ort. Dies wird in der Regel von Benutzern verwendet, die die API-Ergebnisse mit einem Datensatz verknüpfen möchten. Sie können in diesem Parameter zum Beispiel die Datenbank-ID einer Filiale angeben, damit Sie die Wettervorhersage für diese Filiale auffüllen können.
forecastBasisDate (optional, erfordert Lizenz für historische Vorhersagen) – gibt das Datum an, an dem das Wettervorhersagemodell ausgeführt wurde. Wenn Sie z.B. 2021-06-01 angeben, wird für die Daten vom 2021-06-01 bis 2021-06-15 die Wettervorhersage vom 1. Juni 2021 verwendet. Weitere Informationen finden Sie unter Wie Sie Wettervorhersagen aus der Vergangenheit abfragen.
forecastBasisDay (optional, erfordert eine Lizenz für historische Prognosen) – gibt den Prognosetag für den obigen Parameter date1 an. Wenn Sie z.B. als Startdatum 2021-06-05 und als forecastBasisDay den Wert 5 angeben, dann ist der Wert für 2021-06-06 die Vorhersage für den 5. Tag (d.h. sie basiert auf der Wettervorhersage, die fünf Tage zuvor erstellt wurde (2021-06-01). Sie können diesen Parameter verwenden, um schnell die Vorhersage zu finden, die für einen bestimmten Tag an mehreren Tagen vorhergesagt wurde (zum Beispiel die Vorhersage für 5, 3 und 1 Tag). Weitere Informationen finden Sie unter Wie Sie Wettervorhersagen aus der Vergangenheit abfragen.
Typisches JSON-Antwortformat
Alle Timeline Weather API-Anfragen geben als Antwort JSON im gleichen Format zurück. Hier ist ein Beispiel für Reston, VA am 11/12/2020:
{
"latitude" : 38.9697,
"longitude" : -77.385,
"resolvedAddress" : "Reston, VA, United States",
"address" : " Reston,VA",
"timezone" : "America/New_York",
"tzoffset" : -5,
"description":"Cooling down with a chance of rain on Friday.",
"days" : [{ //array of days of weather data objects
"datetime":"2020-11-12",
"datetimeEpoch":1605157200,
"temp" : 59.6,
"feelslike" : 59.6,
...
"stations" : {
},
"source" : "obs",
"hours" : [{ //array of hours of weather data objects
"datetime" : "01:00:00",
...
},...]
},...],
"alerts" : [{
"event" : "Flash Flood Watch",
"description" : "...",
...
}
],
"currentConditions" : {
"datetime" : "2020-11-11T22:48:35",
"datetimeEpoch" : 160515291500,
"temp" : 67.9,
...
}
}
Die Antwort beginnt mit einer Reihe von Eigenschaften, die den Ort und die Anfrage beschreiben. Dazu gehören der angefragte Ort, die aufgelöste Adresse, der Breiten- und Längengrad, eine textbasierte Zeitzone und ein Zeitzonen-Offset in Stunden. Beachten Sie, dass sich der Zeitzonenversatz innerhalb eines Datensatzes ändern kann (aufgrund der Sommerzeit). Wenn dies der Fall ist, finden Sie die Eigenschaft tzoffset im Wetterdatenobjekt Tag, Stunde oder aktuelle Bedingungen.
Das Array days ist ein Array mit Wetterdatenobjekten für jeden angeforderten Tag.
Innerhalb jedes Tages kann es ein Stundenfeld für die stündlichen Informationen geben. Statistische Vorhersagetage enthalten kein stündliches Array. Normalerweise hat das Stundenfeld eine Länge von 24 Stunden, aber die Sommerzeit kann dazu führen, dass das Feld 23 oder 25 Stunden lang ist.
Wenn die Anfrage das aktuelle Datum enthält, werden die aktuellen Bedingungen und alle für den Ort verfügbaren Wetterwarnungen angezeigt.
Antwort Wetterdatenelemente
Im Folgenden finden Sie eine Liste der Eigenschaften eines Tages- oder Stundendatenobjekts:
cloudcover– wie viel des Himmels mit Wolken bedeckt ist, von 0-100%.
conditions – textuelle Darstellung der Wetterbedingungen. Siehe Wetterdaten Bedingungen.
description– längere Textbeschreibungen, die sich für die Anzeige in Wetteranzeigen eignen. Die Beschreibungen fassen die wichtigsten Merkmale des Wetters für den Tag zusammen, wie z.B. Niederschlag oder die Menge der Wolkendecke. Tägliche Beschreibungen werden für historische und prognostizierte Tage bereitgestellt. Wenn die Anfrage für die Zeitleiste den Vorhersagezeitraum des Modells einschließt, wird eine Beschreibung für den Sieben-Tage-Ausblick auf der Ebene der Stammantwort bereitgestellt.
datetime – ISO 8601-formatiertes Datum, Uhrzeit oder datetime-Wert, der das Datum und die Uhrzeit der Wetterdaten in der lokalen Zeitzone des angefragten Ortes angibt. Weitere Informationen finden Sie unter Datum und Uhrzeit in der Wetter-API.
datetimeEpoch – Anzahl der Sekunden seit dem 1. Januar 1970 in UTC-Zeit
tzoffset – der Zeitzonen-Offset in Stunden. Dieser wird nur dann im Datenobjekt angezeigt, wenn er sich vom globalen Zeitzonen-Offset unterscheidet.
dew – Taupunkttemperatur
feelslike – wie sich die Temperatur unter Berücksichtigung von Hitzeindex und Windchill anfühlt. Die Tageswerte sind Durchschnittswerte (Mittelwert) für den Tag.
feelslikemax (nur tagsüber) – maximale gefühlte Temperatur am Standort.
feelslikemin (nur tagsüber) – gefühlte Mindesttemperatur am Standort.
hours – Array mit stündlichen Wetterdatenobjekten. Dies ist ein untergeordnetes Objekt jedes der täglichen Wetterobjekte, wenn Stunden ausgewählt sind.
humidity – relative Luftfeuchtigkeit in %
Symbol – eine feste, maschinenlesbare Zusammenfassung, die zur Anzeige eines Symbols verwendet werden kann
moonphase– stellt den Bruchteil des aktuellen Mondzyklus dar, der von 0 (Neumond) bis 0,5 (Vollmond) und zurück bis 1 (nächster Neumond) reicht. Siehe Wie Sie Daten zu Sonnenaufgang, Sonnenuntergang, Mondphase, Mondaufgang und Monduntergang in Ihre API-Anfragen aufnehmen
normal – Array mit normalen Wetterdatenwerten – Jede Wetterdaten-Norm ist ein Array mit drei Werten, die in dieser Reihenfolge den Mindestwert über den statistischen Zeitraum, den Mittelwert und den Höchstwert über den statistischen Zeitraum darstellen.
offsetseconds (nur stündlich) – Zeitzonen-Offset für dieses Wetterdatenobjekt in Sekunden – Dieser Wert kann sich für einen Ort aufgrund der Sommerzeitbeobachtung ändern.
precip – die Menge an flüssigem Niederschlag, die in diesem Zeitraum gefallen ist oder vorhergesagt wird. Dazu gehört auch die flüssigkeitsäquivalente Menge von gefrorenem Niederschlag wie Schnee oder Eis.
precipcover (nur Tage) – der Anteil der Stunden, in denen es einen Niederschlag ungleich Null gab
precipprob (nur Vorhersage) – die Wahrscheinlichkeit von messbarem Niederschlag im Bereich von 0% bis 100%.
preciptype – ein Array, das die Art(en) des erwarteten oder eingetretenen Niederschlags angibt. Mögliche Werte sind Regen, Schnee, gefrierender Regen und Eis.
pressure – der atmosphärische oder barometrische Druck auf Meereshöhe in Millibar (oder Hektopascal)
snow – die Menge an Schnee, die gefallen ist oder für die Schnee vorhergesagt wird
snowdepth – die Tiefe des Schnees auf dem Boden
source – die Art der Wetterdaten, die für dieses Wetterobjekt verwendet werden. – Die Werte umfassen historische Beobachtung (“obs”), Vorhersage (“fcst”), historische Vorhersage (“histfcst”) oder statistische Vorhersage (“stats”). Wenn mehrere Typen am selben Tag verwendet werden, wird “comb” verwendet. Heute eine Kombination aus historischen Beobachtungen und Vorhersagedaten.
stations(nur historische) – die Wetterstationen, die bei der Erfassung einer historischen Beobachtung verwendet werden
sunrise(nur Tag) – Die formatierte Zeit des Sonnenaufgangs (zum Beispiel “2022-05-23T05:50:40”). Siehe Wie Sie Daten zu Sonnenaufgang, Sonnenuntergang, Mondphase, Mondaufgang und Monduntergang in Ihre API-Anfragen aufnehmen
sunriseEpoch – Zeit des Sonnenaufgangs, angegeben als Anzahl der Sekunden seit dem 1. Januar 1970 in UTC-Zeit
Sonnenuntergang – Die formatierte Zeit des Sonnenuntergangs (zum Beispiel “2022-05-23T20:22:29”). Siehe Wie Sie Daten zu Sonnenaufgang, Sonnenuntergang, Mondphase, Mondaufgang und Monduntergang in Ihre API-Anfragen aufnehmen
sunsetEpoch – Sonnenuntergangszeit, angegeben als Anzahl der Sekunden seit dem 1. Januar 1970 in UTC-Zeit
moonrise(nur Tag, optional) – Die formatierte Zeit des Mondaufgangs (zum Beispiel “2022-05-23T02:38:10”). Siehe Wie Sie Daten zu Sonnenaufgang, Sonnenuntergang, Mondphase, Mondaufgang und Monduntergang in Ihre API-Anfragen aufnehmen
moonriseEpoch (nur Tag, optional) – Mondaufgangszeit, angegeben als Anzahl der Sekunden seit dem 1. Januar 1970 in UTC-Zeit
moonset(nur Tag, optional) – Die formatierte Zeit des Monduntergangs (zum Beispiel “2022-05-23T13:40:07”)
moonsetEpoch (nur Tag, optional) – Monduntergangszeit, angegeben als Anzahl der Sekunden seit dem 1. Januar 1970 in UTC-Zeit
temp – Temperatur am Standort. Die Tageswerte sind Durchschnittswerte (Mittelwert) für den Tag.
tempmax (nur Tag) – maximale Temperatur am Standort.
tempmin (nur Tag) – minimale Temperatur am Standort.
uvindex – ein Wert zwischen 0 und 10, der den Grad der UV-Belastung für diese Stunde oder diesen Tag angibt. 10 steht für ein hohes Maß an Exposition und 0 für keine Exposition. Der UV-Index wird auf der Grundlage der kurzwelligen Sonnenstrahlung berechnet, die wiederum von der Bewölkung, der Art der Wolken, der Tageszeit, der Jahreszeit und der Höhe des Standorts abhängt. Die Tageswerte stellen den Maximalwert der stündlichen Werte dar.
uvindex2 (optional, nur 5-Tage-Vorhersage) – ein alternatives UV-Index-Element, das die vom US National Weather Service verwendeten Algorithmen und Modelle verwendet. Um die Abwärtskompatibilität aufrechtzuerhalten, wird dieses UV-Indexelement als neues, optionales Element ‘uvindex2’ eingesetzt und kann über den Parameter elements angefordert werden.
visibility– Entfernung, in der weit entfernte Objekte sichtbar sind
winddir – Richtung, aus der der Wind weht
windgust – momentane Windgeschwindigkeit an einem Ort – Kann leer sein, wenn sie nicht wesentlich höher ist als die Windgeschwindigkeit. Die Tageswerte sind der maximale Stundenwert für den Tag.
windspeed– die anhaltende Windgeschwindigkeit, gemessen als durchschnittliche Windgeschwindigkeit, die während der letzten ein bis zwei Minuten auftritt. Die Tageswerte sind der maximale Stundenwert für den Tag.
windspeedmax (nur Tag, optional) – maximale Windgeschwindigkeit über den Tag.
windspeedmean (nur Tag , optional ) – durchschnittliche (mittlere) Windgeschwindigkeit über den Tag.
windspeedmin (nur Tag, optional) – minimale Windgeschwindigkeit über den Tag.
solarradiation– (W/m2) die Leistung der Sonneneinstrahlung zum Zeitpunkt der Beobachtung (oder Vorhersage). Siehe die vollständige Dokumentation der Sonneneinstrahlungsdaten und die Seiten Wind- und Solarenergie.
solarenergy– (MJ /m2 ) gibt die Gesamtenergie der Sonne an, die sich über eine Stunde oder einen Tag aufbaut. Siehe die vollständige Dokumentation der Sonneneinstrahlungsdaten und die Seiten Wind- und Solarenergie.
severerisk (nur Vorhersage) – ein Wert zwischen 0 und 100, der das Risiko von konvektiven Stürmen (z.B. Gewitter, Hagel und Tornados) angibt. Das schwere Risiko ist ein skaliertes Maß, das eine Vielzahl anderer Felder wie die verfügbare konvektive potentielle Energie (CAPE) und die konvektive Hemmung (CIN), den vorhergesagten Regen und den Wind kombiniert. In der Regel bedeutet ein Schwere-Risiko-Wert unter 30 ein geringes Risiko, zwischen 30 und 70 ein mittleres Risiko und über 70 ein hohes Risiko.
cape (nur Vorhersage) – konvektive verfügbare potentielle Energie. Dies ist eine Zahl, die die Menge an Energie angibt, die zur Erzeugung von Gewittern zur Verfügung steht. Ein höherer Wert weist auf eine instabilere Atmosphäre hin, die stärkere Gewitter erzeugen kann. Werte unter 1000 J/kg bedeuten im Allgemeinen geringe Instabilität, zwischen 1000-2500 J/kg mittlere Instabilität und 2500-4000 J/kg hohe Instabilität. Werte von mehr als 4000 J/kg weisen auf eine extrem instabile Atmosphäre hin.
cin (nur Vorhersage) – Konvektionshemmung. Eine Zahl, die den Grad der atmosphärischen Tendenz zur Verhinderung von Instabilität und damit von Gewittern angibt.
degreedays (nur Tag) – optionale Elemente, die die Anzahl der Gradtage für dieses Datum angeben. Weitere Informationen über Gradtage finden Sie in der API für Gradtage. Um die Gradtage und die Akkumulation von Gradtagen zu aktivieren, verwenden Sie den Parameter elements. Zum Beispiel: elements=datetime,tempmax,tempmin,degreedays,accdegreedays.
Um bestehende Dark Sky API-Parameter in die Timeline Weather API zu konvertieren, siehe So ersetzen Sie die Dark Sky API durch die Timeline Weather API.
Parameter Gradtage
degreeDayTempFix – Die Temperatur, bei der die Gradtags-Saison beginnen soll, wenn keine Saisonstart- und -enddaten angegeben sind. Wenn die Fixtemperatur z.B. 32F (OC) beträgt, werden die kumulativen Gradtage bei der letzten 32F Temperatur des Winters auf Null zurückgesetzt. Dies definiert die Wachstumsperiode für die Wachstumsgradtage.
degreeDayStartDate – Legt den Beginn der Gradtags-Saison auf der Grundlage fester Daten im Format jjjj-M-d fest (z.B. 1990-3-1 für den 1. März). Standardwert=nicht angegeben.
degreeDayTempMaxThreshold – Definiert die maximale Temperatur, die bei der Berechnung berücksichtigt wird. Jede Temperatur, die über dieser Temperatur liegt, wird auf die maximale Schwellentemperatur gesetzt. Standardwert=nicht festgelegt.
degreeDayTempBase – Die Gradtag-Basistemperatur. Der Standardwert ist auf 10C/50F eingestellt.
degreeDayInverse – Berechnet die inversen Gradtage, so dass kältere Temperaturen mehr Gradtage beitragen. Wird für Heizgradtage verwendet. Voreinstellung=false.
degreeDayMethod (beta) – Die für die Berechnung der Gradtage verwendete Methode. Die Werte umfassen Durchschnitt, Sinus, Doppelsinus, Dreieck und Doppeldreieck. Der Standardwert ist auf Durchschnitt eingestellt.
HTTP-Antwortcodes und Fehlerbehandlung
Die API kommuniziert Fehlercodes über den HTTP-Antwortcode. Darüber hinaus enthält der Antworttext normalerweise zusätzliche Fehlerinformationen, die die Ursache des Fehlers angeben. Zu den möglichen HTTP-Antwortstatuscodes gehören:
200 OK – eine erfolgreich bearbeitete Anfrage
400 BAD_REQUEST – Das Format der API ist falsch oder es wurde ein ungültiger Parameter oder eine ungültige Kombination von Parametern übergeben
401 UNAUTHORIZED – Es gibt ein Problem mit dem API-Schlüssel, dem Konto oder dem Abonnement. Kann auch zurückgegeben werden, wenn eine Funktion angefordert wird, für die das Konto keinen Zugang hat.
404 NOT_FOUND – Die Anfrage kann keiner gültigen API-Anfrage-Endpunktstruktur zugeordnet werden.
429 TOO_MANY_REQUESTS – Das Konto hat die ihm zugewiesenen Grenzen überschritten. Siehe Was ist die Ursache für “Die maximale Anzahl gleichzeitiger Aufträge wurde überschritten”, HTTP-Antwort 429
500 INTERNAL_SERVER_ERROR – Es ist ein allgemeiner Fehler bei der Verarbeitung der Anfrage aufgetreten.
Allgemeine Informationen zur Fehlersuche bei API-Abfragen finden Sie unter: Probleme bei der Ausführung von Wetter-API-Abfragen im Code beheben
Zugriff auf die Timeline Weather API über die OpenAPI-Beschreibung
Die OpenAPI-Initiative standardisiert die Beschreibung von APIs wie der Visual Crossing Weather API. Wenn Sie ein Tool verwenden, das den OpenAPI-Standard oder Swagger unterstützt, können Sie unsere API einfacher nutzen, indem Sie das unten stehende Spezifikationsdokument importieren.
https://www.visualcrossing.com/weather/specs/visualcrossing-weather-api-openapi.json
https://www.visualcrossing.com/weather/specs/visualcrossing-weather-api-openapi.yaml
https://www.visualcrossing.com/weather/specs/visualcrossing-weather-api-swagger.json
Questions or need help?
If you have a question or need help, please post on our actively monitored forum for the fastest replies. You can also contact us via our support site or drop us an email at support@visualcrossing.com.