Weather - Get Current Conditions

Dienst:: Maps

API-Version:: 1.1

Verwenden Sie diese Option, um die aktuellen Wetterbedingungen abzurufen.
Bei der Get Current Conditions API handelt es sich um eine HTTP-Anforderung GET , die detaillierte aktuelle Wetterbedingungen wie Niederschlag, Temperatur und Wind für eine bestimmte Koordinatenposition zurückgibt. Außerdem können die beobachteten Daten für die letzten 6 oder 24 Stunden für einen bestimmten Standort abgerufen werden. Zu den grundlegenden Informationen, die mit der Antwort zurückgegeben werden, gehören Details wie Datum und Uhrzeit der Beobachtung, eine kurze Beschreibung der Wetterbedingungen, das Wettersymbol, die Flaggen der Niederschlagsindikatoren und die Temperatur. Zusätzliche Details wie RealFeel-Temperatur™ und UV-Index werden ebenfalls zurückgegeben. Weitere Informationen finden Sie unter Anfordern von Echtzeit-Wetterdaten

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}

Mit optionalen Parametern:

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&duration={duration}&language={language}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string (uri)	Der Hostname des Azure Maps-Dienstes. Verwenden Sie `https://atlas.microsoft.com` für die Azure Public Cloud. Um eine bestimmte Azure Maps Geografie oder eine souveräne Cloud anzusprechen, siehe Azure Maps geografischer Umfang.
format	path	True	JsonFormat	Gewünschtes Format der Antwort. Nur `json` Format wird unterstützt.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
query	query	True	number[]	Die entsprechende Abfrage, die als kommagetrennte Zeichenfolge angegeben wird, die durch Breitengrad und Längengrad besteht, z. B. "47.641268,-122.125679". Wetterinformationen sind in der Regel für Orte an Land, von Land umgebene Gewässer und Bereiche des Ozeans verfügbar, die sich innerhalb von etwa 50 Seemeilen um eine Küste befinden.
details	query		string	Geben Sie alle Details zu den aktuellen Bedingungen zurück. Verfügbare Werte sind `true` - Gibt alle Details zurück. Standardmäßig werden alle Details zurückgegeben. `false` - Gibt eine gekürzte Version der aktuellen Zustandsdaten zurück, die Datum/Uhrzeit der Beobachtung, Wetterphrase, Symbolcode, Niederschlagsindikatorflagge und Temperatur enthält.
duration	query		integer (int32)	Zeitrahmen der zurückgekehrten Wetterbedingungen. Standardmäßig werden die aktuellsten Wetterbedingungen zurückgegeben. Standardwert ist 0. Unterstützte Werte sind: `0` - Geben Sie die aktuellsten Wetterbedingungen zurück. `6` - Kehren Sie zu den Wetterbedingungen der letzten 6 Stunden zurück. `24` - Rückkehr der Wetterbedingungen der letzten 24 Stunden.
language	query		string	Sprache, in der Suchergebnisse zurückgegeben werden sollen. Sollte eine der unterstützten IETF-Sprachtags sein, Groß-/Kleinschreibung wird nicht beachtet. Wenn Daten in der angegebenen Sprache für ein bestimmtes Feld nicht verfügbar sind, wird die Standardsprache verwendet. Weitere Informationen finden Sie unter unterstützten Sprachen.
unit	query		WeatherDataUnit	Gibt an, dass die Daten entweder in metrischen Einheiten oder in britischen Einheiten zurückgegeben werden sollen. Der Standardwert ist die Metrik.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
x-ms-client-id		string	Gibt das Konto an, das für die Nutzung mit dem Microsoft Entra ID-Sicherheitsmodell vorgesehen ist. Diese eindeutige ID für das Azure Maps-Konto kann aus der Azure Maps Management-Plane-Konto-API abgerufen werden. Weitere Informationen zur Nutzung Microsoft Entra ID Sicherheit in Azure Maps finden Sie unter Authentifizierung verwalten in Azure Maps.

Antworten

Name	Typ	Beschreibung
200 OK	CurrentConditionsResult	Die Anforderung ist erfolgreich.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

AadToken

Dies sind die Microsoft Entra OAuth 2.0 Flows. In Kombination mit Azure rollenbasierten Zugriffs Steuerung kann sie verwendet werden, um den Zugriff auf Azure Maps REST-APIs zu steuern. Azure-rollenbasierte Zugriffskontrollen werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps-Ressourcenkonten oder -Unterressourcen zu bestimmen. Jedem Benutzer, Gruppen- oder Dienstprinzipal kann über eine integrierte Rolle oder eine benutzerdefinierte Rolle, die aus einer oder mehreren Berechtigungen für Azure Maps-REST-APIs besteht, Zugriff gewährt werden.

