Weather - Get Daily Forecast

Verwenden Sie diese Option, um täglich eine detaillierte Wettervorhersage für die nächsten 1, 5, 10, 15, 25 oder 45 Tage zu erhalten.
Bei der Get Daily Forecast API handelt es sich um eine HTTP-Anforderung GET , die detaillierte Wettervorhersagen wie Temperatur und Wind pro Tag für die nächsten 1, 5, 10, 15, 25 oder 45 Tage für eine bestimmte Koordinatenposition zurückgibt. Die Antwort enthält Details wie Temperatur, Windgeschwindigkeit, Niederschlag, Luftqualität und UV-Index. Weitere Informationen finden Sie unter Anfordern von täglichen Wettervorhersagedaten.

GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}
GET {endpoint}/weather/forecast/daily/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 https://atlas.microsoft.com für die Azure Public Cloud. Um eine bestimmte Azure Maps Geografie oder eine souveräne Cloud anzusprechen, siehe Azure Maps geografischer Umfang.

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)

Gibt an, wie viele Tage die täglichen Prognoseantworten zurückgegeben werden. Verfügbare Werte sind

  • 1 - Geben Sie Vorhersagedaten für den nächsten Tag zurück. Wird standardmäßig zurückgegeben.
  • 5 - Geben Sie Vorhersagedaten für die nächsten 5 Tage zurück.
  • 10 - Geben Sie Vorhersagedaten für die nächsten 10 Tage zurück.
  • 25 - Geben Sie Vorhersagedaten für die nächsten 25 Tage zurück.
  • 45 - Geben Sie Vorhersagedaten für die nächsten 45 Tage zurück.
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

DailyForecastResult

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. 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 URL ist 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 daily weather forecast for a given coordinate location

Beispielanforderung

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5

Beispiel für eine Antwort

{
  "forecasts": [
    {
      "airAndPollen": [
        {
          "name": "AirQuality",
          "type": "Ozone",
          "category": "Good",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Grass",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Mold",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Ragweed",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Tree",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "UVIndex",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        }
      ],
      "date": "2019-11-13T21:00:00-08:00",
      "day": {
        "cloudCover": 100,
        "hasPrecipitation": true,
        "hoursOfIce": 0,
        "hoursOfPrecipitation": 3.5,
        "hoursOfRain": 3.5,
        "hoursOfSnow": 0,
        "ice": {
          "unit": "mm",
          "unitType": 3,
          "value": 0
        },
        "iceProbability": 0,
        "iconCode": 12,
        "iconPhrase": "Showers",
        "longPhrase": "Cloudy with a couple of showers, mainly later",
        "precipitationIntensity": "Light",
        "precipitationProbability": 75,
        "precipitationType": "Rain",
        "rain": {
          "unit": "mm",
          "unitType": 3,
          "value": 6.1
        },
        "rainProbability": 75,
        "shortPhrase": "Cloudy with a few showers",
        "snow": {
          "unit": "cm",
          "unitType": 4,
          "value": 0
        },
        "snowProbability": 40,
        "thunderstormProbability": 20,
        "totalLiquid": {
          "unit": "mm",
          "unitType": 3,
          "value": 6.1
        },
        "wind": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 16.7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 48.2
          }
        }
      },
      "degreeDaySummary": {
        "cooling": {
          "unit": "C",
          "unitType": 17,
          "value": 0
        },
        "heating": {
          "unit": "C",
          "unitType": 17,
          "value": 15
        }
      },
      "hoursOfSun": 1.1,
      "night": {
        "cloudCover": 98,
        "hasPrecipitation": true,
        "hoursOfIce": 0,
        "hoursOfPrecipitation": 2.5,
        "hoursOfRain": 2.5,
        "hoursOfSnow": 0,
        "ice": {
          "unit": "mm",
          "unitType": 3,
          "value": 0
        },
        "iceProbability": 0,
        "iconCode": 12,
        "iconPhrase": "Showers",
        "longPhrase": "Breezy this evening; otherwise, low clouds",
        "precipitationIntensity": "Light",
        "precipitationProbability": 65,
        "precipitationType": "Rain",
        "rain": {
          "unit": "mm",
          "unitType": 3,
          "value": 4
        },
        "rainProbability": 64,
        "shortPhrase": "Breezy early; cloudy",
        "snow": {
          "unit": "cm",
          "unitType": 4,
          "value": 0
        },
        "snowProbability": 40,
        "thunderstormProbability": 0,
        "totalLiquid": {
          "unit": "mm",
          "unitType": 3,
          "value": 4
        },
        "wind": {
          "direction": {
            "degrees": 181,
            "localizedDescription": "S"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 20.4
          }
        },
        "windGust": {
          "direction": {
            "degrees": 170,
            "localizedDescription": "S"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 42.6
          }
        }
      },
      "realFeelTemperature": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 1.3
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": -3.4
        }
      },
      "realFeelTemperatureShade": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 1.6
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": -3.4
        }
      },
      "sources": [
        "AccuWeather"
      ],
      "temperature": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 5.3
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": 0.8
        }
      }
    }
  ],
  "summary": {
    "category": "rain",
    "endDate": "2019-11-17T15:00:00-08:00",
    "phrase": "Rain Sunday evening",
    "severity": 5,
    "startDate": "2019-11-17T09:00:00-08:00"
  }
}

