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 |
|
format
|
path | True |
Gewünschtes Format der Antwort. Nur |
|
|
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
|
|
|
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 |
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 |
Die Anforderung ist erfolgreich. |
|
| Other Status Codes |
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 URList 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 |
|---|---|
|
Air |
Ein Eintrag zur
|
|
Daily |
Die Prognose für einen Kalendertag am angegebenen Ort wurde als ein Eintrag pro Tag im |
|
Daily |
Vorhersagedetails für einen halben Tag. Die gleiche Form wird sowohl für ( |
|
Daily |
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 |
|
Daily |
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 |
|
Degree |
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 |
|
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
|
Error |
Das Fehlerdetails. |
|
Error |
Übliche Fehlerantwort für alle Azure Resource Manager APIs, um Fehlerdetails bei fehlgeschlagenen Operationen zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.) |
|
Icon |
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 Für die vollständige Liste der Codes, die zugeordneten Symbole und Beispielbilder siehe Weather Services in Azure Maps. |
|
Json |
Gewünschtes Format der Antwort. Nur |
|
Local |
Informationen über einen lokalen Wetterdatenanbieter, der zur Beschaffung der Vorhersage verwendet wird |
|
Precipitation |
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. |
|
Unit |
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. |
|
Weather |
Spezifiziert, ob Daten in metrischen oder imperialen Einheiten zurückgegeben werden sollen, wobei metrische Einheiten standardmäßig metrisch sind. Beispiel:
|
|
Weather |
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. |
|
Weather |
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. |
|
Wind |
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°. |
|
Wind |
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:
nameist Baum, Gras, Ambrosia oder Schimmel.valuegibt die Prognosemenge an undcategory/categoryValuebewertet sie von Niedrig nach Hoch. -
Luftqualität:
nameist Luftqualität undtypeidentifiziert den zu messenden Schadstoff (einer von PM2,5, PM10, O3, NO2, SO2 oder CO).category/categoryValueBewertung der Luftqualität von Gut bis Gefährlich. -
UV-Index:
nameist UVIndex.valueist der UV-Index (0 bis 11+) undcategory/categoryValuebewertet 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
|
| categoryValue |
integer (int32) |
Eine numerische Bewertung von 1 bis 6, die mit gepaart 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 |
string |
Wann
|
| value |
integer (int32) |
Die numerische Messung für diesen Indikator. Die Einheit hängt ab von
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 |
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 |
|
| date |
string (date-time) |
Das Kalenderdatum, das diese Prognose abdeckt, ist im ISO-8601-Format ( |
| day |
Die detaillierte Prognose für den Tagesteil – einschließlich Temperatur, Niederschlag, Wind, Wolkenbedeckung und weiteren wichtigen Merkmalen. |
|
| 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 |
Die detaillierte Prognose für den nächtlichen Tagesabschnitt – einschließlich Temperatur, Niederschlag, Wind, Wolkenbedeckung und weiteren wichtigen Merkmalen. |
|
| realFeelTemperature |
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 |
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 |
|
| sources |
string[] |
Die Datenanbieter, die zur heutigen Prognose beigetragen haben. |
| temperature |
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 |
|
| 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 |
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 |
Numerischer Wert, der ein Bild darstellt, das dem vorhergesagten Wetterzustand für diesen Zeitraum entspricht und durch die Eigenschaft |
|
| iconPhrase |
string |
Eine kurze Phrase, die das Symbol beschreibt und in der in der Anfrage angegebenen Sprache zurückgegeben wird. Zum Beispiel Sunny. |
| 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 |
| 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 |
Die vorherrschende Niederschlagsart, die in dieser Zeit erwartet wird – Regen, Schnee,Eis oder Mischung. Nur dann zurückgegeben, wenn |
|
| rain |
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 |
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 |
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 |
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 |
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 |
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 |
Die Tagesprognosen in chronologischer Reihenfolge mit einem Eintrag pro Tag in der gewünschten |
|
| summary |
Eine übergeordnete Zusammenfassung der vorherrschenden Wetterbedingungen über das angeforderte Vorhersagefenster. Die Zusammenfassung kann nur einen Teil des Zeitfensters abdecken
|
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:
|
| 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 |
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 |
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 |
Die zusätzlichen Informationen des Fehlers. |
|
| code |
string |
Der Fehlercode. |
| details |
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 |
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 |
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 Maps |
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 |
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 |
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 |
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 |
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 |
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 |