Um Szenarien zu implementieren, empfehlen wir, Authentifizierungskonzepteanzuzeigen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung für die Modellierung von Anwendungen über Objekte, die zugriffsfähig für bestimmte APIs und Bereiche sind.

Note

Diese Sicherheitsdefinition erfordert die Verwendung des x-ms-client-id-Headers, um anzugeben, auf welche Azure Maps-Ressource die Anwendung Zugriff anfordert. Dies kann über die Karten-Verwaltungs-APIerworben werden.
Die Authorization URL ist spezifisch für die Öffentliche Azure-Cloudinstanz. Souveräne Clouds verfügen über einzigartige Autorisierungs-URLs und Microsoft Entra ID-Konfigurationen.
Die rollenbasierte Azure-Zugriffssteuerung wird über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs konfiguriert.
Die Verwendung des Azure Maps Web SDK ermöglicht das konfigurationsbasierte Einrichten einer Anwendung für mehrere Anwendungsfälle.
Weitere Informationen zur Microsoft Identity Platform finden Sie unter Übersicht über die Microsoft Identity Platform.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
https://atlas.microsoft.com/.default

subscription-key

Dies ist ein freigegebener Schlüssel, der bereitgestellt wird, wenn Sie Erstellen eines Azure Maps-Kontos im Azure-Portal oder mithilfe von PowerShell, CLI, Azure SDKs oder REST-API.

Mit diesem Schlüssel kann jede Anwendung auf alle REST-API zugreifen. Mit anderen Worten, dieser Schlüssel kann als Hauptschlüssel in dem Konto verwendet werden, in dem sie ausgestellt werden.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, die vertraulichen Clientanwendungen Ansatz für den Zugriff auf Azure Maps-REST-APIs zu verwenden, damit Ihr Schlüssel sicher gespeichert werden kann.

Typ: apiKey
In: header

SAS Token

Dies ist ein Freigegebenes Zugriffssignaturtoken wird aus dem Listen-SAS-Vorgang auf der Azure Maps-Ressource über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs erstellt.

Mit diesem Token ist jede Anwendung für den Zugriff mit rollenbasierten Azure-Zugriffssteuerungen und feinkörniger Kontrolle auf den Ablauf, die Rate und die Region(en) der Verwendung für das jeweilige Token autorisiert. Mit anderen Worten, das SAS-Token kann verwendet werden, um Anwendungen das Steuern des Zugriffs auf eine sicherere Weise zu ermöglichen als der freigegebene Schlüssel.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, eine bestimmte Liste der zulässigen Ursprünge auf der Zuordnungskontoressource zu konfigurieren,, um das Rendern von Missbrauch zu begrenzen und das SAS-Token regelmäßig zu erneuern.

Typ: apiKey
In: header

Beispiele

Successfully retrieve detailed current weather conditions for a given coordinate location

Beispielanforderung

HTTP

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

Beispiel für eine Antwort

Statuscode:: 200

{
  "results": [
    {
      "apparentTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 16.1
      },
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4359
      },
      "cloudCover": 95,
      "dateTime": "2019-11-14T15:08:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 9.2
      },
      "hasPrecipitation": false,
      "iconCode": 7,
      "isDayTime": true,
      "obstructionsToVisibility": "",
      "pastTwentyFourHourTemperatureDeparture": {
        "unit": "C",
        "unitType": 17,
        "value": 1.8
      },
      "phrase": "Cloudy",
      "precipitationSummary": {
        "past12Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past18Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past24Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past3Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past6Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past9Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "pastHour": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.5
        }
      },
      "pressure": {
        "unit": "mb",
        "unitType": 14,
        "value": 1014.9
      },
      "pressureTendency": {
        "code": "S",
        "localizedDescription": "Steady"
      },
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "realFeelTemperatureShade": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "relativeHumidity": 75,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.7
      },
      "temperatureSummary": {
        "past12Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past24Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past6Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 8.3
          }
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 8
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.4
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 3.6
        }
      },
      "windChillTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.9
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 4.9
        }
      }
    }
  ]
}

Definitionen