Definitionen

Name Beschreibung
AirAndPollen

Ein Eintrag zur DailyForecast.airAndPollen Beschreibung eines einzelnen Pollen-, Luftqualitäts- oder UV-Index-Indikators für den Tag. Die Eigenschaft name bestimmt, welche Art von Indikator der Eintrag darstellt:

  • Pollen: name ist Baum, Gras, Ambrosia oder Schimmel. value gibt die Prognosemenge an und category / categoryValue bewertet sie von Niedrig nach Hoch.
  • Luftqualität: name ist Luftqualität und type identifiziert den zu messenden Schadstoff (einer von PM2,5, PM10, O3, NO2, SO2 oder CO). category / categoryValue Bewertung der Luftqualität von Gut bis Gefährlich.
  • UV-Index: name ist UVIndex. value ist der UV-Index (0 bis 11+) und category / categoryValue bewertet das Expositionsrisiko von Niedrig bis Extrem.

category ist das qualitative Etikett für den Indikator und categoryValue die entsprechende Bewertung 1-6, wobei 1 die sichersten Bedingungen und 6 die gefährlichsten angibt.

DailyForecast

Die Prognose für einen Kalendertag am angegebenen Ort wurde als ein Eintrag pro Tag im forecasts Array auf DailyForecastResultzurückgegeben. Beinhaltet den Tagesbereich der höchsten und niedrigsten Temperaturen, RealFeel-Bereiche (normal und schattig), erwartete Sonnenstunden, Temperatur-/Abkühl-Tageswerte, eine Vielzahl von Luftqualitäts-, Pollen- und UV-Indexindikatoren sowie separate Detailblöcke für die Tages- und Nachtabschnitte (Niederschlag, Wind, Wolkenbedeckung und mehr). Das Array sources listet die Datenanbieter auf, die zur Prognose beitragen.

DailyForecastDetail

Vorhersagedetails für einen halben Tag. Die gleiche Form wird sowohl für ( DailyForecast.day Sonnenaufgang bis Sonnenuntergang) als DailyForecast.night auch (Sonnenuntergang bis nächster Sonnenaufgang) verwendet, sodass alle Hinweise auf "diese Periode" unten genau diesen speziellen Tages- oder Nachtabschnitt bedeuten – niemals den vollen 24-Stunden-Tag. Enthält ein Vorhersagesymbol und Phrasen, Niederschlagsart / Intensität / Wahrscheinlichkeiten, Ansammlungssummen, Niederschlagsstunden, Wind und Wolkenbedeckung.

