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?
Our existing Weather API endpoints for /forecast and /history queries are still fully supported. The documentation for these endpoints can be found here.
The Timeline API offers complete, global weather data coverage both geographically and chronologically. It always picks the best available data sources to answer any weather API query. These sources include:
- Current weather conditions
- Daily historical, forecast and statistical forecast data (depending on dates requested)
- Hourly historical observations and 15-day forecast
- Weather alerts
- Astronomical observations including sunrise, sunset and moon phase.
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
The Weather Data Services page includes a full, interactive query builder so you can create queries and see the live results directly in your browser.
API Request Types
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
location (required) – is the address, partial address or latitude,longitude location for which to retrieve weather data. You can also use US ZIP Codes. If you would like to submit multiple locations in the same request, consider our Multiple Location Timeline Weather API.
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.
Instead of an exact date, you can specify a dynamic date period. See below for more details. You may also supply the in “UNIX time”. In this case provide the number of seconds since 1st January 1970 UTC. For example 1612137600 for Midnight on 1st February 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
Rather the specify and date range, you can also specify and dynamic period. A request based on a dynamic period will automatically adjust based on the period. In this example, we will use the dynamic period value “last30days” to retrieve data for the most recent 30 days.
https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/London,UK/last30days?key=YOUR_API_KEY
Other dynamic period values include “today”, “yesterday”, and “lastyear”. For a complete list of options and additional example, please see the dynamic period article.
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
For more information on our growing, cooling and heating degree day options, please see our degree day page.
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.
To include these advanced industry elements, please see our Agriculture and Horticulture and Wind and Solar Energy pages.
Zusätzliche Anfrageparameter
Die folgenden Parameter werden als HTTP-Abfrageparameter angegeben (sie können auch in einer POST-Abfrage übergeben werden).
key (required) – your API key. Sign up for a free account using our Weather Data Services page.
unitGroup (optional) – The system of units used for the output data.
Supported values are us, uk, metric, base. See Unit groups and measurement units for more information. Defaults to US system of units.
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.
See How to create or modify language files for more information on how to help add additional languages.
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 – daily data
- hours – hourly data
- alerts – weather alerts
- current – current conditions or conditions at requested time.
- events – historical events such as a hail, tornadoes, wind damage and earthquakes (not enabled by default)
- obs – historical observations from weather stations
- remote – historical observations from remote source such as satellite or radar
- fcst – forecast based on 16 day models.
- stats – historical statistical normals and daily statistical forecast
- statsfcst – use the full statistical forecast information for dates in the future beyond the current model forecast. Permits hourly statistical forecast.
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 – remove all null values from the JSON response
- noheaders – removes the header row from the CSV response
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) – used to choose which icons IDs are populated. For more information see Defining the icon set parameter in the Weather 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
All Timeline Weather API requests return response JSON in the same format. Here is an example for Reston, VA on 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 – textual representation of the weather conditions. See Weather Data Conditions.
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 formatted date, time or datetime value indicating the date and time of the weather data in the local time zone of the requested location. See Dates and Times in the Weather API for more information.
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 – represents the fractional portion through the current moon lunation cycle ranging from 0 (the new moon) to 0.5 (the full moon) and back to 1 (the next new moon). See How to include sunrise, sunset, moon phase, moonrise and moonset data into your API requests
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 (day only) – The formatted time of the sunrise (For example “2022-05-23T05:50:40”). See How to include sunrise, sunset, moon phase, moonrise and moonset data into your API requests
sunriseEpoch – Zeit des Sonnenaufgangs, angegeben als Anzahl der Sekunden seit dem 1. Januar 1970 in UTC-Zeit
sunset – The formatted time of the sunset (For example “2022-05-23T20:22:29”). See How to include sunrise, sunset, moon phase, moonrise and moonset data into your API requests
sunsetEpoch – Sonnenuntergangszeit, angegeben als Anzahl der Sekunden seit dem 1. Januar 1970 in UTC-Zeit
moonrise (day only, optional) – The formatted time of the moonrise (For example “2022-05-23T02:38:10”). See How to include sunrise, sunset, moon phase, moonrise and moonset data into your API requests
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) the solar radiation power at the instantaneous moment of the observation (or forecast prediction). See the full solar radiation data documentation and Wind and Solar Energy pages .
solarenergy – (MJ /m2 ) indicates the total energy from the sun that builds up over an hour or day. See the full solar radiation data documentation and Wind and Solar Energy pages .
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 (day only) – optional elements indicating the number of degree days for this date. See the degree days API for more information on degree days. To turn degree days and degree day accumulation on, use the elements parameter. For example, elements=datetime,tempmax,tempmin,degreedays,accdegreedays.
To convert existing Dark Sky API parameters to the Timeline Weather API, see How to replace the Dark Sky API with the Timeline Weather API.
Location and station elements
The following are available in the JSON response type to provide information about the requested location:
queryCost – The record cost of this query. See what is a record for more information.
latitude,longitude – the latitude and longitude of the requested location. This is provided in decimal degrees.
resolvedAddress – if the requested location was made by address, the address that is found using our internal geocoding engine.
address – the requested location text from the request.
timezone – the timezone of the location. See Date and Times in the Weather API for more information.
tzoffset – the timezone offset from UTC time for the first record of the data. This may change throughout the dataset if there is a daylight savings change during the requested date range.
elevation (optional) – the elevation of the requested location. This is an optional element requested by including the elements parameter: (see Adding and Removing Elements).
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 – The account has exceeded their assigned limits. See What is the cause of “Maximum concurrent jobs has been exceeded”, HTTP response 429
500 INTERNAL_SERVER_ERROR – Es ist ein allgemeiner Fehler bei der Verarbeitung der Anfrage aufgetreten.
For general information on debugging API queries, please see: How to debug problems when running weather API queries in code
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.