Name	Beschreibung
CurrentConditions	Eine einzelne Wetterbeobachtung für den angegebenen Ort, zurückgegeben durch die Operation 'Aktuelle Bedingungen abrufen'. Je nach Anfrage `duration`kann diese Beobachtung die neueste (jüngste) Messung oder eine der vorherigen stündlichen Beobachtungen sein. Standardmäßig wird eine vereinfachte Teilmenge zurückgegeben: Beobachtungsdatum und -zeit, Wetterphrase, Symbolcode, Niederschlagsanzeiger und Temperatur. Wenn die Anfrage nach vollständigen Details fragt, wird jede Immobilie enthalten und Messungen wie RealGefühl, Taupunkt, Wind, Sicht, Wolkenbedeckung, Druck sowie rollende Niederschlags- und Temperaturübersichten für die letzten Stunden hinzugefügt.
CurrentConditionsResult	Die Antwort, die von der Operation "Aktuelle Bedingungen abrufen" zurückgegeben wird, enthält eine oder mehrere aktuelle Beobachtungen für einen bestimmten Ort. Standardmäßig wird eine einzelne Beobachtung für die gegenwärtige Zeit zurückgegeben; wenn der Parameter `duration` auf 6 oder 24 gesetzt wird, enthält die Antwort außerdem eine Beobachtung pro vergangener Stunde über dieses Fenster.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Übliche Fehlerantwort für alle Azure Resource Manager APIs, um Fehlerdetails bei fehlgeschlagenen Operationen zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)
IconCode	Der numerische Wettercode, der angibt, welches Symbol angezeigt werden soll. Jeder Wert in dieser Aufzählung entspricht einem Azure Maps-Wettersymbol (wie Sunny, Cloudy oder Thunderstorms) und wird mit einem von Menschen lesbaren Symbol `iconPhrase` kombiniert, das dazu zurückgegeben wird. Derselbe Code kann in aktuellen, stündlichen, täglichen, vierteltags- und minuten-für-minuten-Antworten erscheinen, sodass Anwendungen ein konsistentes Symbol für alle Wetterdienste darstellen können. Für die vollständige Liste der Codes, die zugeordneten Symbole und Beispielbilder siehe Weather Services in Azure Maps.
JsonFormat	Gewünschtes Format der Antwort. Nur `json` Format wird unterstützt.
PastHoursTemperature	Die höchsten und niedrigsten Lufttemperaturen, die während eines der Rollfenster ( `TemperatureSummary` nach 6, 12 oder 24 Stunden) beobachtet werden, liegen in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der in der Anfrage angegebenen Einheit.
PrecipitationSummary	Die gesamte flüssigkeitsäquivalente Niederschläge, die am Beobachtungspunkt über rollende Fenster gefallen ist, die zum Zeitpunkt der Beobachtung enden. Jeder Wert deckt das gesamte Fenster ab, das von "jetzt" zurückgemessen wird – zum Beispiel `past3Hours` ist das laufende Gesamtergebnis der letzten drei Stunden, nicht nur der dritten Stunde – sodass sich die Fenster überlappen und längere Fenster die für die kürzere gemeldete Niederschlagsmenge enthalten. Schnee und Eis tragen ihr geschmolzenes (flüssiges) Äquivalent bei. Angegeben in Millimetern (mm) oder Zoll (in), abhängig von der in der Anfrage angegebenen Einheit.
PressureTendency	Der jüngste Trend des atmosphärischen Drucks – ob der Druck steigt, fällt oder konstant ist – kehrte sowohl als lokalisierter Begriff als auch als einbuchstabiger Code zurück. Nützlich zur Vorhersage kurzfristiger Wetteränderungen; sinkender Druckdruck signalisiert oft eine Verschlechterung des Wetters, während steigender Druck typischerweise auf bessere Bedingungen hinweist.
TemperatureSummary	Die höchsten und niedrigsten Lufttemperaturen, die an diesem Ort über Rollfenster beobachtet wurden, endeten zur Beobachtungszeit. Jeder Wert deckt das gesamte Fenster ab, das von "jetzt" zurückgemessen wird – zum Beispiel berichtet `past12Hours` es über Hoch- und Tiefstwerte über die letzten 12 Stunden, nicht nur die zwölfte Stunde – sodass sich die Fenster überlappen und längere Fenster die für die kürzeren Zeiten gemeldeten Temperaturen enthalten. Je nach angegebener Einheit in Grad Celsius (°C) oder Fahrenheit (°F).
UnitType	Ein ganzzahliger Wert, der mit dem Typ der angezeigten Einheit assoziiert ist. Zum Beispiel 17 für Celsius, 18 für Fahrenheit. Kann für die Einheitenumrechnung verwendet werden. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps.
WeatherDataUnit	Spezifiziert, ob Daten in metrischen oder imperialen Einheiten zurückgegeben werden sollen, wobei metrische Einheiten standardmäßig metrisch sind. Beispiel: Metrisch: Millimeter (mm), Meter (m), Kilometer (km), Celsius (C) Imperial: Zoll (Zoll), Fuß (ft), Meile (mi), Fahrenheit (F)
WeatherValue	Werte für wetterbezogene Metriken wie Temperatur, Taupunkt und Windgeschwindigkeit, präsentiert entweder in metrischen oder imperialen Einheiten, wie im Einheits-URI-Parameter angegeben. Weitere Informationen finden Sie unter Einheitstypen im Artikel Wetterdienste in Azure Maps.
WindDetails	Liefert die prognostizierte Windgeschwindigkeit, gemessen in Einheiten wie Kilometer pro Stunde (km/h) oder Meilen pro Stunde (mph), je nach in der Anfrage angegebener Einheit. Gibt außerdem die Windrichtung an, gemessen in Azimutgrad, beginnend im wahren Norden und im Uhrzeigersinn bewegend. Nord entspricht 0°, Ost 90°, Süden 180° und Westen 270°. Mögliche Werte reichen von 0° bis 359°.
WindDirection	Liefert Details zur Windrichtung, einschließlich der Richtung in Azimutgraden und einer lokalisierten Abkürzung der Windrichtung.

