Weather - Get Hourly Forecast

Dienst:: Maps

API-Version:: 1.1

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.

Wenn Sie den Tarif Gen1 S0 verwenden, können Sie eine stündliche Prognose für die nächsten 1, 12, 24 Stunden (1 Tag) und 72 Stunden (3 Tage) anfordern. Wenn Sie den Tarif Gen1 S1 oder Gen2 verwenden, können Sie auch eine stündliche Prognose für die nächsten 120 (5 Tage) und 240 Stunden (10 Tage) anfordern.

GET {endpoint}/weather/forecast/hourly/json?api-version=1.1&query={query}

Mit optionalen Parametern:

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
format	path	True	JsonFormat	Gewünschtes Format der Antwort. Nur `json` Format wird unterstützt.
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 `1` - Geben Sie Vorhersagedaten für die nächste Stunde zurück. Standardwert. `12` - Gibt die stündliche Vorhersage für die nächsten 12 Stunden zurück. `24` - Geben Sie die stündliche Vorhersage für die nächsten 24 Stunden zurück. `72` - Gibt eine stündliche Vorhersage für die nächsten 72 Stunden (3 Tage) zurück. `120` - Geben Sie die stündliche Vorhersage für die nächsten 120 Stunden (5 Tage) zurück. Nur in der S1-SKU verfügbar. `240` - Geben Sie eine stündliche Prognose für die nächsten 240 Stunden (10 Tage) zurück. Nur in der S1-SKU verfügbar.
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		WeatherDataUnit	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	HourlyForecastResult	Die Anforderung ist erfolgreich.
Other Status Codes	ErrorResponse	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 weather forecast by the hour

Beispielanforderung

HTTP

GET {endpoint}/weather/forecast/hourly/json?api-version=1.1&query=47.632346,-122.138874&duration=12

Beispiel für eine Antwort

Statuscode:: 200

{
  "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
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Übliche Fehlerantwort für alle Azure Resource Manager APIs, um Fehlerdetails bei fehlgeschlagenen Operationen zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)
HourlyForecast	Stundenliche Wettervorhersagedaten.
HourlyForecastResult	Ergebnis, stündliche Wettervorhersage.
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.
JsonFormat	Gewünschtes Format der Antwort. Nur `json` Format wird unterstützt.
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.
WeatherDataUnit	Messeinheit für Wetterdaten.
WeatherValue	Spezifischer Wert einer bestimmten Einheit in Bezug auf das Wetter.
WindDetails	Winddaten, die zurückgegeben werden, einschließlich Geschwindigkeit und Richtung.
WindDirection	Windrichtung

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info		Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

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

ErrorResponse

Objekt

Ü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	ErrorDetail	Das Fehlerobjekt.

HourlyForecast

Objekt

Stundenliche Wettervorhersagedaten.

Name	Typ	Beschreibung
ceiling	WeatherValue	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.
date	string (date-time)	Datum und Uhrzeit der Prognose im ISO-8601-Format , zum Beispiel 2019-10-27T19:39:57-08:00.
dewPoint	WeatherValue	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.
ice	WeatherValue	Eis
iceProbability	integer (int32)	Prozent, der die Wahrscheinlichkeit von Schnee darstellt. Beispiel: "5".
iconCode	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.
iconPhrase	string	Phrasenbeschreibung des Wettersymbols.
isDaylight	boolean	Gibt an, ob es sich um Tageslicht handelt. True gibt Tageslicht an.
precipitationProbability	integer (int32)	Prozent, der die Wahrscheinlichkeit von Niederschlag darstellt. Beispiel: "20".
rain	WeatherValue	Regen
rainProbability	integer (int32)	Prozent, der die Wahrscheinlichkeit von Regen darstellt. Beispiel: "50".
realFeelTemperature	WeatherValue	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.
snow	WeatherValue	Snow
snowProbability	integer (int32)	Prozent, der die Wahrscheinlichkeit von Schnee darstellt. Beispiel: "50".
temperature	WeatherValue	Die Temperatur wird zurückgegeben.
totalLiquid	WeatherValue	Gesamtes flüssiges Äquivalent des Niederschlags im Prognosezeitraum.
uvIndex	integer (int32)	Maß für die Stärke der ultravioletten Strahlung der Sonne. Unterstützte Werte sind: `0-2` - Geringe Gefahr durch die UV-Strahlen der Sonne oder den Durchschnittsbürger. `3-5` - Mäßiges Risiko 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+` - Extremes Risiko von Schäden durch ungeschützte Sonneneinstrahlung.
uvIndexPhrase	string	Phrase, die mit .`uvIndex`
visibility	WeatherValue	Sichtbarkeit in der angegebenen Einheit. Ein Maß für die Entfernung, in der ein Objekt oder Licht deutlich erkannt werden kann.
wetBulbTemperature	WeatherValue	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	Winddaten, die zurückgegeben werden, einschließlich Geschwindigkeit und Richtung.
windGust	WindDetails	Windböe. Eine Windböe ist eine plötzliche, kurze Zunahme der Windgeschwindigkeit.

HourlyForecastResult

Objekt

Ergebnis, stündliche Wettervorhersage.

Name	Typ	Beschreibung
forecasts	HourlyForecast[]	Vorhersagedaten für jede zurückgegebene Stunde.

IconCode

Enumeration

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

Enumeration

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

Wert	Beschreibung
json	das JavaScript Object Notation Data Interchange Format

UnitType

Enumeration

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

Enumeration

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

Objekt

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

Objekt

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

Name	Typ	Beschreibung
direction	WindDirection	Windrichtung
speed	WeatherValue	Windgeschwindigkeit in der angegebenen Einheit.

WindDirection

Objekt

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.

Freigeben über

Weather - Get Hourly Forecast

URI-Parameter

Anforderungsheader

Antworten

Sicherheit

AadToken

Bereiche

subscription-key

SAS Token

Beispiele

Successfully retrieve detailed weather forecast by the hour

Beispielanforderung

Beispiel für eine Antwort

Definitionen

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HourlyForecast

HourlyForecastResult

IconCode

JsonFormat

UnitType

WeatherDataUnit

WeatherValue

WindDetails

WindDirection