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

Mit optionalen Parametern:

GET https://atlas.microsoft.com/weather/forecast/daily/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	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 Verwendung mit dem Microsoft Entra ID-Sicherheitsmodell vorgesehen ist. Diese eindeutige ID für das Azure Maps-Konto kann über die Konto-API der Azure Maps-Verwaltungsebene abgerufen werden. Weitere Informationen zur Verwendung der Microsoft Entra ID-Sicherheit in Azure Maps finden Sie unter Verwalten der Authentifizierung in Azure Maps.

Antworten

Name	Typ	Beschreibung
200 OK	DailyForecastResult	OK
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.

Notes

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.

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

Beispielanforderung

HTTP

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

Statuscode:: 200

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

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.
DailyForecastResult
DailyForecastSummary	Zusammenfassung der wichtigsten Bedingungen für den beantragten Zeitraum. Beachten Sie, dass die Zusammenfassung nur einen Teil des Zeitraums abdecken kann.
DayOrNight
DegreeDaySummary
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
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. Kann 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 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.
WeatherUnitRange	Zurückgegebene Temperaturwerte.
WindDetails	Winddetails, 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	DayOrNight	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	DayOrNight	Bietet detaillierte Wetterinformationen für die Nachtwettervorhersage, einschließlich Temperatur, Niederschlag, Wind und weiteren wichtigen Merkmalen.
realFeelTemperature	WeatherUnitRange	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	WeatherUnitRange	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	WeatherUnitRange	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` .

DailyForecastResult

Objekt

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.

DayOrNight

Objekt

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	WeatherUnit	Ice
iceProbability	integer (int32)	Prozent, der die Wahrscheinlichkeit von Eis darstellt. Beispiel: "30".
iconCode	IconCode (int32)	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. Kann 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 Wortgruppe unter 100 Zeichen zu halten, aber einige Sprachen/Wetterereignisse können zu einer längeren Ausdruckslänge von mehr als 100 Zeichen führen.
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	WeatherUnit	Rain
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 Wortgruppe unter 30 Zeichen zu halten, aber einige Sprachen/Wetterereignisse können zu einer längeren Ausdruckslänge von mehr als 30 Zeichen führen.
snow	WeatherUnit	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	WeatherUnit	Gesamtes flüssiges Äquivalent des Niederschlags im Prognosezeitraum.
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.

DegreeDaySummary

Objekt

Name	Typ	Beschreibung
cooling	WeatherUnit	Anzahl der Grad, bei denen die mittlere Temperatur über 65 Grad F / 18 Grad C liegt.
heating	WeatherUnit	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	object	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

Fehlerantwort

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. Kann NULL sein.

Wert	Beschreibung
1	Sunny
2	Überwiegend sonnig
3	Teilweise sonnig
4	Zeitweilige Wolken
5	Dunstiger Sonnenschein
6	Überwiegend bewölkt
7	Cloudy
8	Trist (bewölkt)
9
10
11	Fog
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	Rain
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	Ice
25	Sleet
26	Gefrierender Regen
27
28
29	Regen und Schnee
30	Hot
31	Cold
32	Windy
33	Clear
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. Mit diesem Wettercode kann die Vorhersage mit Symbolen abgeglichen werden, die vom lokalen Datenanbieter bereitgestellt werden, anstatt mit Azure Maps-Symbolen.

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	Ice
Mix	Mix
Rain	Rain
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 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	float
22	integer
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Enumeration

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

WeatherUnit

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 (int32)	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 Wetterdienste in Azure Maps.
value	number (float)	Gerundeter Wert.

WeatherUnitRange

Objekt

Zurückgegebene Temperaturwerte.

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

WindDetails

Objekt

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

Name	Typ	Beschreibung
direction	WindDirection	Windrichtung
speed	WeatherUnit	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

Notes

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

DailyForecastResult

DailyForecastSummary

DayOrNight

DegreeDaySummary

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCode

JsonFormat

LocalSource

PrecipitationType

UnitType

WeatherDataUnit

WeatherUnit

WeatherUnitRange

WindDetails

WindDirection