CurrentConditions

Objekt

Eine einzelne Wetterbeobachtung für den angegebenen Ort, zurückgegeben durch die Operation 'Aktuelle Bedingungen abrufen'. Je nach Anfrage durationkann diese Beobachtung die neueste (jüngste) Messung oder eine der vorherigen stündlichen Beobachtungen sein. Standardmäßig wird eine vereinfachte Teilmenge zurückgegeben: Beobachtungsdatum und -zeit, Wetterphrase, Symbolcode, Niederschlagsanzeiger und Temperatur. Wenn die Anfrage nach vollständigen Details fragt, wird jede Immobilie enthalten und Messungen wie RealGefühl, Taupunkt, Wind, Sicht, Wolkenbedeckung, Druck sowie rollende Niederschlags- und Temperaturübersichten für die letzten Stunden hinzugefügt.

Name	Typ	Beschreibung
apparentTemperature	WeatherValue	Die scheinbare Temperatur zum Zeitpunkt der Beobachtung – wie sich die Luft tatsächlich für Menschen anfühlt, unter Berücksichtigung der Lufttemperatur, der relativen Luftfeuchtigkeit und der Windgeschwindigkeit. Gemessen in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der im Antrag angegebenen Einheit.
ceiling	WeatherValue	Die Wolkendecke zur Beobachtungszeit – die Höhe der untersten Wolkenschicht über dem Boden – in Fuß (ft) oder Metern (m), abhängig von der in der Anfrage angegebenen Einheit. Wichtig für die Luftfahrt, da es die Flugsicht und den Betrieb beeinflusst.
cloudCover	integer (int32)	Der Prozentsatz des Himmels, der zur Beobachtungszeit von Wolken bedeckt ist, von 0 (klar) bis 100 (bewölkt). Darf NULL sein.
dateTime	string (date-time)	Das Datum und die Uhrzeit dieser Beobachtung im RFC-3339-Format (yyyy-mm-ddThh:mm:ss-hh:mm). Zum Beispiel 2025-04-29T07:00:00-07:00.
dewPoint	WeatherValue	Der Taupunkt zur Beobachtungszeit – die Temperatur, auf die die Luft abkühlen muss, um gesättigt zu werden (100% relative Luftfeuchtigkeit). Gemessen in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der im Antrag angegebenen Einheit. Ein höherer Taupunkt zeigt mehr Feuchtigkeit in der Luft.
hasPrecipitation	boolean	`true` wenn zum Zeitpunkt der Beobachtung Niederschlag (Regen, Schnee, Schneeregen oder Hagel) stattfindet; ansonsten `false`.
iconCode	IconCode	Der repräsentative Wettersymbolcode für diese Beobachtung, gekoppelt mit der Eigenschaft `phrase` . Der numerische Wert entspricht einem Azure Maps-Wettersymbol – für die vollständige Liste siehe Wetterdienste in Azure Maps. Darf NULL sein.
isDayTime	boolean	`true` wenn es Tag am angegebenen Ort zur Beobachtungszeit ist; `false` wenn es Nacht ist.
obstructionsToVisibility	string	Ein Code, der den dominierenden Faktor identifiziert, der die Sichtbarkeit zur Beobachtungszeit verringert, wie etwa Nebel, Rauch, Nebel oder Niederschlag. Nützlich für Aktivitäten, die auf freie Sicht angewiesen sind, wie Fahren und Luftfahrt. Mögliche Werte: A = starkes Gewitter/Hagel BD = Staub blasen BN = Sand blasen BS = Schnee wehen D = Staub F = Nebel GF = Bodennebel HZ = Nebel I = Eis IC = Eiskristalle IF = Eisnebel IP = Eispellets IPW = Eispellets-Dusche K = Rauch L = Nieselregen R = Regen RS = Regen/Schnee RW = Regenschauer S = Schnee SG = Schneegranulate SP = Schneepellets SW = Schneeschauer T = Gewitter UP = undefinierte Niederschlagsmenge ZL = gefrorener Nieseln ZR = Gefrierregen + = schwer - = Licht
pastTwentyFourHourTemperatureDeparture	WeatherValue	Die Veränderung der Lufttemperatur im Vergleich zu vor 24 Stunden, in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der in der Anfrage angegebenen Einheit. Positive Werte zeigen an, dass die Luft zur gleichen Zeit wärmer ist als gestern; negative Werte bedeuten, dass sie kühler ist.
phrase	string	Ein kurzer, beschreibender Begriff für die Wetterbedingungen zur Beobachtungszeit – zum Beispiel sonnig oder teilweise bewölkt. Paart mit `iconCode`, das das passende Wettersymbol identifiziert. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps.
precipitationSummary	PrecipitationSummary	Eine Zusammenfassung der flüssigkeitsäquivalenten Niederschlagsmengen am Beobachtungsort über rollende Fenster der letzten 1, 3, 6, 9, 12, 18 und 24 Stunden, in Millimetern (mm) oder Zoll (in), abhängig von der in der Anfrage angegebenen Einheit.
pressure	WeatherValue	Der atmosphärische (Luft-)Druck auf Bodenniveau zur Beobachtungszeit, in Millibar (mb) oder Zoll Quecksilber (inHg), abhängig von der in der Anfrage angegebenen Einheit.
pressureTendency	PressureTendency	Der jüngste Trend des Atmosphärendrucks – steigend, fallen oder stetig. Nützlich zur Vorhersage kurzfristiger Wetteränderungen; sinkender Druckdruck signalisiert oft eine Verschlechterung des Wetters, während steigender Druck typischerweise auf bessere Bedingungen hinweist.
realFeelTemperature	WeatherValue	Die RealFeel-Temperatur™ zur Beobachtungszeit, in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der in der Anfrage angegebenen Einheit. Entwickelt von AccuWeather, kombiniert RealFeel Lufttemperatur mit Luftfeuchtigkeit, Wind, Wolkendecke, Sonnenintensität und weiteren Faktoren, um zu zeigen, wie sich das Wetter tatsächlich anfühlt. Weitere Informationen finden Sie unter Wie ist die AccuWeather RealFeel-Temperatur?
realFeelTemperatureShade	WeatherValue	Die RealFeel-Temperatur™ zur Beobachtungszeit in schattierten Bereichen in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der in der Anfrage angegebenen Einheit. Wie `realFeelTemperature`, aber schließt den Erwärmungseffekt direkter Sonnenlichts aus, was ein genaueres Gefühl dafür vermittelt, wie sich das Wetter im Schatten anfühlt.
relativeHumidity	integer (int32)	Die relative Luftfeuchtigkeit zum Zeitpunkt der Beobachtung, ausgedrückt als Prozentsatz von 0 bis 100 der maximalen Menge an Wasserdampf, die die Luft bei derselben Temperatur halten kann.
temperature	WeatherValue	Die Lufttemperatur zum Zeitpunkt der Beobachtung, in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der in der Anfrage angegebenen Einheit.
temperatureSummary	TemperatureSummary	Eine Zusammenfassung der höchsten und niedrigsten Lufttemperaturen, die an diesem Standort über rollende Fenster der letzten 6, 12 und 24 Stunden beobachtet wurden, in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der im Anfrage angegebenen Einheit.
uvIndex	integer (int32)	Der UV-Index zum Zeitpunkt der Beobachtung zeigt das Risiko von Schäden durch ungeschützte Sonneneinstrahlung an. Unterstützte Werte sind: 0-2: Geringe Gefahr durch die UV-Strahlen der Sonne für den Durchschnittsmenschen. 3-5: Moderates Risiko für Schäden durch ungeschützte Sonneneinstrahlung. 6-7: Hoher Schadensrisiko durch ungeschützte Sonneneinstrahlung. 8-10: Sehr hohes Risiko für Schäden durch ungeschützte Sonneneinstrahlung. 11+: Extremes Risiko von Schäden durch ungeschützte Sonneneinstrahlung.
uvIndexPhrase	string	Ein kurzes beschreibendes Etikett für `uvIndex` – zum Beispiel Niedrig, Mäßig, Hoch,Sehr Hoch oder Extrem.
visibility	WeatherValue	Die horizontale Sichtbarkeit zur Beobachtungszeit – also die Entfernung, in der ein Objekt oder Licht klar erkannt werden kann – in Kilometern (km) oder Meilen (mi), abhängig von der in der Anfrage angegebenen Einheit.
wetBulbTemperature	WeatherValue	Die Feuchtkugeltemperatur zum Zeitpunkt der Beobachtung – die Temperatur, die die Luft erreichen würde, wenn sie durch das Verdampfen von Wasser bei konstantem Druck auf Sättigung (100% relative Luftfeuchtigkeit) abgekühlt wird. Gemessen in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der im Antrag angegebenen Einheit. Nützlich zur Bewertung von Hitzestress und Verdunstungskühlung.
wind	WindDetails	Die Windgeschwindigkeit und -richtung zur Beobachtungszeit. Die Geschwindigkeit beträgt in Kilometern pro Stunde (km/h) oder Meilen pro Stunde (mph), abhängig von der im Antrag angegebenen Einheit; die Richtung ist in Azimutgrad, im Uhrzeigersinn vom wahren Norden aus gemessen (0° = N, 90° = E, 180° = S, 270° = W).
windChillTemperature	WeatherValue	Die Windchill-Temperatur zur Beobachtungszeit – wie kalt sich die Luft auf freiliegender Haut durch die kombinierte Wirkung von Wind und niedriger Temperatur anfühlt. Typischerweise niedriger als die tatsächliche Lufttemperatur. Gemessen in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der im Antrag angegebenen Einheit.
windGust	WindDetails	Die maximale Windgeschwindigkeit und -richtung bei kurzen Windstößen zur Beobachtungszeit, unter Verwendung derselben Einheiten und Azimutkonvention wie `wind`. Windböen sind kurze Spitzen in der Windgeschwindigkeit, die Aktivitäten wie Luftfahrt, Segeln, Drachensteigen und andere Outdoor-Aktivitäten beeinflussen können.