DailyForecastResult

Die Antwort wurde von der Get Daily Forecast-Operation zurückgegeben, die eine Tages-für-Tag-Wettervorhersage für einen bestimmten Ort lieferte. Enthält eine oberste Ebene summary , die die dominanten Bedingungen und die Schweregrade des angeforderten Fensters beschreibt, sowie ein forecasts Array mit einem DailyForecast Eintrag pro Tag. Die Anzahl der Einträge entspricht dem gewünschten duration (1, 5, 10, 15, 25 oder 45 Tage; 25 und 45 Tage erfordern eine S1-SKU).

DailyForecastSummary

Eine übergeordnete Zusammenfassung der vorherrschenden Wetterbedingungen über einen Teil oder das gesamte angeforderte Tagesprognosefenster. Das zusammengefasste Zeitfenster kann enger sein als die vollständige Anfrage – zum Beispiel, wenn bedeutendes Wetter (wie ein Sturmsystem) nur für einen Teil des Zeitraums erwartet wird – und wird durch startDate und endDatebegrenzt. Die Bedingungen selbst werden sowohl als Freiform phrase, ein Ein- oder Zweiwort-Label category als auch als numerische severity Bewertung beschrieben.

DegreeDaySummary

Heiz- und Kühltagssummen für einen einzelnen Tag, verwendet zur Schätzung des Energiebedarfs für Heizung oder Kühlung eines Gebäudes. Jeder Wert ist die Anzahl der Grad, um die die Tagesmittlertemperatur von der 65°F (18°C) Basislinie in der in der Anfrage angegebenen Temperatureinheit abweicht – Grade unterhalb der Basislinie tragen zu heating, Grad darüber tragen zu coolingbei.

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

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.

JsonFormat

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

LocalSource

Informationen über einen lokalen Wetterdatenanbieter, der zur Beschaffung der Vorhersage verwendet wird DailyForecastDetail.localSource. Identifiziert den Anbieter (id, name) und stellt den nativen weatherCode Anbieter frei, sodass Anwendungen das eigene Icon-Set des Anbieters anstelle der Standard-Azure Maps-Symbole rendern können.

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.

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.

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

WeatherValueRange

Liefert die höchsten und niedrigsten prognostizierten Temperaturen für den angegebenen Zeitrahmen, gemessen in Grad Celsius (°C) oder Fahrenheit (°F), basierend auf der in der Anfrage 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°.

WindDirection

Liefert Details zur Windrichtung, einschließlich der Richtung in Azimutgraden und einer lokalisierten Abkürzung der Windrichtung.

AirAndPollen

Ein Eintrag zur DailyForecast.airAndPollen Beschreibung eines einzelnen Pollen-, Luftqualitäts- oder UV-Index-Indikators für den Tag. Die Eigenschaft name bestimmt, welche Art von Indikator der Eintrag darstellt:

  • Pollen: name ist Baum, Gras, Ambrosia oder Schimmel. value gibt die Prognosemenge an und category / categoryValue bewertet sie von Niedrig nach Hoch.
  • Luftqualität: name ist Luftqualität und type identifiziert den zu messenden Schadstoff (einer von PM2,5, PM10, O3, NO2, SO2 oder CO). category / categoryValue Bewertung der Luftqualität von Gut bis Gefährlich.
  • UV-Index: name ist UVIndex. value ist der UV-Index (0 bis 11+) und category / categoryValue bewertet das Expositionsrisiko von Niedrig bis Extrem.

category ist das qualitative Etikett für den Indikator und categoryValue die entsprechende Bewertung 1-6, wobei 1 die sichersten Bedingungen und 6 die gefährlichsten angibt.

Name Typ Beschreibung
category

string

