Weather - Get Hourly Forecast
Verwenden Sie diese Option, um eine detaillierte stündliche Wettervorhersage für bis zu 24 Stunden oder eine tägliche Vorhersage für bis zu 10 Tage zu erhalten.
Bei der Get Hourly Forecast API handelt es sich um eine HTTP-API GET , die eine detaillierte stündliche Wettervorhersage für die nächsten 1, 12, 24 (1 Tag), 72 (3 Tage), 120 (5 Tage) und 240 Stunden (10 Tage) für die angegebene Koordinatenposition anfordert. Die API gibt Details wie Temperatur, Luftfeuchtigkeit, Wind, Niederschlag und UV-Index (Ultraviolett) zurück. Weitere Informationen finden Sie unter Anfordern von stündlichen Wettervorhersagedaten.
GET {endpoint}/weather/forecast/hourly/json?api-version=1.1&query={query}
GET {endpoint}/weather/forecast/hourly/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&language={language}
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Der Hostname des Azure Maps-Dienstes. Verwenden Sie |
|
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. |
|
duration
|
query |
integer (int32) |
Zeitrahmen der zurückgegebenen Wettervorhersage. Standardmäßig werden die Vorhersagedaten für die nächste Stunde zurückgegeben. Verfügbare 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. 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 URList 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 weather forecast by the hour
Beispielanforderung
GET https://atlas.microsoft.com/weather/forecast/hourly/json?api-version=1.1&query=47.632346,-122.138874&duration=12
Beispiel für eine Antwort
{
"forecasts": [
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 3901
},
"cloudCover": 100,
"date": "2019-11-14T16:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 8.4
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": true,
"precipitationProbability": 39,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 39,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 14.1
},
"relativeHumidity": 72,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 13.4
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 10.9
},
"wind": {
"direction": {
"degrees": 311,
"localizedDescription": "NW"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 3.7
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 5.6
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4054
},
"cloudCover": 94,
"date": "2019-11-14T17:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 7.8
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 34,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 34,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 12.8
},
"relativeHumidity": 73,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 12.5
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 10.2
},
"wind": {
"direction": {
"degrees": 281,
"localizedDescription": "W"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 5.6
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 7.4
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4176
},
"cloudCover": 94,
"date": "2019-11-14T18:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 7.4
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 29,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 29,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 11.3
},
"relativeHumidity": 77,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 11.3
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 9.5
},
"wind": {
"direction": {
"degrees": 206,
"localizedDescription": "SSW"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 7.4
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4542
},
"cloudCover": 93,
"date": "2019-11-14T19:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 7
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 20,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 20,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 9.8
},
"relativeHumidity": 79,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 10.4
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.8
},
"wind": {
"direction": {
"degrees": 169,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 7.4
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 11.1
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4389
},
"cloudCover": 92,
"date": "2019-11-14T20:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 6.9
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 20,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 20,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 9.2
},
"relativeHumidity": 80,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 10.1
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.6
},
"wind": {
"direction": {
"degrees": 170,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 11.1
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4481
},
"cloudCover": 91,
"date": "2019-11-14T21:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 7.1
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 20,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 20,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 9
},
"relativeHumidity": 82,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 10.1
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.8
},
"wind": {
"direction": {
"degrees": 170,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4481
},
"cloudCover": 92,
"date": "2019-11-14T22:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 7.2
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 20,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 20,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.5
},
"relativeHumidity": 84,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 9.8
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.6
},
"wind": {
"direction": {
"degrees": 174,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 3688
},
"cloudCover": 94,
"date": "2019-11-14T23:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 7
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 20,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 20,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.5
},
"relativeHumidity": 82,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 9.8
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.5
},
"wind": {
"direction": {
"degrees": 175,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 2926
},
"cloudCover": 97,
"date": "2019-11-15T00:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 6.9
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 20,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 20,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.8
},
"relativeHumidity": 81,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 10.1
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.6
},
"wind": {
"direction": {
"degrees": 176,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 2164
},
"cloudCover": 99,
"date": "2019-11-15T01:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 6.8
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 21,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 21,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.5
},
"relativeHumidity": 81,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 9.9
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.5
},
"wind": {
"direction": {
"degrees": 177,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 1737
},
"cloudCover": 100,
"date": "2019-11-15T02:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 6.8
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 21,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 21,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.5
},
"relativeHumidity": 82,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 9.8
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.4
},
"wind": {
"direction": {
"degrees": 172,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 1311
},
"cloudCover": 100,
"date": "2019-11-15T03:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 6.9
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 26,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 26,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.6
},
"relativeHumidity": 83,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 9.7
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.4
},
"wind": {
"direction": {
"degrees": 161,
"localizedDescription": "SSE"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
}
]
}
Definitionen
| Name | Beschreibung |
|---|---|
|
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.) |
|
Hourly |
Das Objekt |
|
Hourly |
Die Antwort wurde von der Get Hourly Forecast-Operation zurückgegeben, die stundenweise Wettervorhersagen für einen bestimmten Ort enthielt. Die Anzahl der zurückgegebenen |
|
Icon |
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 Für die vollständige Liste der Codes, die zugeordneten Symbole und Beispielbilder siehe Weather Services in Azure Maps. |
|
Json |
Gewünschtes Format der Antwort. Nur |
|
Unit |
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. |
|
Weather |
Spezifiziert, ob Daten in metrischen oder imperialen Einheiten zurückgegeben werden sollen, wobei metrische Einheiten standardmäßig metrisch sind. Beispiel:
|
|
Weather |
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. |
|
Wind |
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°. |
|
Wind |
Liefert Details zur Windrichtung, einschließlich der Richtung in Azimutgraden und einer lokalisierten Abkürzung der Windrichtung. |
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. |
HourlyForecast
Das Objekt HourlyForecast liefert stündliche Wetterinformationen, einschließlich Datum und Uhrzeit, erwarteten und wahrgenommenen Temperaturen sowie Taupunkt. Es behandelt Windgeschwindigkeit und -richtung, Windböen, relative Luftfeuchtigkeit, Sicht und Niederschlagswahrscheinlichkeit. Sie gibt an, ob Niederschlag erwartet wird, und gibt deren Art an. Weitere Eigenschaften sind der UV-Index, der Wolkendeckenprozentsatz und die Höhe der Wolkendecke. Es enthält außerdem einen Symbolcode und eine Phrase, die die Wetterbedingungen beschreiben.
| Name | Typ | Beschreibung |
|---|---|---|
| ceiling |
Die Höhe der untersten Wolkenschicht über dem Boden, gemessen in Fuß oder Metern basierend auf der im Antrag angegebenen Einheit. Diese Messung ist entscheidend für die Luftfahrt und Wettervorhersage. |
|
| cloudCover |
integer (int32) |
Der Prozentsatz des Himmels, der zur vorgegebenen Stunde von Wolken bedeckt ist. Dieser Wert reicht von 0% (klarer Himmel) bis 100% (völlig bewölkt). Darf NULL sein. |
| date |
string (date-time) |
Datum und Uhrzeit der Prognose im RFC 3339-Format (yyyy-mm-ddThh:mm:ss±hh:mm). Zum Beispiel 2019-11-14T16:00:00-08:00. |
| dewPoint |
Die Temperatur, bei der Luft mit Feuchtigkeit gesättigt wird und Tau beginnt. Sie wird je nach angegebener Einheit in Grad Fahrenheit (°F) oder Celsius (°C) gemessen. Dieser Wert ist entscheidend, um die Luftfeuchtigkeit zu verstehen, da ein höherer Taupunkt mehr Feuchtigkeit in der Luft anzeigt und sie feuchter wirken lässt. |
|
| 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. |
| ice |
Gibt die geschätzte Eisansammlung für jede Stunde in der Prognose zurück, gemessen in Millimetern (mm) oder Zoll (Zoll), abhängig von der in der Anfrage angegebenen Einheit. |
|
| iceProbability |
integer (int32) |
Zeigt die Wahrscheinlichkeit der Eisbildung während der angegebenen Stunde, ausgedrückt als Prozentsatz von 0 bis 100. Ein Wert von 0 bedeutet keine Chance auf Eisbildung, während 100 bedeutet, dass die Eisbildung sicher ist. Diese Informationen helfen den Nutzern, das Potenzial für eisige Bedingungen einzuschätzen. |
| iconCode |
Ein numerischer Wert, der einem Bild entspricht, das das zeigt |
|
| iconPhrase |
string |
Ein beschreibender Begriff, der einer bestimmten Wetterbedingung entspricht, wie zum Beispiel Sunny. Es wird mit einem |
| isDaylight |
boolean |
Ein boolescher Wert, der angibt, ob es während der angegebenen Stunde Tageslicht ist. Gibt true zurück, wenn es Tageslicht ist, ansonsten false. |
| precipitationProbability |
integer (int32) |
Zeigt die Niederschlagswahrscheinlichkeit während der angegebenen Stunde, ausgedrückt als Prozentsatz von 0 bis 100. Ein Wert von 0 bedeutet keine Niederschlagschance, während 100 bedeutet, dass der Niederschlag sicher ist. Dies hilft den Nutzern, die Wahrscheinlichkeit von Regen, Schnee oder anderen Niederschlagsformen einzuschätzen. |
| rain |
Gibt die in der Prognose erwartete Niederschlagsmenge für jede Stunde zurück, gemessen in Millimetern (mm) oder Zoll (in), abhängig von der im Antrag angegebenen Einheit. |
|
| rainProbability |
integer (int32) |
Zeigt die Regenwahrscheinlichkeit während des angegebenen Zeitraums, ausgedrückt als Prozentsatz von 0 bis 100. Ein Wert von 0 bedeutet keine Chance auf Regen, während 100 bedeutet, dass Regen sicher ist. |
| realFeelTemperature |
Liefert RealFeel-Temperaturwerte™ für die angegebene Stunde, gemessen in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der in der Anfrage angegebenen Einheit. Diese von AccuWeather entwickelte Metrik berücksichtigt über ein Dutzend Faktoren wie Luftfeuchtigkeit, Windgeschwindigkeit, Wolkenbedeckung und Sonnenintensität, um eine umfassende Kennzahl dafür zu liefern, wie sich das Wetter tatsächlich anfühlt. Weitere Informationen finden Sie unter Wie ist die AccuWeather RealFeel-Temperatur? |
|
| relativeHumidity |
integer (int32) |
Die Menge an Wasserdampf in der Luft, ausgedrückt als Prozentsatz der maximalen Menge, die die Luft bei derselben Temperatur halten kann. Dieser Wert gibt an, wie nah die Luft an der Feuchtigkeitssättigung ist, was beeinflusst, wie angenehm oder feucht sich die Umgebung anfühlt. |
| snow |
Gibt die während der angegebene Stunde erwartete Schneemlumpe zurück, gemessen in Millimetern (mm) oder Zoll (in), abhängig von der im Antrag angegebenen Einheit. |
|
| snowProbability |
integer (int32) |
Zeigt die Schneewahrscheinlichkeit während der angegebenen Stunde, ausgedrückt als Prozentsatz von 0 bis 100. Ein Wert von 0 bedeutet keine Chance auf Schnee, während 100 bedeutet, dass Schnee sicher ist. |
| temperature |
Die erwartete Temperatur für die angegebene Stunde, gemessen in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der im Antrag angegebenen Einheit. |
|
| totalLiquid |
Gibt die Gesamtmenge an flüssigem Niederschlag (wie Regen) zurück, die in jeder Stunde des Vorhersagezeitraums erwartet wird, gemessen in Millimetern (mm) oder Zoll (in), abhängig von der in der Anfrage angegebenen Einheit. |
|
| uvIndex |
integer (int32) |
Gibt für jede Stunde des Prognosezeitraums den Ultraviolettindex (UV) an. Dieser Index zeigt das erwartete Niveau der ultravioletten Strahlung an und hilft den Nutzern, das potenzielle Risiko der Sonnenexposition zu verschiedenen Tageszeiten zu verstehen. Unterstützte Werte sind:
|
| uvIndexPhrase |
string |
Gibt eine beschreibende Phrase an, die das Niveau der UV-Strahlung angibt, wie Niedrig, Mäßig, Hoch oder Sehr Hoch. |
| visibility |
Gibt die Entfernung zurück, in der ein Objekt oder Licht für jede Stunde der Vorhersageperiode klar erkannt werden kann, gemessen in Kilometern (km) oder Meilen (mi), abhängig von der in der Anfrage angegebenen Einheit. Dies zeigt an, wie weit man gut sehen kann, was bei Aktivitäten wie Fahren und Luftfahrt entscheidend ist. |
|
| wetBulbTemperature |
Gibt die Temperatur zurück, die ein Luftpaket hätte, wenn es durch die Verdunstung von Wasser auf Sättigung (100% relative Luftfeuchtigkeit) abgekühlt würde. Diese Eigenschaft ist wichtig für das Verständnis der Wärmebelastung und der Kühlwirkung der Verdunstung. |
|
| wind |
Gibt die erwartete Windgeschwindigkeit und -richtung an. Die Windgeschwindigkeit wird in Kilometern pro Stunde (km/h) oder Meilen pro Stunde (mph) gemessen, basierend auf der angegebenen Einheit. Die Windrichtung wird in Azimut-Grad gemessen, von 0° (wahrer Norden) bis 359° und bewegt sich im Uhrzeigersinn (Ost ist 90°, Süd 180°, Westen 270°). |
|
| windGust |
Gibt die erwartete maximale Windböengeschwindigkeit während jeder Stunde des Prognosezeitraums zurück, gemessen in Kilometern pro Stunde (km/h) oder Meilen pro Stunde (mph), basierend auf der angegebenen Einheit. Die Windrichtung wird in Azimut-Grad angegeben, die von 0° (wahrer Norden) bis 359° reichen, im Uhrzeigersinn. Windböen sind kurze Erhöhungen der Windgeschwindigkeit, was wichtig ist, um kurzfristige Schwankungen zu verstehen, die Aktivitäten wie Luftfahrt, Segeln und Outdoor-Events beeinflussen können. |
HourlyForecastResult
Die Antwort wurde von der Get Hourly Forecast-Operation zurückgegeben, die stundenweise Wettervorhersagen für einen bestimmten Ort enthielt. Die Anzahl der zurückgegebenen HourlyForecast Einträge entspricht der geforderten Prognosedauer – eine von 1, 12, 24, 48, 72 oder 96 Stunden (siehe die HourlyDuration Union).
| Name | Typ | Beschreibung |
|---|---|---|
| forecasts |
Die Stunden-für-Stunde-Prognoseeinträge, eine pro Stunde im gewünschten Fenster, in chronologischer Reihenfolge. Jeder Eintrag enthält die erwartete Temperatur, RealGefühl, Taupunkt, Wind, Niederschlagsprognose (Wahrscheinlichkeit und Mengen für Regen, Schnee und Eis), Wolkenbedeckung, Sicht, UV-Index, Decke und weitere Beobachtungen für diese Stunde. Zum Beispiel gibt eine Dauer von 12 12 Einträgen zurück, die 2019-11-14T16:00:00-08:00 beginnen und jeweils eine Stunde vorwärts gehen. |
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.
| 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
Gewünschtes Format der Antwort. Nur json Format wird unterstützt.
| Wert | Beschreibung |
|---|---|
| json |
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.
| 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
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
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 |
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
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 |
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 |
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
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 |