Weather - Get Minute Forecast

Mit dieser Option erhalten Sie eine minutengenaue Vorhersage für die nächsten 120 Minuten in Intervallen von 1, 5 und 15 Minuten.
Bei der Get Minute Forecast API handelt es sich um eine HTTP-Anforderung GET , die minutengenaue Prognosen für einen bestimmten Standort für die nächsten 120 Minuten zurückgibt. Benutzer können Wettervorhersagen in Intervallen von 1, 5 und 15 Minuten anfordern. Die Antwort enthält Details wie die Art des Niederschlags (einschließlich Regen, Schnee oder eine Mischung aus beidem), die Startzeit und den Wert der Niederschlagsintensität (dBZ). Weitere Informationen finden Sie unter Anfordern von minutengenauen Wettervorhersagedaten.

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

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

URI-Parameter

Anforderungsheader

Antworten

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.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

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 minute-by-minute forecasts for a given location

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query=47.632346,-122.138874&interval=15

{
  "intervalSummaries": [
    {
      "briefPhrase": "Rain ending in %minute_value min",
      "endMinute": 24,
      "iconCode": 12,
      "longPhrase": "Rain ending in %minute_value min",
      "shortPhrase": "Rain ending in %minute_value min",
      "startMinute": 0,
      "totalMinutes": 25
    },
    {
      "briefPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "endMinute": 119,
      "iconCode": 7,
      "longPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "shortPhrase": "No precip for %MINUTE_VALUE min",
      "startMinute": 25,
      "totalMinutes": 95
    }
  ],
  "intervals": [
    {
      "cloudCover": 100,
      "color": {
        "blue": 2,
        "green": 98,
        "hex": "#086202",
        "red": 8
      },
      "dbz": 23,
      "iconCode": 12,
      "minute": 0,
      "precipitationType": "Rain",
      "shortPhrase": "Light Rain",
      "simplifiedColor": {
        "blue": 39,
        "green": 190,
        "hex": "#23BE27",
        "red": 35
      },
      "startTime": "2019-11-14T15:18:00-08:00",
      "threshold": "LIGHT"
    },
    {
      "cloudCover": 100,
      "color": {
        "blue": 9,
        "green": 133,
        "hex": "#208509",
        "red": 32
      },
      "dbz": 18,
      "iconCode": 12,
      "minute": 15,
      "precipitationType": "Rain",
      "shortPhrase": "Light Rain",
      "simplifiedColor": {
        "blue": 39,
        "green": 190,
        "hex": "#23BE27",
        "red": 35
      },
      "startTime": "2019-11-14T15:33:00-08:00",
      "threshold": "LIGHT"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 30,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T15:48:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 45,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:03:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 60,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:18:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 75,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:33:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 90,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:48:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 105,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T17:03:00-08:00"
    }
  ],
  "summary": {
    "briefPhrase": "Rain ending in 25 min",
    "briefPhrase60": "Rain ending in 25 min",
    "iconCode": 12,
    "longPhrase": "Rain ending in 25 min",
    "shortPhrase": "Rain ending in 25 min"
  }
}

Definitionen

ColorValue

Eine RGB-Farbe, die sowohl in Komponentenform (red, green, ) blueals auch hexadezimal (hex) zurückgegeben wird. Wird von der Minute-für-Minute-Vorhersage verwendet, um jedes Intervall auf einer Radar-ähnlichen Anzeige darzustellen – siehe ForecastInterval.color für das Vollspektrum-Farbdisplay, das auf abgebildet istdbz, und ForecastInterval.simplifiedColor für die gröbere Farbe, die aus und thresholdabgeleitet wirdprecipitationType. Für die zugrunde liegenden Farbabbildungen siehe Wetterdienste in Azure Maps.

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

ForecastInterval

Repräsentiert einen einzelnen Zeitschnitt innerhalb einer Minute-für-Minute-Prognose, der die erwarteten Wetterbedingungen in diesem Zeitraum beschreibt. Jedes Intervall umfasst 1, 5 oder 15 Minuten – abhängig von der gewünschten Auflösung – und enthält Startzeit, Niederschlagsintensität (dbz), Niederschlagsart und Schwellewert, eine kurze beschreibende Phrase, einen Symbolcode, Wolkenbedeckung sowie die Vollspektrum- und vereinfachte Farben, die verwendet werden, um die Bedingungen auf einer radarähnlichen Anzeige visuell darzustellen.

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.

IntervalSummary

Beschreibt die Wetterprognosen für ein zusammenhängendes Zeitfenster innerhalb der Minute-für-Minute-Prognose – typischerweise eine Phase ähnlicher Bedingungen, wie Regen, der in 25 Minuten endet , oder leichter Schnee, der in 10 Minuten beginnt. Jede Zusammenfassung gibt das Fenster in Minuten ab dem Beginn der Prognose an (startMinute, endMinute, totalMinutes), bietet Phrasenbeschreibungen in drei Längen (kurz, kurz und lang), sodass der entsprechende Detailgrad für den verfügbaren UI-Bereich angezeigt werden kann, und enthält ein iconCode für das repräsentative Wettersymbol. A liefert MinuteForecastResult einen oder mehrere IntervalSummary Einträge, die zusammen den Prognosezeitraum abdecken.

JsonFormat

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

MinuteForecastResult

Die Antwort wurde durch die Get Minute Forecast-Operation zurückgegeben, die eine Minute-für-Minute-Niederschlagsprognose für einen bestimmten Ort über die nächsten 120 Minuten mit der gewünschten Auflösung (1, 5 oder 15 Minuten) lieferte. Die Antwort ist in drei Schichten gegliedert: eine Gesamtschicht summary mit Phrasenbeschreibungen und einem repräsentativen Symbol für den gesamten Zeitraum; ein intervalSummaries Array, das aufeinanderfolgende Minuten in längere Abschnitte ähnlicher Bedingungen gruppiert (wie Regen, der in 25 Minuten endet); und ein intervals Array mit detaillierten Prognosepunkten pro Minute, einschließlich Niederschlagsintensität (dbz), Niederschlagstyp, Wolkenbedeckung und den Farben zur Darstellung von Radar-ähnlichen Visualisierungen.

MinuteForecastSummary

Bietet Zusammenfassungen, die die Niederschlagsprognose für den kommenden Prognosezeitraum Minute für Minute beschreiben. Mehrere Phrasenlängen sind enthalten – kurz (~25 Zeichen), kurz (~60 Zeichen) und lang (60+ Zeichen) –, damit Anwendungen den Detailgrad anzeigen können, der am besten zum verfügbaren UI-Raum passt. An iconCode kennzeichnet das rezentrative Wettersymbol für die jeweilige Zeit.

PrecipitationType

Gibt die Art des Niederschlags an. Gültige Werte sind Regen, Schnee, Eis oder Mischung. Diese Eigenschaft ist in der Antwort enthalten, wenn dBZ größer als Null ist.