Ein kurzes qualitatives Label für den Indikator, zurückgegeben in der in der Anfrage angegebenen Sprache. Mögliche Werte hängen ab von name:

  • Pollen: Niedrig, mäßig, hoch oder sehr hoch.
  • Luftqualität: Gut, mäßig,ungesund für empfindliche Gruppen, ungesund, sehr ungesund oder gefährlich.
  • UV-Index: Niedrig, Mittler, Hoch, Sehr Hoher oder Extrem.
categoryValue

integer (int32)

Eine numerische Bewertung von 1 bis 6, die mit gepaart wird category, wobei 1 die sichersten Bedingungen und 6 die gefährlichsten angibt. Verwenden Sie dies, wenn ein stabiler, sprachunabhängiger numerischer Wert anstelle des lokalisierten category Labels benötigt wird.

name

string

Identifiziert, welchen Indikator dieser Eintrag darstellt. Entweder der Name einer Pollenquelle (Baum, Gras, Ambrosia oder Schimmel),Luftqualität (in diesem Fall type identifiziert man den Schadstoff) oder UVIndex.

type

string

Wann name ist AirQuality, der spezifische Messstoff

  • eines aus PM2,5, PM10, O3 (Ozon), NO2 (Stickstoffdioxid), SO2 (Schwefeldioxid) oder CO (Kohlenmonoxid). Nicht für Pollen- oder UV-Index-Einträge zurückgegeben.
value

integer (int32)

Die numerische Messung für diesen Indikator. Die Einheit hängt ab von name:

  • Für Pollen ist die vorhergesagte Pollenanzahl erforderlich.
  • Für die Luftqualität gilt die Schadstoffkonzentration in Einheiten, die dem Schadstoff entsprechen – typischerweise Mikrogramm pro Kubikmeter (μg/m³) für Partikel und Teile pro Milliarde (ppb) für Gase wie Ozon.
  • Für den UV-Index ein Indexwert von 0 bis 11+.

Sowohl Luftqualität als auch UV-Index sind selbst Indizes, daher werden sie als einheitslose Zahlen angegeben.

DailyForecast

Die Prognose für einen Kalendertag am angegebenen Ort wurde als ein Eintrag pro Tag im forecasts Array auf DailyForecastResultzurückgegeben. Beinhaltet den Tagesbereich der höchsten und niedrigsten Temperaturen, RealFeel-Bereiche (normal und schattig), erwartete Sonnenstunden, Temperatur-/Abkühl-Tageswerte, eine Vielzahl von Luftqualitäts-, Pollen- und UV-Indexindikatoren sowie separate Detailblöcke für die Tages- und Nachtabschnitte (Niederschlag, Wind, Wolkenbedeckung und mehr). Das Array sources listet die Datenanbieter auf, die zur Prognose beitragen.

Name Typ Beschreibung
airAndPollen

AirAndPollen[]

Vorhergesagte Luftqualitäts-, Pollen- und UV-Indexindikatoren für den Tag. Jeder Eintrag gibt einen Namen an (wie Baum, Gras, Ambrosia, Schimmel, Luftqualität oder UVIndex), einen Zahlenwert und einen qualitativen category Wert (wie Niedrig, Mäßig,Hoch, Gut, Ungesund oder Gefährlich), damit Anträge potenzielle Gesundheitsrisiken markieren können.

date

string (date-time)

Das Kalenderdatum, das diese Prognose abdeckt, ist im ISO-8601-Format (yyyy-mm-ddThh:mm:ss-hh:mm). Zum Beispiel 2025-04-29T07:00:00-07:00.

day

DailyForecastDetail

Die detaillierte Prognose für den Tagesteil – einschließlich Temperatur, Niederschlag, Wind, Wolkenbedeckung und weiteren wichtigen Merkmalen.

degreeDaySummary

DegreeDaySummary

Heiz- und Kühltagssummen für den Tag, verwendet zur Schätzung des Energiebedarfs für die Klimaanlage des Gebäudes.

hoursOfSun

number (float)

Die erwartete Anzahl an Sonnenstunden am Tag, nützlich für die Planung von Outdoor-Aktivitäten und die Einschätzung der allgemeinen Tagesbedingungen.

