Freigeben über


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.

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 https://atlas.microsoft.com/weather/forecast/hourly/json?api-version=1.1&query={query}
GET https://atlas.microsoft.com/weather/forecast/hourly/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&language={language}

URI-Parameter

Name In Erforderlich Typ Beschreibung
format
path True

JsonFormat

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

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.

duration
query

integer

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 an, welches Konto in Verbindung mit dem Microsoft Entra ID-Sicherheitsmodell für die Verwendung vorgesehen ist. Sie stellt eine eindeutige ID für das Azure Maps-Konto dar und kann aus der Azure Maps-Verwaltungsebenen-Konto-API abgerufen werden. Informationen zur Verwendung der Sicherheit von Microsoft Entra-ID in Azure Maps finden Sie in den folgenden Artikeln anleitungen.

Antworten

Name Typ Beschreibung
200 OK

HourlyForecastResult

OKAY

Other Status Codes

ErrorResponse

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.

Hinweise

  • Diese Sicherheitsdefinition erfordert die Verwendung des x-ms-client-id-Headers, um anzugeben, auf welche Azure Maps-Ressource die Anwendung Zugriff anfordert. Dies kann über die 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.

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 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": [
    {
      "date": "2019-11-14T16:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": true,
      "temperature": {
        "value": 13.4,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 14.1,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 10.9,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 8.4,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 311,
          "localizedDescription": "NW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 5.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 72,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 100,
      "ceiling": {
        "value": 3901,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 39,
      "rainProbability": 39,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T17:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 12.5,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 12.8,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 10.2,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 7.8,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 281,
          "localizedDescription": "W"
        },
        "speed": {
          "value": 5.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 7.4,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 73,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 94,
      "ceiling": {
        "value": 4054,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 34,
      "rainProbability": 34,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T18:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 11.3,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 11.3,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 9.5,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 7.4,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 7.4,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 77,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 94,
      "ceiling": {
        "value": 4176,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 29,
      "rainProbability": 29,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T19:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 10.4,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 9.8,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.8,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 7,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 169,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 7.4,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 11.1,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 79,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 93,
      "ceiling": {
        "value": 4542,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 20,
      "rainProbability": 20,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T20:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 10.1,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 9.2,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.6,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 6.9,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 170,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 11.1,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 80,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 92,
      "ceiling": {
        "value": 4389,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 20,
      "rainProbability": 20,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T21:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 10.1,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 9,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.8,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 7.1,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 170,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 82,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 91,
      "ceiling": {
        "value": 4481,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 20,
      "rainProbability": 20,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T22:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 9.8,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 8.5,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.6,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 7.2,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 174,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 84,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 92,
      "ceiling": {
        "value": 4481,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 20,
      "rainProbability": 20,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T23:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 9.8,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 8.5,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.5,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 7,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 175,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 82,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 94,
      "ceiling": {
        "value": 3688,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 20,
      "rainProbability": 20,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-15T00:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 10.1,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 8.8,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.6,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 6.9,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 176,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 81,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 97,
      "ceiling": {
        "value": 2926,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 20,
      "rainProbability": 20,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-15T01:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 9.9,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 8.5,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.5,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 6.8,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 177,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 81,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "ceiling": {
        "value": 2164,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 21,
      "rainProbability": 21,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-15T02:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 9.8,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 8.5,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.4,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 6.8,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 172,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 82,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 100,
      "ceiling": {
        "value": 1737,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 21,
      "rainProbability": 21,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-15T03:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 9.7,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 8.6,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.4,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 6.9,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 161,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 83,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 100,
      "ceiling": {
        "value": 1311,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 26,
      "rainProbability": 26,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    }
  ]
}

Definitionen

Name Beschreibung
ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

HourlyForecast
HourlyForecastResult
IconCode

Numerischer Wert, der ein Bild darstellt, in dem die iconPhrase. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .

JsonFormat

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

UnitType

Numerischer ID-Wert, der dem Typ der angezeigten Einheit zugeordnet ist. Kann für die Einheitenumrechnung verwendet werden. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .

WeatherDataUnit

Gibt an, dass die Daten entweder in metrischen Einheiten oder in britischen Einheiten zurückgegeben werden sollen. Der Standardwert ist die Metrik.

WeatherUnit

Spezifischer Wert einer bestimmten Einheit in Bezug auf das Wetter.

WindDetails

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

WindDirection

Windrichtung

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

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

HourlyForecast

Name Typ Beschreibung
ceiling

WeatherUnit

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.

date

string (date-time)

Datum und Uhrzeit der Vorhersage im ISO 8601-Format, z. B. 2019-10-27T19:39:57-08:00.

dewPoint

WeatherUnit

Die Taupunkttemperatur in der angegebenen Einheit. Die Taupunkttemperatur ist die Temperatur, auf die die Luft abgekühlt werden muss, um die Sättigung zu erreichen.

hasPrecipitation

boolean

Zeigt das Vorhandensein oder Fehlen von Niederschlag an. True gibt das Vorhandensein von Niederschlag an, false gibt das Fehlen von Niederschlag an.

ice

WeatherUnit

Eis

iceProbability

integer (int32)

Prozent, der die Wahrscheinlichkeit von Schnee darstellt. Beispiel: "5".

iconCode

IconCode (int32)

Numerischer Wert, der ein Bild darstellt, in dem die iconPhrase. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .

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

WeatherUnit

Regen

rainProbability

integer (int32)

Prozent, der die Wahrscheinlichkeit von Regen darstellt. Beispiel: "50".

realFeelTemperature

WeatherUnit

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.

snow

WeatherUnit

Schnee

snowProbability

integer (int32)

Prozent, der die Wahrscheinlichkeit von Schnee darstellt. Beispiel: "50".

temperature

WeatherUnit

Die Temperatur wird zurückgegeben.

totalLiquid

WeatherUnit

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

WeatherUnit

Sichtbarkeit in der angegebenen Einheit. Ein Maß für die Entfernung, in der ein Objekt oder Licht deutlich erkannt werden kann.

wetBulbTemperature

WeatherUnit

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

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

Name Typ Beschreibung
forecasts

HourlyForecast[]

Vorhersagedaten für jede zurückgegebene Stunde.

IconCode

Numerischer Wert, der ein Bild darstellt, in dem die iconPhrase. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .

Wert Beschreibung
1

Sonnig

10
11

Nebel

12

Regenschauer

13

Größtenteils bewölkt mit Regenschauern

14

Teilweise sonnig mit Regenschauern

15

Gewitter

16

Größtenteils bewölkt mit Gewittern

17

Teilweise sonnig mit Gewittern

18

Regen

19

Böen

2

Größtenteils sonnig

20

Größtenteils bewölkt mit Böen

21

Teilweise sonnig mit Böen

22

Schnee

23

Größtenteils bewölkt mit Schnee

24

Eis

25

Schneeregen

26

Gefrierender Regen

27
28
29

Regen und Schnee

3

Teilweise sonnig

30

Heiß

31

Kalt

32

Windig

33

Klar

34

Größtenteils klar

35

Teilweise bewölkt

36

Zeitweilige Wolken (Nacht)

37

Nebliges Mondlicht

38

Überwiegend bewölkt (Nacht)

39

Teilweise bewölkt mit Regenschauern

4

Zeitweilig wolkig

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)

5

Sonnenschein mit Schleierwolken

6

Größtenteils bewölkt

7

Trüb

8

Trüb (bedeckt)

9

JsonFormat

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

Wert Beschreibung
json

das JavaScript Object Notation Data Interchange Format

UnitType

Numerischer ID-Wert, der dem Typ der angezeigten Einheit zugeordnet ist. Kann für die Einheitenumrechnung verwendet werden. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .

Wert Beschreibung
0

Fuß

1

Zoll

10

Meterpro Sekunde

11

hektoPascal

12

ZollOfMercury

13

kiloPascal

14

Millibar

15

MillimeterVonQuecksilber

16

Pfundpro Quadratzoll

17

Celsius

18

Fahrenheit

19

Kelvin

2

Meilen

20

Prozent

21

Schweben

22

Integer

3

Millimeter

31

MikrogrammPerCubicMeterOfAir

4

Zentimeter

5

Meter

6

Kilometer

7

Kilometer/Stunde

8

Knoten

9

Meilenpro Stunde

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 in imperialen Einheiten zurück. Einige Beispiele für Einheiten des imperialen Systems sind Fahrenheit und Mile.

metric

Gibt Daten in metrischen Einheiten zurück. Einige Beispieleinheiten für das metrische System sind Celsius und Kilometer.

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

UnitType (int32)

Numerischer ID-Wert, der dem Typ der angezeigten Einheit zugeordnet ist. Kann für die Einheitenumrechnung verwendet werden. Weitere Informationen 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

WindDirection

Windrichtung

speed

WeatherUnit

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.