Freigeben über


Weather - Get Current Conditions

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}
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.

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

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

Beispiel für eine Antwort

{
  "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 iconPhraseanzeigt. 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 iconPhraseanzeigt. 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.