Weather - Get Current Conditions

Referenz

Dienst:: Maps

API-Version:: 1.1

Verwenden Sie , um die aktuellen Wetterbedingungen abzurufen.

Die Get Current Conditions API ist eine HTTP-Anforderung GET , die detaillierte aktuelle Wetterbedingungen wie Niederschlag, Temperatur und Wind für einen bestimmten Koordinatenstandort zurückgibt. Außerdem können die beobachteten Daten für die letzten 6 oder 24 Stunden für einen bestimmten Standort abgerufen werden. Die grundlegenden Informationen, die mit Der Antwort zurückgegeben werden, umfassen Details wie Datum und Uhrzeit der Beobachtung, kurze Beschreibung der Wetterbedingungen, Wettersymbol, Niederschlagsindikatorflags und Temperatur. Weitere Details, wie z. B. RealFeel™-Temperatur und UV-Index, werden ebenfalls zurückgegeben. Weitere Informationen finden Sie unter Anfordern von Echtzeitwetterdaten.

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}

Mit optionalen Parametern:

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&duration={duration}&language={language}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
format	path	True	JsonFormat	Das gewünschte Format der Antwort. Nur das `json`-Format wird unterstützt.
api-version	query	True	string	Versionsnummer der Azure Maps API.
query	query	True	number[]	Die entsprechende Abfrage, die als durch Trennzeichen getrennte Zeichenfolge angegeben ist, die nach Breitengrad gefolgt von Längengrad besteht, z. B. "47.641268,-122.125679".
details	query		string	Geben Sie vollständige Details für die aktuellen Bedingungen zurück. Verfügbare Werte sind: `true` – Gibt vollständige Details zurück. Standardmäßig werden alle Details zurückgegeben. `false` : Gibt eine abgeschnittene Version der aktuellen Bedingungsdaten zurück, die Beobachtungsdatumszeit, Wetterausdruck, Symbolcode, Niederschlagsindikatorflag und Temperatur umfasst.
duration	query		integer	Zeitrahmen der zurückgegebenen Wetterbedingungen. Standardmäßig werden die aktuellsten Wetterbedingungen zurückgegeben. Der Standardwert ist 0. Diese Werte werden unterstützt: `0` – Gibt die aktuellen Wetterbedingungen zurück. `6` - Zurückgeben der Wetterbedingungen der letzten 6 Stunden. `24` - Zurückgeben der Wetterbedingungen der letzten 24 Stunden.
language	query		string	Sprache, in der Suchergebnisse zurückgegeben werden sollen. Sollte eines der unterstützten IETF-Sprachtags sein, wobei die Groß-/Kleinschreibung nicht beachtet wird. 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ützte Sprachen .
unit	query		WeatherDataUnit	Gibt an, dass die Daten entweder in Metrikeinheiten oder in imperialen Einheiten zurückgegeben werden sollen. Der Standardwert ist metrik.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
x-ms-client-id		string	Gibt an, welches Konto für die Verwendung in Verbindung mit dem Microsoft Entra ID-Sicherheitsmodell vorgesehen ist. Sie stellt eine eindeutige ID für das Azure Maps-Konto dar und kann von der Konto-API der Azure Maps-Verwaltungsebene abgerufen werden. Informationen zur Verwendung der Microsoft Entra ID-Sicherheit in Azure Maps finden Sie in den folgenden Artikeln .

Antworten

Name	Typ	Beschreibung
200 OK	CurrentConditionsResult	OK
Other Status Codes	ErrorResponse	Ein unerwarteter Fehler ist aufgetreten.

Sicherheit

AADToken

Dies sind die Microsoft Entra OAuth 2.0-Flows . In Kombination mit der rollenbasierten Zugriffssteuerung von Azure kann sie verwendet werden, um den Zugriff auf Azure Maps-REST-APIs zu steuern. Rollenbasierte Zugriffssteuerungen in Azure werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps-Ressourcenkonten oder -Unterressourcen festzulegen. Jedem Benutzer, jeder Gruppe oder einem Dienstprinzipal kann Zugriff über eine integrierte Rolle oder eine benutzerdefinierte Rolle gewährt werden, die aus einer oder mehreren Berechtigungen für Azure Maps-REST-APIs besteht.

Zur Implementierung von Szenarien wird empfohlen, Authentifizierungskonzepte anzuzeigen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung zum Modellieren von Anwendungen über Objekte, die die Zugriffssteuerung für bestimmte APIs und Bereiche ermöglichen.

Hinweise

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 Kartenverwaltungs-API abgerufen werden.