night

DailyForecastDetail

Die detaillierte Prognose für den nächtlichen Tagesabschnitt – einschließlich Temperatur, Niederschlag, Wind, Wolkenbedeckung und weiteren wichtigen Merkmalen.

realFeelTemperature

WeatherValueRange

Die hohen und niedrigen RealFeel-Temperaturwerte™ für den Tag in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der in der Anfrage angegebenen Einheit. Entwickelt von AccuWeather, kombiniert RealFeel Lufttemperatur mit Luftfeuchtigkeit, Wind, Wolkendecke, Sonnenintensität und weiteren Faktoren, um zu zeigen, wie sich das Wetter tatsächlich anfühlt. Weitere Informationen finden Sie unter Wie ist die AccuWeather RealFeel-Temperatur?

realFeelTemperatureShade

WeatherValueRange

Die hohen und niedrigen RealFeel-Temperaturwerte™ für den Tag in schattigen Bereichen in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der in der Anfrage angegebenen Einheit. Wie realFeelTemperature, aber schließt den Erwärmungseffekt direkter Sonnenlichts aus, was ein genaueres Gefühl dafür vermittelt, wie sich das Wetter im Schatten anfühlt.

sources

string[]

Die Datenanbieter, die zur heutigen Prognose beigetragen haben.

temperature

WeatherValueRange

Die vorhergesagten Höchst- und Tieftemperaturen für den Tag in Grad Celsius (°C) oder Fahrenheit (°F), abhängig von der in der Anfrage angegebenen Einheit.

DailyForecastDetail

Vorhersagedetails für einen halben Tag. Die gleiche Form wird sowohl für ( DailyForecast.day Sonnenaufgang bis Sonnenuntergang) als DailyForecast.night auch (Sonnenuntergang bis nächster Sonnenaufgang) verwendet, sodass alle Hinweise auf "diese Periode" unten genau diesen speziellen Tages- oder Nachtabschnitt bedeuten – niemals den vollen 24-Stunden-Tag. Enthält ein Vorhersagesymbol und Phrasen, Niederschlagsart / Intensität / Wahrscheinlichkeiten, Ansammlungssummen, Niederschlagsstunden, Wind und Wolkenbedeckung.

Name Typ Beschreibung
cloudCover

integer (int32)

Der Prozentsatz des Himmels, der in diesem Zeitraum von Wolken bedeckt ist, liegt von 0 (klarer Himmel) bis 100 (vollständig bewölkt). Darf NULL sein.

hasPrecipitation

boolean

true falls in dieser Zeit Niederschlag (Regen, Schnee, Schneeregen oder Hagel) erwartet wird; false andertfalls

hoursOfIce

number (float)

Die Gesamtzahl der Stunden während dieser Periode, in der Eisbildung erwartet wird.

hoursOfPrecipitation

number (float)

Die Gesamtzahl der Stunden in diesem Zeitraum, in denen Niederschlag (Regen, Schnee, Schneeregen oder Hagel) erwartet wird.

hoursOfRain

number (float)

Die Gesamtzahl der Stunden während dieser Periode, in der Regen erwartet wird.

hoursOfSnow

number (float)

Die Gesamtzahl der Stunden in dieser Phase, in der Schnee erwartet wird.

ice

WeatherValue

Die während dieses Zeitraums erwartete Eisansammlung in Millimetern (mm) oder Zoll (in) je nach im Antrag angegebener Einheit.

iceProbability

integer (int32)

Die Wahrscheinlichkeit der Eisbildung in diesem Zeitraum, ausgedrückt als Prozentsatz von 0 bis 100, wobei 0 keine Eischance und 100 die vereisten Bedingungen sicher sind.

iconCode

IconCode

Numerischer Wert, der ein Bild darstellt, das dem vorhergesagten Wetterzustand für diesen Zeitraum entspricht und durch die Eigenschaft iconPhrase beschrieben wird. Der numerische Wert entspricht einem Azure Maps-Wettersymbol – für die vollständige Liste siehe Wetterdienste in Azure Maps. Darf NULL sein.