CurrentConditionsResult

Objekt

Die Antwort, die von der Operation "Aktuelle Bedingungen abrufen" zurückgegeben wird, enthält eine oder mehrere aktuelle Beobachtungen für einen bestimmten Ort. Standardmäßig wird eine einzelne Beobachtung für die gegenwärtige Zeit zurückgegeben; wenn der Parameter duration auf 6 oder 24 gesetzt wird, enthält die Antwort außerdem eine Beobachtung pro vergangener Stunde über dieses Fenster.

Name	Typ	Beschreibung
results	CurrentConditions[]	Die Beobachtungen der aktuellen Bedingungen, chronologisch geordnet mit der jüngsten zuerst. Standardmäßig ein einziger Eintrag – die neueste Beobachtung wird zurückgegeben; die Antwort kann je nach Anfrage auch einen Eintrag pro Stunde über ein kürzliches Rolling-Fenster (typischerweise die letzten 6 oder 24 Stunden) enthalten.

Name

Typ

Beschreibung

results

CurrentConditions[]

Die Beobachtungen der aktuellen Bedingungen, chronologisch geordnet mit der jüngsten zuerst. Standardmäßig ein einziger Eintrag – die neueste Beobachtung

wird zurückgegeben; die Antwort kann je nach Anfrage auch einen Eintrag pro Stunde über ein kürzliches Rolling-Fenster (typischerweise die letzten 6 oder 24 Stunden) enthalten.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info		Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Übliche Fehlerantwort für alle Azure Resource Manager APIs, um Fehlerdetails bei fehlgeschlagenen Operationen zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

