Weather - Get Daily Forecast

Dienst:: Maps

API-Version:: 1.1

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.

Wenn Sie den Tarif Gen1 S0 verwenden, können Sie eine tägliche Prognose für die nächsten 1, 5, 10 und 15 Tage anfordern. Wenn Sie den Tarif Gen1 S1 oder Gen2 verwenden, können Sie auch eine tägliche Prognose für die nächsten 25 Tage und 45 Tage anfordern.

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

Mit optionalen Parametern:

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
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. Nur in der S1-SKU verfügbar. `45` - Geben Sie Vorhersagedaten für die nächsten 45 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	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. 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 daily weather forecast for a given coordinate location

Beispielanforderung

HTTP

GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5

Beispiel für eine Antwort

Statuscode:: 200

{
  "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	Das AirAndPollen-Objekt liefert umfassende Umweltdaten. Es identifiziert verschiedene Pollentypen wie Baum, Gras, Ambrosia und Schimmel sowie Schadstoffe wie PM2.5, PM10, O3, NO2, SO2 und CO. Zusätzlich berichtet er den UV-Index auf einer Skala von 1 bis 10, bietet qualitative Beschreibungen der Luftqualität oder der Pollenwerte an und liefert numerische Messungen der Konzentration von Schadstoffen oder Pollen in der Luft. Diese detaillierten Informationen helfen den Nutzern, die Luftqualität und die Pollenbedingungen entlang ihrer Reiseroute zu beurteilen.
DailyForecast	Bietet detaillierte Wetterinformationen für einen bestimmten Tag, wie Temperatur, Wind, Niederschlag, Luftqualität und UV-Index.
DailyForecastDetail	Detaillierte Wettervorhersage für einen Teil des Tages.
DailyForecastResult	Tägliche Wettervorhersage.
DailyForecastSummary	Zusammenfassung der wichtigsten Bedingungen für den beantragten Zeitraum. Beachten Sie, dass die Zusammenfassung nur einen Teil des Zeitraums abdecken kann.
DegreeDaySummary	Zusammenfassung der Tage mit Heiz- und Abkühlgrad.
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	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.
LocalSource	Informationen zum lokalen Wetterdatenanbieter.
PrecipitationType	Gibt die Art des Niederschlags an. Gültige Werte sind "Rain", "Snow", "Ice" oder "Mix". Diese Eigenschaft ist in der Antwort enthalten, wenn dBZ größer als Null ist.
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.
WeatherValueRange	Zurückgegebene Temperaturwerte.
WindDetails	Winddaten, die zurückgegeben werden, einschließlich Geschwindigkeit und Richtung.
WindDirection	Windrichtung

AirAndPollen

Objekt

Das AirAndPollen-Objekt liefert umfassende Umweltdaten. Es identifiziert verschiedene Pollentypen wie Baum, Gras, Ambrosia und Schimmel sowie Schadstoffe wie PM2.5, PM10, O3, NO2, SO2 und CO. Zusätzlich berichtet er den UV-Index auf einer Skala von 1 bis 10, bietet qualitative Beschreibungen der Luftqualität oder der Pollenwerte an und liefert numerische Messungen der Konzentration von Schadstoffen oder Pollen in der Luft. Diese detaillierten Informationen helfen den Nutzern, die Luftqualität und die Pollenbedingungen entlang ihrer Reiseroute zu beurteilen.

Name	Typ	Beschreibung
category	string	Bietet eine einwortige qualitative Beschreibung der Luftqualität oder des Pollengehalts für den Prognosezeitraum in der angegebenen Sprache. Diese Eigenschaft kategorisiert die Luftqualität oder den Pollengehalt in verschiedene Stufen, wie niedrig, hoch, gut, mittelmäßig, ungesund, gefährlich, und bietet den Nutzern eine leicht verständliche Einschätzung der aktuellen Bedingungen.
categoryValue	integer (int32)	Bietet eine numerische Darstellung der Luftqualität oder des Pollengehalts. Dieser Wert entspricht der qualitativen `category` Eigenschaft und bietet eine präzise Möglichkeit, die Luftqualität oder den Pollengehalt zu quantifizieren. Diese Werte reichen von 1 bis 6, wobei 1 auf gute Bedingungen und 6 auf gefährliche Bedingungen hinweist.
name	string	Für Pollen: Gibt den Namen des Pollens zurück, wie Baum, Gras, Ambrosia oder Schimmel. Für Schadstoffe: Wenn die Immobilie `name` ist `AirQuality`, wird der Name des Schadstoffs in der Immobilie `type` zurückgegeben. Gültige Schadstoffe sind: PM2,5, PM10, O3, NO2, SO2 und CO. Für den UV-Index: Wenn die Eigenschaft `name` ist `UVIndex`, wird der UV-Index in der Eigenschaft `value` zurückgegeben. Gültige UV-Indexwerte reichen von 0 bis 11+ und geben die Intensität der ultravioletten Strahlung an. UV-Indexwerte werden wie folgt kategorisiert: 0-2: Niedrig 3-5: Moderat 6-7: Hoch 8-10: Sehr hoch 11+: Extrem
type	string	Spezifiziert die Art des zu messenden Luftschadstoffs. Wird nur verwendet, wenn die Immobilie `name`Luftqualität entspricht. Beispiele für Luftschadstoffe sind Feinstaub (PM2.5, PM10), Ozon (O3), Stickstoffdioxid (NO2), Schwefeldioxid (SO2) und Kohlenmonoxid (CO).
value	integer (int32)	Bietet eine numerische Messung der Konzentration von Schadstoffen oder Pollen in der Luft. Dieser Wert wird typischerweise in Einheiten angegeben, die für die Art des gemessenen Schadstoffs oder Pollens relevant sind, wie etwa Mikrogramm pro Kubikmeter (μg/m³) für Partikel oder Teile pro Milliarde (ppb) für Gase wie Ozon. Sowohl die Luftqualität als auch die UV-Strahlung sind Indizes, also einheitenlos.

DailyForecast

Objekt

Bietet detaillierte Wetterinformationen für einen bestimmten Tag, wie Temperatur, Wind, Niederschlag, Luftqualität und UV-Index.

Name	Typ	Beschreibung
airAndPollen	AirAndPollen[]	Eine Liste mit Schadstoffen, Pollenwerten und dem UV-Index für die tägliche Prognose. Jeder Listenpunkt enthält prognostizierte Mengen und Kategorien (z. B. niedrig, hoch, gut, mittelmäßig, ungesund, gefährlich), um potenzielle Gesundheitsrisiken zu bewerten.
date	string (date-time)	Datum und Uhrzeit der aktuellen Beobachtung, dargestellt im ISO-8601-Format (yyyy-mm-ddThh:mm:ss-hh:mm). Zum Beispiel 2025-04-29T07:00:00-07:00.
day	DailyForecastDetail	Liefert detaillierte Wetterinformationen für die Tageswettervorhersage, einschließlich Temperatur, Niederschlag, Wind und weiteren wichtigen Merkmalen.
degreeDaySummary	DegreeDaySummary	Bietet eine Zusammenfassung der Heiz- und Kühltage. Heizgradtage (HDD) messen den Energiebedarf zur Beheizung eines Gebäudes, berechnet basierend auf den Graden, in denen die Tagesdurchschnittstemperatur unter 65°F/18°C liegt. Cooling Degree Days (CDD) messen den Energiebedarf zur Kühlung eines Gebäudes, berechnet auf Basis der Tagesdurchschnittstemperatur über 65°F/18°C. Diese Zusammenfassung unterstützt das Energiemanagement und die Planung.
hoursOfSun	number (float)	Gibt die erwartete Anzahl an Sonnenstunden für den angegebenen Tag an.
night	DailyForecastDetail	Bietet detaillierte Wetterinformationen für die Nachtwettervorhersage, einschließlich Temperatur, Niederschlag, Wind und weiteren wichtigen Merkmalen.
realFeelTemperature	WeatherValueRange	Stellt RealFeel-Temperaturwerte™ für den angegebenen Tag bereit, gemessen in Grad Celsius (C) oder Fahrenheit (F), abhängig von der in der Anfrage angegebenen Einheit. Diese von AccuWeather entwickelte Metrik berücksichtigt über ein Dutzend Faktoren wie Luftfeuchtigkeit, Windgeschwindigkeit, Wolkenbedeckung und Sonnenintensität, um eine umfassende Kennzahl dafür zu liefern, wie sich das Wetter tatsächlich anfühlt.
realFeelTemperatureShade	WeatherValueRange	Bietet RealFeel-Temperaturwerte™ für den angegebenen Tag in schattigen Bereichen an. Diese von AccuWeather entwickelte Metrik berücksichtigt über ein Dutzend Faktoren, darunter Luftfeuchtigkeit, Windgeschwindigkeit, Wolkenbedeckung und Sonnenintensität, um eine umfassende Kennzahl dafür zu liefern, wie sich das Wetter im Schatten tatsächlich anfühlt.
sources	string[]	Eine Liste von Quellen, die zu den Wettervorhersagedaten beitragen.
temperature	WeatherValueRange	Gibt die vorhergesagten Höchst- und Tiefsttemperaturen für den Tag an, in Grad Celsius (C) oder Fahrenheit (F), abhängig von den in der Anfrage angegebenen Temperaturen `unit` .

DailyForecastDetail

Objekt

Detaillierte Wettervorhersage für einen Teil des Tages.

Name	Typ	Beschreibung
cloudCover	integer (int32)	Prozentualer Anteil der Wolkenbedeckung.
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.
hoursOfIce	number (float)	Stundenlanges Eis.
hoursOfPrecipitation	number (float)	Stunden des Niederschlags
hoursOfRain	number (float)	Stundenlanger Regen.
hoursOfSnow	number (float)	Stundenlanger Schnee.
ice	WeatherValue	Eis
iceProbability	integer (int32)	Prozent, der die Wahrscheinlichkeit von Eis darstellt. Beispiel: "30".
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 Symbols. Wird in der angegebenen Sprache angezeigt. Zum Beispiel "Sunny".
localSource	LocalSource	Informationen zum lokalen Wetterdatenanbieter.
longPhrase	string	Phrase Beschreibung der Prognose in der angegebenen Sprache. Azure Maps versucht, diese Phrase unter 100 Zeichen zu halten, aber einige Sprachen/Wetterereignisse können zu einer längeren Phrasenlänge führen, die über 100 Zeichen hinausgeht.
precipitationIntensity	string	Beschreibung der Intensität.
precipitationProbability	integer (int32)	Prozent, der die Wahrscheinlichkeit von Niederschlag darstellt. Beispiel: "20".
precipitationType	PrecipitationType	Gibt die Art des Niederschlags an. Gültige Werte sind "Rain", "Snow", "Ice" oder "Mix". Diese Eigenschaft ist in der Antwort enthalten, wenn dBZ größer als Null ist.
rain	WeatherValue	Regen
rainProbability	integer (int32)	Prozent, der die Wahrscheinlichkeit von Regen darstellt. Beispiel: "40".
shortPhrase	string	Phrase Beschreibung der Prognose in der angegebenen Sprache. Azure Maps versucht, diese Phrase unter 30 Zeichen zu halten, aber einige Sprachen/Wetterereignisse können zu einer längeren Phrasenlänge führen, die über 30 Zeichen hinausgeht.
snow	WeatherValue	Snow
snowProbability	integer (int32)	Prozent, der die Wahrscheinlichkeit von Schnee darstellt. Beispiel: "30".
thunderstormProbability	integer (int32)	Prozent, der die Wahrscheinlichkeit eines Gewitters darstellt. Beispiel: '80'.
totalLiquid	WeatherValue	Gesamtes flüssiges Äquivalent des Niederschlags im Prognosezeitraum.
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.

DailyForecastResult

Objekt

Tägliche Wettervorhersage.

Name	Typ	Beschreibung
forecasts	DailyForecast[]	Vorhersagedaten für jeden angeforderten Tag.
summary	DailyForecastSummary	Zusammenfassung der wichtigsten Bedingungen für den beantragten Zeitraum. Beachten Sie, dass die Zusammenfassung nur einen Teil des Zeitraums abdecken kann.

DailyForecastSummary

Objekt

Zusammenfassung der wichtigsten Bedingungen für den beantragten Zeitraum. Beachten Sie, dass die Zusammenfassung nur einen Teil des Zeitraums abdecken kann.

Name	Typ	Beschreibung
category	string	Bietet eine ein- oder zweiwortige Zusammenfassung der vorhergesagten Wetterbedingungen, wie sonnig, teilweise bewölkt, Regen oder Schnee.
endDate	string (date-time)	Das Enddatum und die Uhrzeit der Prognosezusammenfassung im ISO-8601-Format (jjjj-mm-ddThh:mm:ss-hh:mm). Zum Beispiel 2025-04-29T07:00:00-07:00.
phrase	string	Bietet eine kurze textuelle Zusammenfassung der täglichen Wetterbedingungen, dargestellt in der angegebenen Sprache.
severity	integer (int32)	Gibt die Schwere des vorhergesagten Wetters als ganze Zahl an. Niedrigere Zahlen stehen für eine höhere Schwere: 0 = Unbekannt, 1 = Signifikant, 2 = Groß, 3 = Mäßig, 4 = Klein, 5 = Minimal, 6 = Unbedeutend, 7 = Information.
startDate	string (date-time)	Das Startdatum und die Uhrzeit der Prognosezusammenfassung im ISO-8601-Format (yyyy-mm-ddThh:mm:ss-hh:mm). Zum Beispiel 2025-04-29T07:00:00-07:00.

DegreeDaySummary

Objekt

Zusammenfassung der Tage mit Heiz- und Abkühlgrad.

Name	Typ	Beschreibung
cooling	WeatherValue	Anzahl der Grad, bei denen die mittlere Temperatur über 65 Grad F / 18 Grad C liegt.
heating	WeatherValue	Anzahl der Grad, bei denen die Durchschnittstemperatur unter 65 Grad F / 18 Grad C liegt.

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.

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

LocalSource

Objekt

Informationen zum lokalen Wetterdatenanbieter.

Name	Typ	Beschreibung
id	integer (int32)	Numerischer Bezeichner, der für den lokalen Datenanbieter eindeutig ist.
name	string	Name des lokalen Datenanbieters. Der Name wird in der Sprache angezeigt, die durch den Sprachcode in der URL angegeben ist, sofern verfügbar. Andernfalls wird Name in Englisch oder der Sprache angezeigt, in der der Name angegeben wurde.
weatherCode	string	Wettercode, der vom lokalen Datenanbieter bereitgestellt wird. Dieser Wettercode ermöglicht es, die Vorhersage mit Symbolen des lokalen Datenanbieters statt Azure Maps-Symbolen abzugleichen.

PrecipitationType

Enumeration

Gibt die Art des Niederschlags an. Gültige Werte sind "Rain", "Snow", "Ice" oder "Mix". 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

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.

WeatherValueRange

Objekt

Zurückgegebene Temperaturwerte.

Name	Typ	Beschreibung
maximum	WeatherValue	Maximale Temperatur für den Zeitraum
minimum	WeatherValue	Minimale Temperatur für den Zeitraum.

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

URI-Parameter

Anforderungsheader

Antworten

Sicherheit

AadToken

Bereiche

subscription-key

SAS Token

Beispiele

Successfully retrieve detailed daily weather forecast for a given coordinate location

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AirAndPollen

DailyForecast

DailyForecastDetail

DailyForecastResult

DailyForecastSummary

DegreeDaySummary

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCode

JsonFormat

LocalSource

PrecipitationType

UnitType

WeatherDataUnit

WeatherValue

WeatherValueRange

WindDetails

WindDirection