iconPhrase

string

Eine kurze Phrase, die das Symbol beschreibt und in der in der Anfrage angegebenen Sprache zurückgegeben wird. Zum Beispiel Sunny.

localSource

LocalSource

Informationen über den lokalen Wetterdatenanbieter, dessen Symbolcode und Wettercode für diesen Zeitraum verwendet wurden, als einer ausgewählt wurde.

longPhrase

string

Eine längere, beschreibendere Formulierung für diesen Zeitraum, zurückgegeben in der im Antrag angegebenen Sprache. Azure Maps versucht, diese Phrase unter 100 Zeichen zu halten, aber einige Sprachen oder Wetterereignisse können eine längere Zeichenkette erzeugen.

precipitationIntensity

string

Eine kurze qualitative Beschreibung der Niederschlagsintensität für diesen Zeitraum – zum Beispiel leicht, moderat oder schwer. Zurückgegeben in der in der Anfrage angegebenen Sprache, und nur, wenn hasPrecipitation .true

precipitationProbability

integer (int32)

Die Wahrscheinlichkeit eines Niederschlags in diesem Zeitraum, ausgedrückt als Prozentsatz von 0 bis 100, wobei 0 keine Niederschlagswahrscheinlichkeit und 100 bedeutet, dass Niederschlag sicher ist.

precipitationType

PrecipitationType

Die vorherrschende Niederschlagsart, die in dieser Zeit erwartet wird – Regen, Schnee,Eis oder Mischung. Nur dann zurückgegeben, wenn hasPrecipitation .true

rain

WeatherValue

Die während dieses Zeitraums erwartete Niederschlagsmenge in Millimetern (mm) oder Zoll (in), abhängig von der im Antrag angegebenen Einheit.

rainProbability

integer (int32)

Die Regenwahrscheinlichkeit in diesem Zeitraum, ausgedrückt als Prozentsatz von 0 bis 100, wobei 0 keine Regenwahrscheinlichkeit und 100 Regen sicher ist.

shortPhrase

string

Ein kurzer Satz, der die Prognose für diesen Zeitraum beschreibt, wird in der in der Anfrage angegebenen Sprache zurückgegeben. Azure Maps versucht, diese Phrase unter 30 Zeichen zu halten, aber einige Sprachen oder Wetterereignisse können eine längere Zeichenkette erzeugen.

snow

WeatherValue

Die während dieses Zeitraums erwartete Schneedecke in Zentimetern (cm) oder Zoll (Zoll) je nach im Antrag angegebener Einheit.

snowProbability

integer (int32)

Die Schneewahrscheinlichkeit in diesem Zeitraum, ausgedrückt als Prozentsatz von 0 bis 100, wobei 0 keine Schneewahrscheinlichkeit und 100 bedeutet, dass Schnee sicher ist.

thunderstormProbability

integer (int32)

Die Wahrscheinlichkeit eines Gewitters in diesem Zeitraum, ausgedrückt als Prozentsatz von 0 bis 100, wobei 0 keine Gewitterchance und 100 ein Gewitter sicher ist.

totalLiquid

WeatherValue

Die Gesamtmenge an flüssigem Niederschlag (wie Regen plus das flüssige Äquivalent von Schnee oder Eis), die in diesem Zeitraum erwartet wird, liegt in Millimetern (mm) oder Zoll (in), abhängig von der im Antrag angegebenen Einheit.

wind

WindDetails

Die prognostizierte Windgeschwindigkeit und -richtung für diesen Zeitraum. Die Windgeschwindigkeit entspricht Kilometern pro Stunde (km/h) oder Meilen pro Stunde (mph), abhängig von der in der Anfrage angegebenen Einheit. Die Windrichtung wird in Azimutgrad gemessen, von 0° (wahrer Norden) bis 359°, im Uhrzeigersinn – Ost ist 90°, Süd 180°, Westen 270°.