Ist Authorization URL spezifisch für die öffentliche Azure-Cloudinstanz. Sovereign Clouds verfügen über eindeutige Autorisierungs-URLs und Microsoft Entra ID-Konfigurationen. * Die rollenbasierte Zugriffssteuerung von Azure wird über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, die CLI, Azure SDKs oder REST-APIs konfiguriert. * Die Verwendung des Azure Maps Web SDK ermöglicht die konfigurationsbasierte Einrichtung einer Anwendung für mehrere Anwendungsfälle.

Weitere Informationen zu Microsoft Identity Platform finden Sie unter Übersicht über Microsoft Identity Platform.

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

Bereiche

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

subscription-key

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

Mit diesem Schlüssel kann jede Anwendung auf die gesamte REST-API zugreifen. Anders ausgedrückt: Dieser Schlüssel kann als Hauptschlüssel in dem Konto verwendet werden, in dem er ausgestellt wird.

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

Typ: apiKey
In: query

SAS Token

Dies ist ein Shared Access Signature-Token, das aus dem SAS-Listenvorgang für die Azure Maps-Ressource über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, die CLI, Azure SDKs oder REST-APIs erstellt wird.

Mit diesem Token ist jede Anwendung für den Zugriff mit rollenbasierten Azure-Zugriffssteuerungen und einer präzisen Steuerung des Ablaufs, der Rate und der Regionen für das jeweilige Token autorisiert. Anders ausgedrückt: Das SAS-Token kann verwendet werden, um Anwendungen die Steuerung des Zugriffs auf eine sicherere Weise zu ermöglichen als der gemeinsam genutzte Schlüssel.

