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 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 |
Gewünschtes Format der Antwort. Nur |
|
|
api-version
|
query | True |
string |
Versionsnummer der Azure Maps-API. |
|
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 |
Zeitrahmen der zurückgekehrten Wetterbedingungen. Standardmäßig werden die aktuellsten Wetterbedingungen zurückgegeben. Der 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 Verwendung mit dem Microsoft Entra ID-Sicherheitsmodell vorgesehen ist. Diese eindeutige ID für das Azure Maps-Konto kann über die Konto-API der Azure Maps-Verwaltungsebene abgerufen werden. Weitere Informationen zur Verwendung der Microsoft Entra ID-Sicherheit in Azure Maps finden Sie unter Verwalten der Authentifizierung in Azure Maps. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
OK |
|
| Other Status Codes |
Ein unerwarteter Fehler ist aufgetreten. |
Sicherheit
AADToken
Dies sind die Microsoft Entra OAuth 2.0 Flows. Bei Kombination mit rollenbasierten Azure-Zugriff Steuern kann es verwendet werden, um den Zugriff auf Azure Maps-REST-APIs zu steuern. Azure-rollenbasierte Zugriffssteuerungen 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.
Notes
- 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 Kartenverwaltung API erworben werden.
Die Authorization URL ist spezifisch für die Öffentliche Azure-Cloudinstanz. Souveräne Clouds verfügen über eindeutige 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 die konfigurationsbasierte Einrichtung 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 | 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:
query
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
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
},
"past3Hours": {
"value": 0.8,
"unit": "mm",
"unitType": 3
},
"past6Hours": {
"value": 0.8,
"unit": "mm",
"unitType": 3
},
"past9Hours": {
"value": 0.8,
"unit": "mm",
"unitType": 3
},
"past12Hours": {
"value": 0.8,
"unit": "mm",
"unitType": 3
},
"past18Hours": {
"value": 0.8,
"unit": "mm",
"unitType": 3
},
"past24Hours": {
"value": 0.8,
"unit": "mm",
"unitType": 3
}
},
"temperatureSummary": {
"past6Hours": {
"minimum": {
"value": 8.3,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 13.7,
"unit": "C",
"unitType": 17
}
},
"past12Hours": {
"minimum": {
"value": 5.9,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 13.7,
"unit": "C",
"unitType": 17
}
},
"past24Hours": {
"minimum": {
"value": 5.9,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 13.7,
"unit": "C",
"unitType": 17
}
}
}
}
]
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Current |
|
|
Current |
|
|
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
|
Error |
Das Fehlerdetails. |
|
Error |
Fehlerantwort |
|
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 |
|
|
Pressure |
|
|
Temperature |
|
|
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 Wetterdienste in Azure Maps. |
|
Weather |
Gibt an, dass die Daten entweder in metrischen Einheiten oder in britischen Einheiten zurückgegeben werden sollen. Der Standardwert ist die Metrik. |
|
Weather |
Spezifischer Wert einer bestimmten Einheit in Bezug auf das Wetter. |
|
Wind |
Winddetails, die zurückgegeben werden, einschließlich Geschwindigkeit und Richtung. |
|
Wind |
Windrichtung |
CurrentConditions
| 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 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 |
Icon |
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 |
RealFeel™ Temperature wird zurückgegeben. |
|
| realFeelTemperatureShade |
RealFeel™ Temperature wird zurückgegeben. 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 |
Winddetails, 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
| Name | Typ | Beschreibung |
|---|---|---|
| results |
Detaillierte aktuelle Wetterbedingungen. |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
| Name | Typ | Beschreibung |
|---|---|---|
| info |
object |
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
Fehlerantwort
| 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. Kann NULL sein.
| Wert | Beschreibung |
|---|---|
| 1 |
Sunny |
| 2 |
Überwiegend sonnig |
| 3 |
Teilweise sonnig |
| 4 |
Zeitweilige Wolken |
| 5 |
Dunstiger Sonnenschein |
| 6 |
Überwiegend bewölkt |
| 7 |
Cloudy |
| 8 |
Trist (bewölkt) |
| 9 | |
| 10 | |
| 11 |
Fog |
| 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 |
Rain |
| 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 |
Ice |
| 25 |
Sleet |
| 26 |
Gefrierender Regen |
| 27 | |
| 28 | |
| 29 |
Regen und Schnee |
| 30 |
Hot |
| 31 |
Cold |
| 32 |
Windy |
| 33 |
Clear |
| 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 |
maximum |
|
| minimum |
minimum |
PrecipitationSummary
| 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
| 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
| 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 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 |
float |
| 22 |
integer |
| 31 |
MicrogramsPerCubicMeterOfAir |
WeatherDataUnit
Gibt an, dass die Daten entweder in metrischen Einheiten oder in britischen Einheiten zurückgegeben werden sollen. Der Standardwert ist die Metrik.
| 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. |
WeatherUnit
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 |
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 Wetterdienste in Azure Maps. |
| value |
number (float) |
Gerundeter Wert. |
WindDetails
Winddetails, 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. |