windGust

WindDetails

Die erwartete maximale Kurzwindgeschwindigkeit und -richtung während dieses Zeitraums. Windböen sind plötzliche, kurze Anstiege der Windgeschwindigkeit, die für Aktivitäten wie Luftfahrt, Segeln und Drachensteigen wichtig sind. Die Geschwindigkeit beträgt in Kilometern pro Stunde (km/h) oder Meilen pro Stunde (mph), abhängig von der in der Anfrage angegebenen Einheit, und die Richtung verwendet dieselbe Azimutkonvention wie wind.

DailyForecastResult

Die Antwort wurde von der Get Daily Forecast-Operation zurückgegeben, die eine Tages-für-Tag-Wettervorhersage für einen bestimmten Ort lieferte. Enthält eine oberste Ebene summary , die die dominanten Bedingungen und die Schweregrade des angeforderten Fensters beschreibt, sowie ein forecasts Array mit einem DailyForecast Eintrag pro Tag. Die Anzahl der Einträge entspricht dem gewünschten duration (1, 5, 10, 15, 25 oder 45 Tage; 25 und 45 Tage erfordern eine S1-SKU).

Name Typ Beschreibung
forecasts

DailyForecast[]

Die Tagesprognosen in chronologischer Reihenfolge mit einem Eintrag pro Tag in der gewünschten duration. Jeder Eintrag zeigt die DailyForecast Tageshöchst- und Tieftemperatur, den RealFeel-Bereich, Sonnenstunden, Temperatur-/Kältegrad-Tageswerte, Luft- und Pollenindizes, separate Tag- und Nacht-Detailblöcke (Niederschlag, Wind, Wolkenbedeckung und mehr) sowie die Datenquellen, die zur Prognose beitragen.

summary

DailyForecastSummary

Eine übergeordnete Zusammenfassung der vorherrschenden Wetterbedingungen über das angeforderte Vorhersagefenster. Die Zusammenfassung kann nur einen Teil des Zeitfensters abdecken

  • Zum Beispiel, wenn während eines Teils davon bedeutendes Wetter (wie ein Sturmsystem) erwartet wird – und nicht während des gesamten Zeitraums.

DailyForecastSummary

Eine übergeordnete Zusammenfassung der vorherrschenden Wetterbedingungen über einen Teil oder das gesamte angeforderte Tagesprognosefenster. Das zusammengefasste Zeitfenster kann enger sein als die vollständige Anfrage – zum Beispiel, wenn bedeutendes Wetter (wie ein Sturmsystem) nur für einen Teil des Zeitraums erwartet wird – und wird durch startDate und endDatebegrenzt. Die Bedingungen selbst werden sowohl als Freiform phrase, ein Ein- oder Zweiwort-Label category als auch als numerische severity Bewertung beschrieben.

Name Typ Beschreibung
category

string

Ein ein- oder zweiwortiges Label, das die dominanten Wetterbedingungen für das zusammengefasste Fenster kategorisiert – zum Beispiel sonnig, teilweise bewölkt, Regen oder Schnee.

endDate

string (date-time)

Das Ende des von dieser Zusammenfassung abgedeckten Fensters ist im RFC 3339-Format – zum Beispiel 2019-10-29T07:00:00-08:00. Kann vor dem Ende des gewünschten Prognosefensters sein, wenn das zusammengefasste Ereignis vor diesem Fenster endet.

phrase

string

Eine kurze, freie Textzusammenfassung der vorherrschenden Wetterbedingungen für das zusammengefasste Fenster, zurückgegeben in der im Antrag angegebenen Sprache. Zum Beispiel können Sie von Dienstag bis Donnerstag mit Schauern rechnen.

severity

integer (int32)

