Weather - Get Current Conditions
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}
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 |
|
|
format
|
path | True |
Gewünschtes Format der Antwort. Nur |
|
|
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
|
|
|
duration
|
query |
integer (int32) |
Zeitrahmen der zurückgekehrten Wetterbedingungen. Standardmäßig werden die aktuellsten Wetterbedingungen zurückgegeben. Standardwert ist 0. Unterstützte Werte sind:
|
|
|
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 |
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 |
Die Anforderung ist erfolgreich. |
|
| Other Status Codes |
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. Jeder Benutzer, jede Gruppe oder jeder Service-Principal kann über eine integrierte Rolle oder eine benutzerdefinierte Rolle erhalten, die aus einer oder mehreren Berechtigungen besteht, REST-APIs zu Azure Maps.\n\nUm Szenarien zu implementieren, empfehlen wir, Authentifizierungskonzepte anzusehen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung zur Modellierung von Anwendungen über Objekte, die Zugriff auf spezifische APIs und Scopes ermöglichen.\n\n#### Anmerkungen\n* Diese Sicherheitsdefinition re die Verwendung des x-ms-client-id Headers, um anzuzeigen, auf welche Azure Maps Ressource die Anwendung Zugriff bittet. Dies kann über die Maps Management API erworben werden.\n* \nDas Authorization URL ist spezifisch für die Azure Public Cloud-Instanz. Souveräne Clouds verfügen über einzigartige Autorisierungs-URLs und Microsoft Entra ID-Konfigurationen. \n* \nDie Azure rollenbasierte Zugriffskontrolle wird von der Azure Managementebene über Azure Portal, PowerShell, CLI, Azure SDKs oder REST-APIs konfiguriert.\n* \nNutzung der Azure Maps Web SDK ermöglicht die konfigurationsbasierte Einrichtung einer Anwendung für mehrere Anwendungsfälle.\n* Für weitere Informationen zu Microsoft Identity Platform siehe Microsoft Identity Platform Übersicht.
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 gemeinsamer Schlüssel, der bereitgestellt wird, wenn Sie ein Azure Maps Konto im Azure Portal oder mit PowerShell, CLI, Azure SDKs oder REST API erstellen.\n\n Mit diesem Schlüssel kann jede Anwendung auf alle REST-APIs zugreifen. Mit anderen Worten: Dieser Schlüssel kann als Hauptschlüssel in dem Konto verwendet werden, in dem sie ausgegeben werden.\n\n Für öffentlich zugängliche Anwendungen empfehlen wir, den Ansatz confidential Client Applications zu verwenden, um auf Azure Maps REST-APIs zuzugreifen, damit Ihr Schlüssel sicher gespeichert werden kann.
Typ:
apiKey
In:
header
SAS Token
Dies ist ein Shared-Access-Signaturtoken, das aus der List SAS-Operation auf der Azure Maps Ressource über die Azure Managementebene über Azure Portal, PowerShell, CLI, Azure SDKs oder REST-APIs erstellt wird.\n\n Mit diesem Token ist jede Anwendung autorisiert, mit Azure rollenbasierte Zugriffskontrollen und feine Kontrolle über Ablauf, Rate und Nutzungsregion des jeweiligen Tokens. Mit anderen Worten: Der SAS-Token kann verwendet werden, um Anwendungen die Zugriffskontrolle auf sicherere Weise als der gemeinsame Schlüssel zu ermöglichen.\n\n Für öffentlich zugängliche Anwendungen empfehlen wir, eine spezielle Liste erlaubter Ursprünge auf der Map-Konto-Ressource zu konfigurieren, um Rendering-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
GET {endpoint}/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679
Beispiel für eine Antwort
{
"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 |
|---|---|
|
Current |
Aktuelle Wetterdaten. |
|
Current |
Aktuelle Wetterbedingungen sind das Ergebnis. |
|
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
|
Error |
Das Fehlerdetails. |
|
Error |
Übliche Fehlerantwort für alle Azure Resource Manager APIs, um Fehlerdetails bei fehlgeschlagenen Operationen zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.) |
|
Icon |
Numerischer Wert, der ein Bild darstellt, das der aktuellen Wetterbedingung entspricht, die von der |
|
Json |
Gewünschtes Format der Antwort. Nur |
|
Past |
Zusammenfassung der Temperaturschwankungen über die Anzahl der letzten Stunden. |
|
Precipitation |
Zusammenfassung der Niederschlagsmengen. |
|
Pressure |
Tendenz zum atmosphärischen Druck. |
|
Temperature |
Zusammenfassung der Temperaturschwankungen. |
|
Unit |
Eine ganze Zahl, die den Einheitentyp darstellt. Zum Beispiel 17 für Celsius, 18 für Fahrenheit. Kann für die Einheitenumrechnung verwendet werden. Eine vollständige Liste finden Sie unter Weather Services in Azure Maps. |
|
Weather |
Messeinheit für Wetterdaten. |
|
Weather |
Spezifischer Wert einer bestimmten Einheit in Bezug auf das Wetter. |
|
Wind |
Winddaten, die zurückgegeben werden, einschließlich Geschwindigkeit und Richtung. |
|
Wind |
Windrichtung |
CurrentConditions
Aktuelle Wetterdaten.
| Name | Typ | Beschreibung |
|---|---|---|
| apparentTemperature |
Wahrgenommene Außentemperatur, die durch die Kombination von Lufttemperatur, relativer Luftfeuchtigkeit und Windgeschwindigkeit in einer bestimmten Einheit verursacht wird. |
|
| ceiling |
Wolkendecke in angegebener Maßeinheit. Die Decke ist ein Maß für die Höhe der Basis der untersten Wolken. |
|
| cloudCover |
integer (int32) |
Prozentualer Anteil der Wolkenbedeckung. |
| dateTime |
string (date-time) |
Datum und Uhrzeit der aktuellen Beobachtung im ISO-8601-Format angezeigt, zum Beispiel 2019-10-27T19:39:57-08:00. |
| dewPoint |
Die Taupunkttemperatur in der angegebenen Einheit. Die Taupunkttemperatur ist die Temperatur, auf die die Luft abgekühlt werden muss, um die Sättigung zu erreichen. |
|
| hasPrecipitation |
boolean |
Ein boolischer Wert, der angibt, ob Niederschlag (Regen, Schnee, Schneeregen oder Hagel) während des angegebenen Zeitraums erwartet wird. Gibt wahr zurück, wenn Niederschlag erwartet wird, ansonsten falsch. |
| iconCode |
Numerischer Wert, der ein Bild darstellt, das der aktuellen Wetterbedingung entspricht, die von der |
|
| isDayTime |
boolean |
Gibt die Tageszeit an. True steht für 'Tag', false für 'Nacht'. |
| obstructionsToVisibility |
string |
Ursache für eingeschränkte Sicht. Mögliche Werte:
|
| pastTwentyFourHourTemperatureDeparture |
Abweichung von der vor 24 Stunden gemessenen Temperatur in der angegebenen Einheit. |
|
| phrase |
string |
Phrase Beschreibung der aktuellen Wetterbedingungen. Wird in der angegebenen Sprache angezeigt. |
| precipitationSummary |
Zusammenfassung der Niederschlagsmengen der letzten 24 Stunden. |
|
| pressure |
Atmosphärischer Druck in der angegebenen Einheit. |
|
| pressureTendency |
Änderung des atmosphärischen Drucks. |
|
| realFeelTemperature |
Die RealFeel™-Temperatur wird angezeigt. |
|
| realFeelTemperatureShade |
Die RealFeel™-Temperatur wird angezeigt. Beschreibt, wie sich die Temperatur im Schatten wirklich anfühlt. |
|
| relativeHumidity |
integer (int32) |
Die relative Luftfeuchtigkeit ist die Menge an Wasserdampf in der Luft, ausgedrückt als Prozentsatz der Menge, die für die Sättigung bei gleicher Temperatur benötigt wird. |
| temperature |
Die Temperatur wird zurückgegeben. |
|
| temperatureSummary |
Zusammenfassung der Temperaturschwankungen der letzten 6, 12 und 24 Stunden. |
|
| uvIndex |
integer (int32) |
Maß für die Stärke der ultravioletten Strahlung der Sonne. Unterstützte Werte sind:
|
| uvIndexPhrase |
string |
Phrase, die mit . |
| visibility |
Sichtbarkeit in der angegebenen Einheit. Ein Maß für die Entfernung, in der ein Objekt oder Licht deutlich erkannt werden kann. |
|
| wetBulbTemperature |
Die Temperatur, auf die Luft abgekühlt werden kann, indem Wasser bei konstantem Druck in sie eingedampft wird, bis sie die Sättigung erreicht. |
|
| wind |
Winddaten, die zurückgegeben werden, einschließlich Geschwindigkeit und Richtung. |
|
| windChillTemperature |
Wahrgenommene Lufttemperatur auf exponierter Haut aufgrund von Wind. |
|
| windGust |
Windböe. Eine Windböe ist eine plötzliche, kurze Zunahme der Windgeschwindigkeit. |
CurrentConditionsResult
Aktuelle Wetterbedingungen sind das Ergebnis.
| Name | Typ | Beschreibung |
|---|---|---|
| results |
Detaillierte aktuelle Wetterbedingungen. |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
| Name | Typ | Beschreibung |
|---|---|---|
| info |
Die zusätzlichen Informationen. |
|
| type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
| code |
string |
Der Fehlercode. |
| details |
Die Fehlerdetails. |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Fehlerziel. |
ErrorResponse
Ü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 |
Das Fehlerobjekt. |
IconCode
Numerischer Wert, der ein Bild darstellt, das der aktuellen Wetterbedingung entspricht, die von der Phrase Eigenschaft beschrieben wird. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps. Darf NULL sein.
| 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 (Nacht) |
| 37 |
Dunstiges Mondlicht |
| 38 |
Überwiegend bewölkt (Nacht) |
| 39 |
Teilweise bewölkt mit Regenschauern |
| 40 |
Überwiegend bewölkt mit Schauern (Nacht) |
| 41 |
Teilweise bewölkt mit Gewittern |
| 42 |
Überwiegend bewölkt mit Gewittern (Nacht) |
| 43 |
Meist bewölkt mit Gewittern (Nacht) |
| 44 |
Meist bewölkt mit Schnee (Nacht) |
JsonFormat
Gewünschtes Format der Antwort. Nur json Format wird unterstützt.
| Wert | Beschreibung |
|---|---|
| json |
PastHoursTemperature
Zusammenfassung der Temperaturschwankungen über die Anzahl der letzten Stunden.
| Name | Typ | Beschreibung |
|---|---|---|
| maximum |
Maximalwert |
|
| minimum |
minimum |
PrecipitationSummary
Zusammenfassung der Niederschlagsmengen.
| Name | Typ | Beschreibung |
|---|---|---|
| past12Hours |
Die Niederschlagsmenge (flüssiges Äquivalent), die in den letzten 12 Stunden gefallen ist. |
|
| past18Hours |
Die Niederschlagsmenge (flüssiges Äquivalent), die in den letzten 18 Stunden gefallen ist. |
|
| past24Hours |
Die Niederschlagsmenge (flüssiges Äquivalent), die in den letzten 24 Stunden gefallen ist. |
|
| past3Hours |
Die Niederschlagsmenge (flüssiges Äquivalent), die in den letzten drei Stunden gefallen ist. |
|
| past6Hours |
Die Niederschlagsmenge (flüssiges Äquivalent), die in den letzten sechs Stunden gefallen ist. Enthält metrische und britische Werte. |
|
| past9Hours |
Die Niederschlagsmenge (flüssiges Äquivalent), die in den letzten neun Stunden gefallen ist. |
|
| pastHour |
Die Niederschlagsmenge (flüssiges Äquivalent), die in der letzten Stunde gefallen ist. |
PressureTendency
Tendenz zum atmosphärischen Druck.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Code der Drucktendenz, unabhängig von der Sprache. Einer von F = Fallen, S = Stetig, R = Steigend. |
| localizedDescription |
string |
Beschreibung der Drucktendenz in der angegebenen Sprache |
TemperatureSummary
Zusammenfassung der Temperaturschwankungen.
| Name | Typ | Beschreibung |
|---|---|---|
| past12Hours |
Zusammenfassung der Temperaturschwankungen der letzten 12 Stunden. |
|
| past24Hours |
Zusammenfassung der Temperaturschwankungen der letzten 24 Stunden. |
|
| past6Hours |
Zusammenfassung der Temperaturschwankungen der letzten 6 Stunden. |
UnitType
Eine ganze Zahl, die den Einheitentyp darstellt. Zum Beispiel 17 für Celsius, 18 für Fahrenheit. Kann für die Einheitenumrechnung verwendet werden. Eine vollständige Liste finden Sie unter Weather Services 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
Messeinheit für Wetterdaten.
| Wert | Beschreibung |
|---|---|
| imperial |
Geben Sie Daten mit imperialen Einheiten zurück, z. B. Fahrenheit (F) für die Temperatur und Meilen (mi) für die Entfernung. |
| metric |
Geben Sie Daten mit metrischen Einheiten wie Celsius (C) für die Temperatur und Kilometer (km) für die Entfernung zurück. |
WeatherValue
Spezifischer Wert einer bestimmten Einheit in Bezug auf das Wetter.
| Name | Typ | Beschreibung |
|---|---|---|
| unit |
string |
Typ der Einheit für den zurückgegebenen Wert. |
| unitType |
Eine ganze Zahl, die den Einheitentyp darstellt. Zum Beispiel 17 für Celsius, 18 für Fahrenheit. Kann für die Einheitenumrechnung verwendet werden. Eine vollständige Liste finden Sie unter Weather Services in Azure Maps. |
|
| value |
number (float) |
Gerundeter Wert. |
WindDetails
Winddaten, die zurückgegeben werden, einschließlich Geschwindigkeit und Richtung.
| Name | Typ | Beschreibung |
|---|---|---|
| direction |
Windrichtung |
|
| speed |
Windgeschwindigkeit in der angegebenen Einheit. |
WindDirection
Windrichtung
| Name | Typ | Beschreibung |
|---|---|---|
| degrees |
integer (int32) |
Windrichtung in Azimutgrad, beginnend im Norden und weiter im Uhrzeigersinn. Nord ist 0 Grad, Osten ist 90 Grad, Süd ist 180 Grad, West ist 270 Grad. Mögliche Werte 0-359. |
| localizedDescription |
string |
Richtungsabkürzung in der angegebenen Sprache. |