IconCode

Enumeration

Der numerische Wettercode, der angibt, welches Symbol angezeigt werden soll. Jeder Wert in dieser Aufzählung entspricht einem Azure Maps-Wettersymbol (wie Sunny, Cloudy oder Thunderstorms) und wird mit einem von Menschen lesbaren Symbol iconPhrase kombiniert, das dazu zurückgegeben wird. Derselbe Code kann in aktuellen, stündlichen, täglichen, vierteltags- und minuten-für-minuten-Antworten erscheinen, sodass Anwendungen ein konsistentes Symbol für alle Wetterdienste darstellen können.

Für die vollständige Liste der Codes, die zugeordneten Symbole und Beispielbilder siehe Weather Services in Azure Maps.

Wert	Beschreibung
1	Sonnig
2	Überwiegend sonnig
3	Teilweise sonnig
4	Zeitweilige Wolken
5	Dunstiger Sonnenschein
6	Überwiegend bewölkt
7	Cloudy
8	Trist (bewölkt)
11	Nebel
12	Showers
13	Größtenteils bewölkt mit Regenschauern
14	Teilweise sonnig mit Regenschauern
15	Thunderstorms
16	Größtenteils bewölkt mit Gewittern
17	Teilweise sonnig mit Gewittern
18	Regen
19	Flurries
20	Größtenteils bewölkt mit Böen
21	Teilweise sonnig mit Böen
22	Snow
23	Größtenteils bewölkt mit Schnee
24	Eis
25	Graupel
26	Gefrierender Regen
29	Regen und Schnee
30	Hot
31	Kalt
32	Windy
33	Klar
34	Meist klar
35	Teilweise bewölkt
36	Zeitweilige Wolken
37	Dunstiges Mondlicht
38	Überwiegend bewölkt
39	Teilweise bewölkt mit Regenschauern
40	Größtenteils bewölkt mit Regenschauern
41	Teilweise bewölkt mit Gewittern
42	Größtenteils bewölkt mit Gewittern
43	Größtenteils bewölkt mit Böen
44	Größtenteils bewölkt mit Schnee