Für öffentlich verfügbar gemachte Anwendungen wird empfohlen, eine bestimmte Liste der zulässigen Ursprünge in der Ressource "Konto zuordnen " zu konfigurieren, um den Renderingmissbrauch 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": [
    {
      "dateTime": "2019-11-14T15:08:00-08:00",
      "phrase": "Cloudy",
      "iconCode": 7,
      "hasPrecipitation": false,
      "isDayTime": true,
      "temperature": {
        "value": 13.7,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperatureShade": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 75,
      "dewPoint": {
        "value": 9.2,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "value": 3.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 4.9,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "obstructionsToVisibility": "",
      "cloudCover": 95,
      "ceiling": {
        "value": 4359,
        "unit": "m",
        "unitType": 5
      },
      "pressure": {
        "value": 1014.9,
        "unit": "mb",
        "unitType": 14
      },
      "pressureTendency": {
        "localizedDescription": "Steady",
        "code": "S"
      },
      "pastTwentyFourHourTemperatureDeparture": {
        "value": 1.8,
        "unit": "C",
        "unitType": 17
      },
      "apparentTemperature": {
        "value": 16.1,
        "unit": "C",
        "unitType": 17
      },
      "windChillTemperature": {
        "value": 13.9,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 11.4,
        "unit": "C",
        "unitType": 17
      },
      "precipitationSummary": {
        "pastHour": {
          "value": 0.5,
          "unit": "mm",
          "unitType": 3
        },
        "pastThreeHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastSixHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastNineHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwelveHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastEighteenHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwentyFourHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        }
      },
      "temperatureSummary": {
        "pastSixHours": {
          "minimum": {
            "value": 8.3,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwelveHours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwentyFourHours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        }
      }
    }
  ]
}

Definitionen

Name	Beschreibung
CurrentConditions
CurrentConditionsResult
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
IconCode	Numerischer Wert, der ein Bild darstellt, das das `iconPhrase`anzeigt. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .
JsonFormat	Gewünschtes Format der Antwort. Nur das `json`-Format wird unterstützt.
PastHoursTemperature	Zusammenfassung der Temperaturschwankungen über die Anzahl der vergangenen Stunden.
PrecipitationSummary
PressureTendency
TemperatureSummary
UnitType	Numerischer ID-Wert, der dem Typ der angezeigten Einheit zugeordnet ist. Kann für die Einheitsübersetzung verwendet werden. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .
WeatherDataUnit	Gibt an, dass die Daten entweder in Metrikeinheiten oder imperialen Einheiten zurückgegeben werden sollen. Der Standardwert ist Metrik.
WeatherUnit	Spezifischer Wert einer bestimmten Einheit im Zusammenhang mit dem Wetter.
WindDetails	Winddetails, die zurückgegeben werden, einschließlich Geschwindigkeit und Richtung.
WindDirection	Windrichtung

CurrentConditions

Name	Typ	Beschreibung
apparentTemperature	WeatherUnit	Wahrgenommene Außentemperatur, die durch die Kombination von Lufttemperatur, relativer Luftfeuchtigkeit und Windgeschwindigkeit in der angegebenen Einheit verursacht wird.
ceiling	WeatherUnit	Wolkendecke in der angegebenen Einheit. Die Decke ist ein Maß für die Höhe der Basis der niedrigsten Wolken.
cloudCover	integer	Prozentsatz, der die Cloudabdeckung darstellt.
dateTime	string	Datum und Uhrzeit der aktuellen Beobachtung im ISO 8601-Format, z. B. 2019-10-27T19:39:57-08:00.
dewPoint	WeatherUnit	Die Taupunkttemperatur in der angegebenen Einheit. Die Taupunkttemperatur ist die Temperatur, auf die die Luft gekühlt werden muss, um die Sättigung zu erreichen.
hasPrecipitation	boolean	Gibt das Vorhandensein oder Fehlen von Niederschlag an. True gibt das Vorhandensein von Niederschlag an, false gibt an, dass keine Niederschlagsmenge vorhanden ist.
iconCode	IconCode	Numerischer Wert, der ein Bild darstellt, das das `iconPhrase`anzeigt. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .
isDayTime	boolean	Gibt die Uhrzeit des Tages an. True gibt "Tag" an, "false" bedeutet "Nacht".
obstructionsToVisibility	string	Ursache für eingeschränkte Sichtbarkeit. Mögliche Werte: A = schweres Gewitter/Hagel BD = Staubblasen BN = Blasender Sand BS = Schneeblasen D = Staub F = Nebel GF = Bodennebel HZ = Dunst 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 = Schneegranulat SP = Schneepellets SW = Schneeschauer T = Gewitter UP = undefinierte Ausscheidung ZL = gefrierender Nieselregen ZR = Eisiger Regen + = schwer - = Licht
pastTwentyFourHourTemperatureDeparture	WeatherUnit	Abkehr von der Temperatur, die vor 24 Stunden in der angegebenen Einheit beobachtet wurde.
phrase	string	Ausdrucksbeschreibung der aktuellen Wetterlage. Wird in der angegebenen Sprache angezeigt.
precipitationSummary	PrecipitationSummary	Zusammenfassung der Niederschlagsmengen der letzten 24 Stunden.
pressure	WeatherUnit	Atmosphärischer Druck in der angegebenen Einheit.
pressureTendency	PressureTendency	Atmosphärische Druckänderung.
realFeelTemperature	WeatherUnit	RealFeel™ Temperature wird zurückgegeben.
realFeelTemperatureShade	WeatherUnit	RealFeel™ Temperature wird zurückgegeben. Beschreibt, wie sich die Temperatur im Schatten wirklich anfühlt.
relativeHumidity	integer	Relative Luftfeuchtigkeit ist die Menge an Wasserdampf, die in der Luft vorhanden ist, ausgedrückt als Prozentsatz der Menge, die für die Sättigung bei der gleichen Temperatur benötigt wird.
temperature	WeatherUnit	Zurückgegebene Temperatur.
temperatureSummary	TemperatureSummary	Zusammenfassung der Temperaturschwankungen in den letzten 6, 12 und 24 Stunden.
uvIndex	integer	Maß für die Stärke der ultravioletten Strahlung der Sonne. Diese Werte werden unterstützt: `0-2` - Geringe Gefahr durch die UV-Strahlen der Sonne oder die durchschnittliche Person. `3-5` - Moderate Gefahr von Schäden durch ungeschützte Sonneneinstrahlung. `6-7` - Hohes Risiko von Schäden durch ungeschützte Sonneneinstrahlung. `8-10` - Sehr hohes Risiko von Schäden durch ungeschützte Sonneneinstrahlung. `11+` - Extreme Gefahr von Schäden durch ungeschützte Sonneneinstrahlung.
uvIndexPhrase	string	Ausdruck, der dem zugeordnet ist `uvIndex`.
visibility	WeatherUnit	Sichtbarkeit in der angegebenen Einheit. Ein Maß für die Entfernung, in der ein Objekt oder Licht klar erkennbar ist.
wetBulbTemperature	WeatherUnit	Die Temperatur, auf die Luft abgekühlt werden kann, indem Wasser mit konstantem Druck in sie eingedampft wird, bis es die Sättigung erreicht.
wind	WindDetails	Winddetails, die zurückgegeben werden, einschließlich Geschwindigkeit und Richtung.
windChillTemperature	WeatherUnit	Wahrgenommene Lufttemperatur auf der exponierten Haut durch Wind.
windGust	WindDetails	Windböe. Windböe ist ein plötzlicher, kurzer Anstieg der Windgeschwindigkeit.

CurrentConditionsResult

Name	Typ	Beschreibung
results	CurrentConditions[]	Detaillierte aktuelle Wetterbedingungen.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

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

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

IconCode

Numerischer Wert, der ein Bild darstellt, das das iconPhraseanzeigt. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .

Name	Typ	Beschreibung
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
23	Integer
24	Integer
25	Integer
26	Integer
27	Integer
28	Integer
29	Integer
3	Integer
30	Integer
31	Integer
32	Integer
33	Integer
34	Integer
35	Integer
36	Integer
37	Integer
38	Integer
39	Integer
4	Integer
40	Integer
41	Integer
42	Integer
43	Integer
44	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

JsonFormat

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

Name	Typ	Beschreibung
json	string	Das Datenaustauschformat der JavaScript-Objektnotation

PastHoursTemperature

Zusammenfassung der Temperaturschwankungen über die Anzahl der vergangenen Stunden.

Name	Typ	Beschreibung
maximum	WeatherUnit	maximum
minimum	WeatherUnit	minimum

PrecipitationSummary

Name	Typ	Beschreibung
pastEighteenHours	WeatherUnit	Die Menge an Niederschlag (flüssiges Äquivalent), die in den letzten 18 Stunden gefallen ist.
pastHour	WeatherUnit	Die Niederschlagsmenge (flüssiges Äquivalent), die in der letzten Stunde gefallen ist.
pastNineHours	WeatherUnit	Die Niederschlagsmenge (flüssiges Äquivalent), die in den letzten neun Stunden gefallen ist.
pastSixHours	WeatherUnit	Die Menge der Niederschlagsmenge (flüssiges Äquivalent), die in den letzten sechs Stunden gefallen ist. Enthält Metrik- und Imperialwerte.
pastThreeHours	WeatherUnit	Die Niederschlagsmenge (flüssiges Äquivalent), die in den letzten drei Stunden gefallen ist.
pastTwelveHours	WeatherUnit	Die Menge der Niederschlagsmenge (flüssiges Äquivalent), die in den letzten 12 Stunden gefallen ist.
pastTwentyFourHours	WeatherUnit	Die Menge an Niederschlag (flüssiges Äquivalent), die in den letzten 24 Stunden gefallen ist.

PressureTendency

Name	Typ	Beschreibung
code	string	Drucktendenzcode unabhängig von der Sprache. Einer von F=Falling, S=Steady, R=Rising.
localizedDescription	string	Beschreibung der Drucktendenz in der angegebenen Sprache

TemperatureSummary

Name	Typ	Beschreibung
pastSixHours	PastHoursTemperature	Zusammenfassung der Temperaturschwankungen der letzten 6 Stunden.
pastTwelveHours	PastHoursTemperature	Zusammenfassung der Temperaturschwankungen in den letzten 12 Stunden.
pastTwentyFourHours	PastHoursTemperature	Zusammenfassung der Temperaturschwankungen der letzten 24 Stunden.

UnitType

Numerischer ID-Wert, der dem Typ der angezeigten Einheit zugeordnet ist. Kann für die Einheitsübersetzung verwendet werden. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .

Name	Typ	Beschreibung
0	Integer
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
3	Integer
31	Integer
4	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

WeatherDataUnit

Gibt an, dass die Daten entweder in Metrikeinheiten oder imperialen Einheiten zurückgegeben werden sollen. Der Standardwert ist Metrik.

Name	Typ	Beschreibung
imperial	string	Gibt Daten in imperialen Einheiten zurück. Einige Beispieleinheiten des imperialen Systems sind Fahrenheit und Meile.
metric	string	Gibt Daten in Metrikeinheiten zurück. Einige Beispieleinheiten des Metriksystems sind Celsius und Kilometer.

WeatherUnit

Spezifischer Wert einer bestimmten Einheit im Zusammenhang mit dem Wetter.

Name	Typ	Beschreibung
unit	string	Einheitstyp für den zurückgegebenen Wert.
unitType	UnitType	Numerischer ID-Wert, der dem Typ der angezeigten Einheit zugeordnet ist. Kann für die Einheitsübersetzung verwendet werden. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .
value	number	Gerundeter Wert.

WindDetails

Winddetails, die zurückgegeben werden, einschließlich Geschwindigkeit und Richtung.

Name	Typ	Beschreibung
direction	WindDirection	Windrichtung
speed	WeatherUnit	Geschwindigkeit des Windes in der angegebenen Einheit.

WindDirection

Windrichtung

Name	Typ	Beschreibung
degrees	integer	Windrichtung in Azimut Grad, beginnend bei wahrer Nord und weiter im Uhrzeigersinn. Norden ist 0 Grad, Osten 90 Grad, Süden 180 Grad, West ist 270 Grad. Mögliche Werte 0-359.
localizedDescription	string	Richtungskürzel in der angegebenen Sprache.

Freigeben über