Anfordern von Echtzeit- und prognostizierten Wetterdaten mit Azure Maps-Wetterinfodiensten
Bei den Wetterinfodiensten von Azure Maps handelt es sich um eine Reihe von RESTful-APIs, mit denen Entwickler extrem dynamische Verlaufs-, Echtzeit- und Vorhersagewetterdaten und die zugehörigen Visualisierungen in ihre Lösungen integrieren können.
In diesem Artikel wird veranschaulicht, wie Sie Echtzeit- und prognostizierte Wetterdaten anfordern:
- Anfordern von Echtzeitwetterdaten (aktuell) mit der Get Current Conditions-API
- Anfordern von Unwetterwarnungen mit der Get Severe Weather Alerts-API
- Anfordern von Tagesvorhersagen mit der Get Daily Forecast-API
- Anfordern von stündlichen Vorhersagen mit der Get Hourly Forecast-API
- Anfordern von minütlichen Vorhersagen mit der Get Minute Forecast-API
Dieses Video enthält Beispiele dafür, wie REST-Aufrufe für die Wetterinfodienste von Azure Maps ausgeführt werden.
Voraussetzungen
- Ein Azure Maps-Konto
- Ein Abonnementschlüssel
Wichtig
In den URL-Beispielen in diesem Artikel müssen Sie {Your-Azure-Maps-Subscription-key} durch Ihren Azure Maps-Abonnementschlüssel ersetzen.
In diesem Tutorial wird die Anwendung bruno verwendet. Sie können aber auch eine andere API-Entwicklungsumgebung nutzen.
Anfordern von Echtzeitwetterdaten
Mit der Get Current Conditions-API werden ausführliche Informationen zu Wetterbedingungen zurückgegeben, z. B. Niederschlag, Temperatur und Windgeschwindigkeit für einen bestimmten Koordinatenstandort. Außerdem können die beobachteten Daten für die letzten 6 oder 24 Stunden für einen bestimmten Standort abgerufen werden. Die Antwort enthält Details wie das Datum und die Uhrzeit der Beobachtung, eine Beschreibung der Wetterbedingungen, das Wettersymbol, Niederschlagsanzeigen und die Temperatur. Die RealFeel™-Temperatur und der UV-Index werden ebenfalls zurückgegeben.
In diesem Beispiel verwenden Sie die Get Current Conditions-API, um die aktuellen Wetterbedingungen für einen Koordinatenstandort in Seattle (WA) abzurufen.
Öffnen Sie die bruno-App, und wählen Sie NEUE ANFORDERUNG aus, um die Anforderung zu erstellen. Legen Sie im Fenster NEUE ANFORDERUNG den Typ auf HTTP fest. Geben Sie einen Namen für die Anforderung ein.
Wählen Sie die HTTP-Methode GET in der Dropdownliste URL aus, und geben Sie dann die folgende URL ein:
https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.0&query=47.60357,-122.32945&subscription-key={Your-Azure-Maps-Subscription-key}Wählen Sie die blaue Schaltfläche Erstellen aus.
Klicken Sie auf die Schaltfläche „Ausführen“.
Der Text der Antwort enthält die aktuellen Wetterinformationen.
{ "results": [ { "dateTime": "2024-08-08T09:22:00-07:00", "phrase": "Sunny", "iconCode": 1, "hasPrecipitation": false, "isDayTime": true, "temperature": { "value": 19.5, "unit": "C", "unitType": 17 }, "realFeelTemperature": { "value": 23.7, "unit": "C", "unitType": 17 }, "realFeelTemperatureShade": { "value": 19.4, "unit": "C", "unitType": 17 }, "relativeHumidity": 81, "dewPoint": { "value": 16.2, "unit": "C", "unitType": 17 }, "wind": { "direction": { "degrees": 0, "localizedDescription": "N" }, "speed": { "value": 2, "unit": "km/h", "unitType": 7 } }, "windGust": { "speed": { "value": 3.8, "unit": "km/h", "unitType": 7 } }, "uvIndex": 4, "uvIndexPhrase": "Moderate", "visibility": { "value": 16.1, "unit": "km", "unitType": 6 }, "obstructionsToVisibility": "", "cloudCover": 5, "ceiling": { "value": 12192, "unit": "m", "unitType": 5 }, "pressure": { "value": 1015.9, "unit": "mb", "unitType": 14 }, "pressureTendency": { "localizedDescription": "Steady", "code": "S" }, "past24HourTemperatureDeparture": { "value": 3, "unit": "C", "unitType": 17 }, "apparentTemperature": { "value": 20, "unit": "C", "unitType": 17 }, "windChillTemperature": { "value": 19.4, "unit": "C", "unitType": 17 }, "wetBulbTemperature": { "value": 17.5, "unit": "C", "unitType": 17 }, "precipitationSummary": { "pastHour": { "value": 0, "unit": "mm", "unitType": 3 }, "past3Hours": { "value": 0, "unit": "mm", "unitType": 3 }, "past6Hours": { "value": 0, "unit": "mm", "unitType": 3 }, "past9Hours": { "value": 0, "unit": "mm", "unitType": 3 }, "past12Hours": { "value": 0, "unit": "mm", "unitType": 3 }, "past18Hours": { "value": 0, "unit": "mm", "unitType": 3 }, "past24Hours": { "value": 0, "unit": "mm", "unitType": 3 } }, "temperatureSummary": { "past6Hours": { "minimum": { "value": 16, "unit": "C", "unitType": 17 }, "maximum": { "value": 19.5, "unit": "C", "unitType": 17 } }, "past12Hours": { "minimum": { "value": 16, "unit": "C", "unitType": 17 }, "maximum": { "value": 20.4, "unit": "C", "unitType": 17 } }, "past24Hours": { "minimum": { "value": 16, "unit": "C", "unitType": 17 }, "maximum": { "value": 26.4, "unit": "C", "unitType": 17 } } } } ] }
Anfordern von Unwetterwarnungen
Mit der Get Severe Weather Alerts-API von Azure Maps werden die Unwetterwarnungen zurückgegeben, die weltweit sowohl von offiziellen staatlichen meteorologischen Behörden als auch von führenden globalen oder regionalen Wetterdiensten bereitgestellt werden. Der Dienst gibt Details wie Warnungstyp, -kategorie und -ebene zurück. Mit diesem Dienst können auch ausführliche Beschreibungen zu den bestehenden Unwetterwarnungen für den angeforderten Standort zurückgegeben werden, z. B. Hurrikane, Gewitter, Blitze, Hitzewellen oder Waldbrände. Logistikmanager können Unwetter zusammen mit Geschäftsstandorten und geplanten Routen beispielsweise auf einer Karte visualisieren und so eine bessere Koordinierung mit Fahrern und dem Personal vor Ort ermöglichen.
In diesem Beispiel verwenden Sie die Get Severe Weather Alerts-API, um die aktuellen Wetterbedingungen für einen Koordinatenstandort in Cheyenne (WY) abzurufen.
Hinweis
Dieses Beispiel veranschaulicht das Abrufen von Unwetterwarnungen, die bei der Erstellung dieses Dokuments bestanden haben. Wahrscheinlich gelten für den angeforderten Standort mittlerweile keine Unwetterwarnungen mehr. Wenn Sie bei der Ausführung dieses Beispiels aktuelle Unwetterdaten abrufen möchten, müssen Sie die Daten eines anderen Koordinatenstandorts verwenden.
Wählen Sie in der bruno-App die Option NEUE ANFORDERUNG aus, um die Anforderung zu erstellen. Legen Sie im Fenster NEUE ANFORDERUNG den Typ auf HTTP fest. Geben Sie einen Namen für die Anforderung ein.
Wählen Sie die HTTP-Methode GET in der Dropdownliste URL aus, und geben Sie dann die folgende URL ein:
https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.0&query=41.161079,-104.805450&subscription-key={Your-Azure-Maps-Subscription-key}Wählen Sie die blaue Schaltfläche Erstellen aus.
Klicken Sie auf die Schaltfläche „Ausführen“.
Falls keine Unwetterwarnungen vorhanden sind, enthält der Antworttext ein leeres
results[]-Array. Bei vorhandenen Unwetterwarnungen enthält der Antworttext eine JSON-Antwort der folgenden Art:{ "results": [ { "countryCode": "US", "alertId": 2194734, "description": { "localized": "Red Flag Warning", "english": "Red Flag Warning" }, "category": "FIRE", "priority": 54, "source": "U.S. National Weather Service", "sourceId": 2, "alertAreas": [ { "name": "Platte/Goshen/Central and Eastern Laramie", "summary": "Red Flag Warning in effect until 7:00 PM MDT. Source: U.S. National Weather Service", "startTime": "2020-10-05T15:00:00+00:00", "endTime": "2020-10-06T01:00:00+00:00", "latestStatus": { "localized": "Continue", "english": "Continue" }, "alertDetails": "...RED FLAG WARNING REMAINS IN EFFECT FROM 9 AM THIS MORNING TO\n7 PM MDT THIS EVENING FOR STRONG GUSTY WINDS AND LOW HUMIDITY...\n\n* WHERE...Fire weather zones 303, 304, 305, 306, 307, 308, 309,\n and 310 in southeast Wyoming. Fire weather zone 313 in Nebraska.\n\n* WIND...West to northwest 15 to 30 MPH with gusts around 40 MPH.\n\n* HUMIDITY...10 to 15 percent.\n\n* IMPACTS...Any fires that develop will likely spread rapidly.\n Outdoor burning is not recommended.\n\nPRECAUTIONARY/PREPAREDNESS ACTIONS...\n\nA Red Flag Warning means that critical fire weather conditions\nare either occurring now...or will shortly. A combination of\nstrong winds...low relative humidity...and warm temperatures can\ncontribute to extreme fire behavior.\n\n&&", "alertDetailsLanguageCode": "en" } ] },... ] }
Anfordern von täglichen Wettervorhersagedaten
Mit der Get Daily Forecast-API werden Daten für die ausführliche tägliche Wettervorhersage zurückgegeben, z. B. Temperatur und Windgeschwindigkeit. Hierbei kann angegeben werden, für wie viele Tage Daten zurückgegeben werden sollen: 1, 5, 10, 15, 25 oder 45 Tage für einen bestimmten Koordinatenstandort. Die Antwort enthält Details wie Temperatur, Windgeschwindigkeit, Niederschlag, Luftqualität und UV-Index. In diesem Beispiel fordern wir Daten für fünf Tage an, indem wir duration=5 angeben.
Wichtig
Im Tarif S0 können Sie die tägliche Vorhersage für die nächsten 1, 5, 10 und 15 Tage anfordern. Im Tarif „Gen1 (S1)” oder „Gen2” können Sie eine tägliche Vorhersage für die nächsten 25 Tage und 45 Tage anfordern.
Einstellung des Azure Maps-Tarifs „Gen1”
Der Tarif Gen1 ist jetzt veraltet und wird am 15.09.2026 eingestellt. Der Tarif Gen2 ersetzt den Tarif Gen1 (S0 und S1). Wenn für Ihr Azure Maps Konto der Tarif Gen1 ausgewählt ist, können Sie vor der Einstellung zum Tarif Gen2 wechseln, andernfalls erfolgt zu diesem Zeitpunkt eine automatische Umstellung. Weitere Informationen finden Sie unter Verwalten des Tarifs Ihres Azure Maps-Kontos.
In diesem Beispiel verwenden Sie die Get Daily Forecast-API, um die 5-Tage-Wettervorhersage für einen Koordinatenstandort in Seattle (WA) abzurufen.
Wählen Sie in der bruno-App die Option NEUE ANFORDERUNG aus, um die Anforderung zu erstellen. Legen Sie im Fenster NEUE ANFORDERUNG den Typ auf HTTP fest. Geben Sie einen Namen für die Anforderung ein.
Wählen Sie die HTTP-Methode GET in der Dropdownliste URL aus, und geben Sie dann die folgende URL ein:
https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.0&query=47.60357,-122.32945&duration=5&subscription-key={Your-Azure-Maps-Subscription-key}Wählen Sie die blaue Schaltfläche Erstellen aus.
Klicken Sie auf die Schaltfläche „Ausführen“.
Der Antworttext enthält die Daten für die 5-Tage-Wettervorhersage. Aus Platzgründen ist in der folgenden JSON-Antwort nur die Vorhersage für den ersten Tag dargestellt.
{ "summary": { "startDate": "2024-08-09T08:00:00-07:00", "endDate": "2024-08-09T20:00:00-07:00", "severity": 7, "phrase": "Very warm tomorrow", "category": "heat" }, "forecasts": [ { "date": "2024-08-08T07:00:00-07:00", "temperature": { "minimum": { "value": 16.2, "unit": "C", "unitType": 17 }, "maximum": { "value": 28.9, "unit": "C", "unitType": 17 } }, "realFeelTemperature": { "minimum": { "value": 16.3, "unit": "C", "unitType": 17 }, "maximum": { "value": 29.8, "unit": "C", "unitType": 17 } }, "realFeelTemperatureShade": { "minimum": { "value": 16.3, "unit": "C", "unitType": 17 }, "maximum": { "value": 27.3, "unit": "C", "unitType": 17 } }, "hoursOfSun": 12.9, "degreeDaySummary": { "heating": { "value": 0, "unit": "C", "unitType": 17 }, "cooling": { "value": 5, "unit": "C", "unitType": 17 } }, "airAndPollen": [ { "name": "AirQuality", "value": 56, "category": "Moderate", "categoryValue": 2, "type": "Nitrogen Dioxide" }, { "name": "Grass", "value": 2, "category": "Low", "categoryValue": 1 }, { "name": "Mold", "value": 0, "category": "Low", "categoryValue": 1 }, { "name": "Ragweed", "value": 5, "category": "Low", "categoryValue": 1 }, { "name": "Tree", "value": 0, "category": "Low", "categoryValue": 1 }, { "name": "UVIndex", "value": 7, "category": "High", "categoryValue": 3 } ], "day": { "iconCode": 2, "iconPhrase": "Mostly sunny", "hasPrecipitation": false, "shortPhrase": "Mostly sunny", "longPhrase": "Mostly sunny; wildfire smoke will cause the sky to be hazy", "precipitationProbability": 0, "thunderstormProbability": 0, "rainProbability": 0, "snowProbability": 0, "iceProbability": 0, "wind": { "direction": { "degrees": 357, "localizedDescription": "N" }, "speed": { "value": 11.1, "unit": "km/h", "unitType": 7 } }, "windGust": { "direction": { "degrees": 354, "localizedDescription": "N" }, "speed": { "value": 29.6, "unit": "km/h", "unitType": 7 } }, "totalLiquid": { "value": 0, "unit": "mm", "unitType": 3 }, "rain": { "value": 0, "unit": "mm", "unitType": 3 }, "snow": { "value": 0, "unit": "cm", "unitType": 4 }, "ice": { "value": 0, "unit": "mm", "unitType": 3 }, "hoursOfPrecipitation": 0, "hoursOfRain": 0, "hoursOfSnow": 0, "hoursOfIce": 0, "cloudCover": 10 }, "night": { "iconCode": 35, "iconPhrase": "Partly cloudy", "hasPrecipitation": false, "shortPhrase": "Partly cloudy", "longPhrase": "Partly cloudy; wildfire smoke will cause the sky to be hazy", "precipitationProbability": 1, "thunderstormProbability": 0, "rainProbability": 1, "snowProbability": 0, "iceProbability": 0, "wind": { "direction": { "degrees": 7, "localizedDescription": "N" }, "speed": { "value": 9.3, "unit": "km/h", "unitType": 7 } }, "windGust": { "direction": { "degrees": 3, "localizedDescription": "N" }, "speed": { "value": 20.4, "unit": "km/h", "unitType": 7 } }, "totalLiquid": { "value": 0, "unit": "mm", "unitType": 3 }, "rain": { "value": 0, "unit": "mm", "unitType": 3 }, "snow": { "value": 0, "unit": "cm", "unitType": 4 }, "ice": { "value": 0, "unit": "mm", "unitType": 3 }, "hoursOfPrecipitation": 0, "hoursOfRain": 0, "hoursOfSnow": 0, "hoursOfIce": 0, "cloudCover": 26 }, "sources": [ "AccuWeather" ] } ] }
Anfordern von stündlichen Wettervorhersagedaten
Mit der Get Hourly Forecast-API wird die ausführliche stündliche Wettervorhersage für die nächsten 1, 12, 24 (1 Tag), 72 (3 Tage), 120 (5 Tage) und 240 Stunden (10 Tage) für den angegebenen Koordinatenstandort zurückgegeben. Von der API werden Details wie Temperatur, Luftfeuchtigkeit, Windgeschwindigkeit, Niederschlag und UV-Index zurückgegeben.
Wichtig
Im Tarif „Gen1 (S0)” können Sie die stündliche Vorhersage für die nächsten 1, 12, 24 Stunden (1 Tag) und 72 Stunden (3 Tage) anfordern. Im Tarif „Gen1 (S1)” oder „Gen2” können Sie eine stündliche Vorhersage für die nächsten 120 Stunden (5 Tage) und 240 Stunden (10 Tage) anfordern.
In diesem Beispiel verwenden Sie die Get Hourly Forecast-API, um die stündliche Wettervorhersage für die nächsten zwölf Stunden für einen Koordinatenstandort in Seattle (WA) abzurufen.
Wählen Sie in der bruno-App die Option NEUE ANFORDERUNG aus, um die Anforderung zu erstellen. Legen Sie im Fenster NEUE ANFORDERUNG den Typ auf HTTP fest. Geben Sie einen Namen für die Anforderung ein.
Wählen Sie die HTTP-Methode GET in der Dropdownliste URL aus, und geben Sie dann die folgende URL ein:
https://atlas.microsoft.com/weather/forecast/hourly/json?api-version=1.0&query=47.60357,-122.32945&duration=12&subscription-key={Your-Azure-Maps-Subscription-key}Wählen Sie die blaue Schaltfläche Erstellen aus.
Klicken Sie auf die Schaltfläche „Ausführen“.
Der Antworttext enthält die Daten der Wettervorhersage für die nächsten zwölf Stunden. Die folgende JSON-Beispielantwort zeigt nur die erste Stunde:
{ "forecasts": [ { "date": "2024-08-07T15:00:00-07:00", "iconCode": 2, "iconPhrase": "Mostly sunny", "hasPrecipitation": false, "isDaylight": true, "temperature": { "value": 24.6, "unit": "C", "unitType": 17 }, "realFeelTemperature": { "value": 26.4, "unit": "C", "unitType": 17 }, "wetBulbTemperature": { "value": 18.1, "unit": "C", "unitType": 17 }, "dewPoint": { "value": 14.5, "unit": "C", "unitType": 17 }, "wind": { "direction": { "degrees": 340, "localizedDescription": "NNW" }, "speed": { "value": 14.8, "unit": "km/h", "unitType": 7 } }, "windGust": { "speed": { "value": 24.1, "unit": "km/h", "unitType": 7 } }, "relativeHumidity": 53, "visibility": { "value": 16.1, "unit": "km", "unitType": 6 }, "cloudCover": 11, "ceiling": { "value": 10211, "unit": "m", "unitType": 5 }, "uvIndex": 5, "uvIndexPhrase": "Moderate", "precipitationProbability": 0, "rainProbability": 0, "snowProbability": 0, "iceProbability": 0, "totalLiquid": { "value": 0, "unit": "mm", "unitType": 3 }, "rain": { "value": 0, "unit": "mm", "unitType": 3 }, "snow": { "value": 0, "unit": "cm", "unitType": 4 }, "ice": { "value": 0, "unit": "mm", "unitType": 3 } } ] }
Anfordern von minütlichen Wettervorhersagedaten
Mit der Get Minute Forecast-API werden die minütlichen Vorhersagen für einen bestimmten Standort für die nächsten 120 Minuten zurückgegeben. Benutzer können Wettervorhersagen in Intervallen von 1, 5 und 15 Minuten anfordern. Die Antwort enthält Details wie die Niederschlagsart (z. B. Regen, Schnee oder Schneeregen), die Startzeit und den Wert für die Niederschlagsintensität.
In diesem Beispiel verwenden Sie die Get Minute Forecast-API, um die minütliche Wettervorhersage für einen Koordinatenstandort in Seattle (WA) abzurufen. Die Wettervorhersagedaten werden für die nächsten 120 Minuten zurückgegeben. Mit unserer Abfrage fordern wir an, dass die Vorhersage in Intervallen von 15 Minuten erfolgen soll, aber Sie können den Parameter auch anpassen und auf 1 oder 5 Minuten festlegen.
Wählen Sie in der bruno-App die Option NEUE ANFORDERUNG aus, um die Anforderung zu erstellen. Legen Sie im Fenster NEUE ANFORDERUNG den Typ auf HTTP fest. Geben Sie einen Namen für die Anforderung ein.
Wählen Sie die HTTP-Methode GET in der Dropdownliste URL aus, und geben Sie dann die folgende URL ein:
https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.0&query=47.60357,-122.32945&interval=15&subscription-key={Your-Azure-Maps-Subscription-key}Wählen Sie die blaue Schaltfläche Erstellen aus.
Klicken Sie auf die Schaltfläche „Ausführen“.
Der Antworttext enthält Wettervorhersagedaten für die nächsten 120 Minuten (in Intervallen von 15 Minuten).
{ "summary": { "briefPhrase60": "No precipitation for at least 60 min", "shortPhrase": "No precip for 120 min", "briefPhrase": "No precipitation for at least 120 min", "longPhrase": "No precipitation for at least 120 min", "iconCode": 1 }, "intervalSummaries": [ { "startMinute": 0, "endMinute": 119, "totalMinutes": 120, "shortPhrase": "No precip for %MINUTE_VALUE min", "briefPhrase": "No precipitation for at least %MINUTE_VALUE min", "longPhrase": "No precipitation for at least %MINUTE_VALUE min", "iconCode": 1 } ], "intervals": [ { "startTime": "2024-08-08T05:58:00-07:00", "minute": 0, "dbz": 0, "shortPhrase": "No Precipitation", "iconCode": 1, "cloudCover": 7 }, { "startTime": "2024-08-08T06:13:00-07:00", "minute": 15, "dbz": 0, "shortPhrase": "No Precipitation", "iconCode": 1, "cloudCover": 3 }, { "startTime": "2024-08-08T06:28:00-07:00", "minute": 30, "dbz": 0, "shortPhrase": "No Precipitation", "iconCode": 1, "cloudCover": 2 }, { "startTime": "2024-08-08T06:43:00-07:00", "minute": 45, "dbz": 0, "shortPhrase": "No Precipitation", "iconCode": 1, "cloudCover": 2 }, { "startTime": "2024-08-08T06:58:00-07:00", "minute": 60, "dbz": 0, "shortPhrase": "No Precipitation", "iconCode": 1, "cloudCover": 1 }, { "startTime": "2024-08-08T07:13:00-07:00", "minute": 75, "dbz": 0, "shortPhrase": "No Precipitation", "iconCode": 1, "cloudCover": 1 }, { "startTime": "2024-08-08T07:28:00-07:00", "minute": 90, "dbz": 0, "shortPhrase": "No Precipitation", "iconCode": 1, "cloudCover": 0 }, { "startTime": "2024-08-08T07:43:00-07:00", "minute": 105, "dbz": 0, "shortPhrase": "No Precipitation", "iconCode": 1, "cloudCover": 0 } ] }