JsonFormat

Enumeration

Gewünschtes Format der Antwort. Nur json Format wird unterstützt.

Wert	Beschreibung
json	das JavaScript Object Notation Data Interchange Format

PastHoursTemperature

Objekt

Die höchsten und niedrigsten Lufttemperaturen, die während eines der Rollfenster ( TemperatureSummary nach 6, 12 oder 24 Stunden) beobachtet werden, liegen in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der in der Anfrage angegebenen Einheit.

Name	Typ	Beschreibung
maximum	WeatherValue	Die höchste Temperatur, die während des Fensters beobachtet wurde.
minimum	WeatherValue	Die niedrigste Temperatur, die während des Fensters beobachtet wurde.

PrecipitationSummary

Objekt

Die gesamte flüssigkeitsäquivalente Niederschläge, die am Beobachtungspunkt über rollende Fenster gefallen ist, die zum Zeitpunkt der Beobachtung enden. Jeder Wert deckt das gesamte Fenster ab, das von "jetzt" zurückgemessen wird – zum Beispiel past3Hours ist das laufende Gesamtergebnis der letzten drei Stunden, nicht nur der dritten Stunde – sodass sich die Fenster überlappen und längere Fenster die für die kürzere gemeldete Niederschlagsmenge enthalten. Schnee und Eis tragen ihr geschmolzenes (flüssiges) Äquivalent bei. Angegeben in Millimetern (mm) oder Zoll (in), abhängig von der in der Anfrage angegebenen Einheit.

Name	Typ	Beschreibung
past12Hours	WeatherValue	Flüssigkeitsäquivalente Niederschlagsmenge, die in den letzten 12 Stunden gefallen ist.
past18Hours	WeatherValue	Flüssigkeitsäquivalenter Niederschlag, der in den letzten 18 Stunden gefallen ist.
past24Hours	WeatherValue	Flüssigkeitsäquivalente Niederschlagsmenge, die in den letzten 24 Stunden gefallen ist.
past3Hours	WeatherValue	Flüssigkeitsäquivalente Niederschlagsmenge, die in den letzten 3 Stunden gefallen ist.
past6Hours	WeatherValue	Flüssigkeitsäquivalente Niederschlagsmenge, die in den letzten 6 Stunden gefallen ist.
past9Hours	WeatherValue	Flüssigkeitsäquivalente Niederschlagsmenge, die in den letzten 9 Stunden gefallen ist.
pastHour	WeatherValue	Flüssigkeitsäquivalente Niederschlagsmenge, die in der letzten Stunde gefallen ist.

PressureTendency

Objekt

Der jüngste Trend des atmosphärischen Drucks – ob der Druck steigt, fällt oder konstant ist – kehrte sowohl als lokalisierter Begriff als auch als einbuchstabiger Code zurück. Nützlich zur Vorhersage kurzfristiger Wetteränderungen; sinkender Druckdruck signalisiert oft eine Verschlechterung des Wetters, während steigender Druck typischerweise auf bessere Bedingungen hinweist.

Name	Typ	Beschreibung
code	string	Ein sprachunabhängiger einbuchstabiger Code für die Drucktendenz: F = Fallend, S = Stetig, R = Steigend.
localizedDescription	string	Ein kurzer Satz, der die Drucktendenz beschreibt – zum Beispiel Fallend, Steady oder Rising – wurde in der in der Anfrage angegebenen Sprache zurückgegeben.

TemperatureSummary

Objekt

Die höchsten und niedrigsten Lufttemperaturen, die an diesem Ort über Rollfenster beobachtet wurden, endeten zur Beobachtungszeit. Jeder Wert deckt das gesamte Fenster ab, das von "jetzt" zurückgemessen wird – zum Beispiel berichtet past12Hours es über Hoch- und Tiefstwerte über die letzten 12 Stunden, nicht nur die zwölfte Stunde – sodass sich die Fenster überlappen und längere Fenster die für die kürzeren Zeiten gemeldeten Temperaturen enthalten. Je nach angegebener Einheit in Grad Celsius (°C) oder Fahrenheit (°F).

