Realtime en voorspelde weergegevens aanvragen met behulp van Azure Maps Weather-services
Azure Maps Weather-services zijn een set RESTful-API's waarmee ontwikkelaars zeer dynamische historische, realtime en voorspelde weergegevens en visualisaties in hun oplossingen kunnen integreren.
In dit artikel wordt gedemonstreerd hoe u zowel realtime als voorspelde weergegevens aanvraagt:
- Realtime (huidige) weergegevens aanvragen met behulp van de API Huidige voorwaarden ophalen.
- Vraag waarschuwingen voor ernstig weer aan met behulp van de API Voor ernstige weerwaarschuwingen ophalen.
- Dagelijkse prognoses aanvragen met behulp van de Get Daily Forecast-API.
- Vraag prognoses per uur aan met behulp van de GET Hourly Forecast-API.
- Vraag minuut-per-minuutprognoses aan met behulp van de GET Minute Forecast-API.
Deze video bevat voorbeelden voor het plaatsen van REST-aanroepen naar Azure Maps Weather-services.
Vereisten
- Een Azure Maps-account
- Een abonnementssleutel
Belangrijk
In de URL-voorbeelden in dit artikel moet u vervangen door {Your-Azure-Maps-Subscription-key} uw Azure Maps-abonnementssleutel.
In deze zelfstudie wordt gebruikgemaakt van de bruno-toepassing , maar u kunt een andere API-ontwikkelomgeving kiezen.
Realtime weergegevens aanvragen
De API Huidige voorwaarden ophalen retourneert gedetailleerde weersomstandigheden, zoals neerslag, temperatuur en wind voor een bepaalde coördinaatlocatie. Bovendien kunnen waarnemingen van de afgelopen 6 of 24 uur voor een bepaalde locatie worden opgehaald. Het antwoord bevat details zoals observatiedatum en -tijd, beschrijving van weersomstandigheden, weerpictogram, neerslagindicatorvlagmen en temperatuur. RealFeel™ Temperatuur en UV-index (Uv) worden ook geretourneerd.
In dit voorbeeld gebruikt u de API Huidige voorwaarden ophalen om de huidige weersomstandigheden op te halen op coördinaten in Seattle, WA.
Open de bruno-app, selecteer NIEUWE AANVRAAG om de aanvraag te maken. Stel in het venster NEW REQUEST het type in op HTTP. Voer een naam in voor de aanvraag.
Selecteer de GET HTTP-methode in de vervolgkeuzelijst URL en voer vervolgens de volgende URL in:
https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.0&query=47.60357,-122.32945&subscription-key={Your-Azure-Maps-Subscription-key}Selecteer de blauwe knop Maken .
Selecteer de knop Uitvoeren.
De hoofdtekst van het antwoord bevat actuele weerinformatie.
{ "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 } } } } ] }
Waarschuwingen voor ernstig weer aanvragen
Azure Maps Get Severe Weather Alerts-API retourneert de waarschuwingen voor ernstig weer die wereldwijd beschikbaar zijn van zowel officiële overheid meteorologische instanties als wereldwijd leidend tot regionale weerwaarschuwingsproviders. De service retourneert details zoals waarschuwingstype, categorie, niveau. De service retourneert ook gedetailleerde beschrijvingen over de actieve ernstige waarschuwingen voor de aangevraagde locatie, zoals orkanen, onweersbuien, bliksem, hittegolven of bosbranden. Logistieke managers kunnen bijvoorbeeld ernstige weersomstandigheden op een kaart visualiseren, samen met bedrijfslocaties en geplande routes, en verder coördineren met chauffeurs en lokale werknemers.
In dit voorbeeld gebruikt u de API Voor ernstige weerwaarschuwingen ophalen om de huidige weersomstandigheden op te halen op coördinaten die zich in Cheyenne, WY bevinden.
Notitie
In dit voorbeeld worden waarschuwingen voor ernstig weer opgehaald op het moment van schrijven. Het is waarschijnlijk dat er geen ernstige weerwaarschuwingen meer zijn op de aangevraagde locatie. Als u werkelijke ernstige waarschuwingsgegevens wilt ophalen bij het uitvoeren van dit voorbeeld, moet u gegevens ophalen op een andere coördinaatlocatie.
Selecteer in de bruno-app NIEUWE AANVRAAG om de aanvraag te maken. Stel in het venster NEW REQUEST het type in op HTTP. Voer een naam in voor de aanvraag.
Selecteer de GET HTTP-methode in de vervolgkeuzelijst URL en voer vervolgens de volgende URL in:
https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.0&query=41.161079,-104.805450&subscription-key={Your-Azure-Maps-Subscription-key}Selecteer de blauwe knop Maken .
Selecteer de knop Uitvoeren.
Als er geen waarschuwingen voor ernstig weer zijn, bevat de hoofdtekst van het antwoord een lege
results[]matrix. Als er ernstige weerwaarschuwingen zijn, bevat de hoofdtekst van het antwoord iets als het volgende JSON-antwoord:{ "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" } ] },... ] }
Dagelijkse weersvoorspellingsgegevens aanvragen
De GET Daily Forecast-API retourneert gedetailleerde dagelijkse weersvoorspellingen, zoals temperatuur en wind. De aanvraag kan aangeven hoeveel dagen moeten worden geretourneerd: 1, 5, 10, 15, 25 of 45 dagen voor een bepaalde coördinaatlocatie. Het antwoord bevat details zoals temperatuur, wind, neerslag, luchtkwaliteit en UV-index. In dit voorbeeld vragen we vijf dagen om in te stellen duration=5.
Belangrijk
In de prijscategorie S0 kunt u dagelijkse prognoses aanvragen voor de komende 1, 5, 10 en 15 dagen. In de prijscategorie Gen1 (S1) of Gen2 kunt u een dagelijkse prognose aanvragen voor de komende 25 dagen en 45 dagen.
Buitengebruikstelling van Azure Maps Gen1-prijscategorie
De prijscategorie Gen1 is nu afgeschaft en wordt buiten gebruik gesteld op 15-9-26. De prijscategorie Gen2 vervangt de prijscategorie Gen1 (zowel S0 als S1). Als voor uw Azure Maps-account een Gen1-prijscategorie is geselecteerd, kunt u overschakelen naar Gen2-prijzen voordat het buiten gebruik wordt gesteld, anders wordt deze automatisch bijgewerkt. Zie De prijscategorie van uw Azure Maps-account beheren voor meer informatie.
In dit voorbeeld gebruikt u de API Dagelijkse prognose ophalen om de weersvoorspelling van vijf dagen op te halen voor coördinaten in Seattle, WA.
Selecteer in de bruno-app NIEUWE AANVRAAG om de aanvraag te maken. Stel in het venster NEW REQUEST het type in op HTTP. Voer een naam in voor de aanvraag.
Selecteer de GET HTTP-methode in de vervolgkeuzelijst URL en voer vervolgens de volgende URL in:
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}Selecteer de blauwe knop Maken .
Selecteer de knop Uitvoeren.
De hoofdtekst van het antwoord bevat de prognosegegevens van vijf dagen. Omwille van de beknoptheid toont het volgende JSON-antwoord de prognose voor de eerste dag.
{ "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" ] } ] }
Weersvoorspellingsgegevens per uur aanvragen
De API Prognose per uur ophalen retourneert gedetailleerde weersvoorspelling per uur voor de volgende 1, 12, 24 (1 dag), 72 (3 dagen), 120 (5 dagen) en 240 uur (10 dagen) voor de opgegeven coördinatenlocatie. De API retourneert details zoals temperatuur, vochtigheid, wind, neerslag en UV-index.
Belangrijk
In de Prijscategorie Gen1 (S0) kunt u uurprognoses aanvragen voor de volgende 1, 12, 24 uur (1 dag) en 72 uur (3 dagen). In de prijscategorie Gen1 (S1) of Gen2 kunt u een uurprognose aanvragen voor de volgende 120 (5 dagen) en 240 uur (10 dagen).
In dit voorbeeld gebruikt u de API voor prognose per uur ophalen om de 12 uur durende weersvoorspelling op te halen op coördinaten in Seattle, WA.
Selecteer in de bruno-app NIEUWE AANVRAAG om de aanvraag te maken. Stel in het venster NEW REQUEST het type in op HTTP. Voer een naam in voor de aanvraag.
Selecteer de GET HTTP-methode in de vervolgkeuzelijst URL en voer vervolgens de volgende URL in:
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}Selecteer de blauwe knop Maken .
Selecteer de knop Uitvoeren.
De hoofdtekst van het antwoord bevat weersvoorspellingsgegevens voor de komende 12 uur. In het volgende voorbeeld van een JSON-antwoord wordt alleen het eerste uur weergegeven:
{ "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 } } ] }
Weersvoorspellingsgegevens per minuut aanvragen
De GET Minute Forecast-API retourneert prognoses per minuut voor een bepaalde locatie voor de komende 120 minuten. Gebruikers kunnen in intervallen van 1, 5 en 15 minuten weersvoorspellingen aanvragen. Het antwoord bevat details zoals het type neerslag (inclusief regen, sneeuw of een combinatie van beide), begintijd en neerslagintensiteit (dBZ).
In dit voorbeeld gebruikt u de API Get Minute Forecast om de weersvoorspelling per minuut op te halen op coördinaten in Seattle, WA. De weersvoorspelling wordt gegeven voor de komende 120 minuten. Onze query vraagt aan dat de prognose wordt gegeven met intervallen van 15 minuten, maar u kunt de parameter instellen op 1 of 5 minuten.
Selecteer in de bruno-app NIEUWE AANVRAAG om de aanvraag te maken. Stel in het venster NEW REQUEST het type in op HTTP. Voer een naam in voor de aanvraag.
Selecteer de GET HTTP-methode in de vervolgkeuzelijst URL en voer vervolgens de volgende URL in:
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}Selecteer de blauwe knop Maken .
Selecteer de knop Uitvoeren.
De hoofdtekst van het antwoord bevat weersvoorspellingsgegevens voor de komende 120 minuten, in intervallen van 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 } ] }