Eine numerische Schweregradbewertung für das zusammengefasste Wetterereignis. Niedrigere Zahlen (ohne 0) zeigen eine höhere Schwere an:

  • 0: Unbekannt
  • 1: Bedeutend
  • 2: Hauptsache
  • 3: Moderat
  • 4: Nebenfach
  • 5: Minimal
  • 6: Unbedeutend
  • 7: Informationsmaterial
startDate

string (date-time)

Der Anfang des in dieser Zusammenfassung abgedeckten Zeitfensters ist im RFC-3339-Format – zum Beispiel 2019-10-27T19:39:57-08:00. Es kann später als der Beginn des gewünschten Prognosefensters sein, wenn das zusammengefasste Ereignis mitten im Fenster beginnt.

DegreeDaySummary

Heiz- und Kühltagssummen für einen einzelnen Tag, verwendet zur Schätzung des Energiebedarfs für Heizung oder Kühlung eines Gebäudes. Jeder Wert ist die Anzahl der Grad, um die die Tagesmittlertemperatur von der 65°F (18°C) Basislinie in der in der Anfrage angegebenen Temperatureinheit abweicht – Grade unterhalb der Basislinie tragen zu heating, Grad darüber tragen zu coolingbei.

Name Typ Beschreibung
cooling

WeatherValue

Abkühlungsgrade Tage (CDD) – die Anzahl der Grad, an denen die Tagesdurchschnittstemperatur über die 18 °C (65°F) hinaussteigt . Höhere Werte deuten auf einen höheren Kühlbedarf hin. Je nach angegebener Einheit in Grad Celsius (°C) oder Fahrenheit (°F).

heating

WeatherValue

Tage mit Heizgrad (HDD) – Die Tagesdurchschnittstemperatur liegt unter die 18°C-Basislinie (65°F). Höhere Werte deuten auf einen höheren Heizbedarf hin. Je nach angegebener Einheit in Grad Celsius (°C) oder Fahrenheit (°F).

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

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

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

ErrorDetail

Das Fehlerobjekt.

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

das JavaScript Object Notation Data Interchange Format

LocalSource

Informationen über einen lokalen Wetterdatenanbieter, der zur Beschaffung der Vorhersage verwendet wird DailyForecastDetail.localSource. Identifiziert den Anbieter (id, name) und stellt den nativen weatherCode Anbieter frei, sodass Anwendungen das eigene Icon-Set des Anbieters anstelle der Standard-Azure Maps-Symbole rendern können.

Name Typ Beschreibung
id

integer (int32)

Eine numerische Kennung, die den lokalen Datenanbieter eindeutig identifiziert.

name

string

Der Name des lokalen Datenanbieters, der in der Anfrage angegebenen Sprache zurückgegeben wird, wenn verfügbar; ansonsten in Englisch oder in der Sprache, in der der Anbieter ihn bereitgestellt hat.

weatherCode

string

Der anbieter-native Wettercode für diese Vorhersage eignet sich für die Abbildung auf das eigene Icon des Anbieters statt auf die Standard-Azure MapsiconCode.

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.

Wert Beschreibung
Ice

Eis

Mix

Mix

Rain

Regen

Snow

Snow

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

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.

WeatherValueRange

Liefert die höchsten und niedrigsten prognostizierten Temperaturen für den angegebenen Zeitrahmen, gemessen in Grad Celsius (°C) oder Fahrenheit (°F), basierend auf der in der Anfrage angegebenen Einheit.

Name Typ Beschreibung
maximum

WeatherValue

Gibt die Höchsttemperatur für den angegebenen Zeitraum an, gemessen in Grad Celsius (°C) oder Fahrenheit (°F), basierend auf der in der Anfrage angegebenen Einheit.

minimum

WeatherValue

Gibt die Mindesttemperatur für den angegebenen Zeitraum an, gemessen in Grad Celsius (°C) oder Fahrenheit (°F), basierend auf der in der Anfrage 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

WindDirection

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

WeatherValue

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 N für Norden, E für Osten, S für Süden und W für Westen.