Name	Typ	Beschreibung
past12Hours	PastHoursTemperature	Höchste und niedrigste Temperaturen wurden in den letzten 12 Stunden beobachtet.
past24Hours	PastHoursTemperature	Höchste und niedrigste Temperaturen wurden in den letzten 24 Stunden beobachtet.
past6Hours	PastHoursTemperature	Höchste und niedrigste Temperaturen wurden in den letzten 6 Stunden beobachtet.

UnitType

Enumeration

Ein ganzzahliger Wert, der mit dem Typ der angezeigten Einheit assoziiert ist. Zum Beispiel 17 für Celsius, 18 für Fahrenheit. Kann für die Einheitenumrechnung verwendet werden. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps.

Wert	Beschreibung
0	feet
1	inches
2	miles
3	millimeter
4	centimeter
5	meter
6	kilometer
7	kilometersPerHour
8	knots
9	milesPerHour
10	metersPerSecond
11	hectoPascals
12	inchesOfMercury
13	kiloPascals
14	millibars
15	millimetersOfMercury
16	poundsPerSquareInch
17	Celsius
18	Fahrenheit
19	kelvin
20	percent
21	Schweben
22	Integer
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Enumeration

Spezifiziert, ob Daten in metrischen oder imperialen Einheiten zurückgegeben werden sollen, wobei metrische Einheiten standardmäßig metrisch sind. Beispiel:

Metrisch: Millimeter (mm), Meter (m), Kilometer (km), Celsius (C)
Imperial: Zoll (Zoll), Fuß (ft), Meile (mi), Fahrenheit (F)

Wert	Beschreibung
imperial	Geben Sie Daten mit imperialen Einheiten wie Fahrenheit (F) für Temperatur und Meilen (mi) für Entfernung zurück.
metric	Geben Sie Daten mit metrischen Einheiten wie Celsius (C) für die Temperatur und Kilometer (km) für die Entfernung zurück.

WeatherValue

Objekt

Werte für wetterbezogene Metriken wie Temperatur, Taupunkt und Windgeschwindigkeit, präsentiert entweder in metrischen oder imperialen Einheiten, wie im Einheits-URI-Parameter angegeben. Weitere Informationen finden Sie unter Einheitstypen im Artikel Wetterdienste in Azure Maps.

Name	Typ	Beschreibung
unit	string	Die im Rückgabewert verwendete Maßeinheit ist zum Beispiel "C" für Celsius, "F" für Fahrenheit.
unitType	UnitType	Eine ganze Zahl, die den Einheitstyp darstellt. Zum Beispiel 0 für Füße, 1 für Zoll, 2 für Meilen. Eine vollständige Liste finden Sie unter Einheitstypen im Artikel Wetterdienste in Azure Maps.
value	number (float)	Der gemessene Wert, ausgedrückt in der angegebenen Einheit.

WindDetails

Objekt

Liefert die prognostizierte Windgeschwindigkeit, gemessen in Einheiten wie Kilometer pro Stunde (km/h) oder Meilen pro Stunde (mph), je nach in der Anfrage angegebener Einheit. Gibt außerdem die Windrichtung an, gemessen in Azimutgrad, beginnend im wahren Norden und im Uhrzeigersinn bewegend. Nord entspricht 0°, Ost 90°, Süden 180° und Westen 270°. Mögliche Werte reichen von 0° bis 359°.

Name	Typ	Beschreibung
direction	WindDirection	Die Windrichtung wird in Azimutgrad gemessen, beginnend bei wahrem Norden (0°) und im Uhrzeigersinn. Ost entspricht 90°, Süd 180° und Westen 270°. Mögliche Werte reichen von 0° bis 359°. Diese Eigenschaft liefert eine ganze Zahl, die die Windrichtung repräsentiert.
speed	WeatherValue	Die erwartete Windgeschwindigkeit, gemessen in Kilometern pro Stunde (km/h) oder Meilen pro Stunde (mph), abhängig von der in der Anfrage angegebenen Einheit.

WindDirection

Objekt

Liefert Details zur Windrichtung, einschließlich der Richtung in Azimutgraden und einer lokalisierten Abkürzung der Windrichtung.

Name	Typ	Beschreibung
degrees	integer (int32)	Die Windrichtung wird in Azimutgrad gemessen, beginnend im wahren Norden und im Uhrzeigersinn. Nord entspricht 0 Grad, Osten 90 Grad, Süden 180 Grad und Westen 270 Grad. Mögliche Werte reichen von 0 bis 359 Grad.
localizedDescription	string	Eine lokale Abkürzung der Windrichtung, zurückgegeben in der in der Anfrage angegebenen Sprache. Zum Beispiel `N` für Norden, `E` für Osten, `S` für Süden und `W` für Westen.