Richiedere dati meteo in tempo reale e previsti usando i servizi meteo Mappe di Azure
Mappe di Azure i servizi meteo sono un set di API RESTful che consentono agli sviluppatori di integrare dati cronologici, in tempo reale e meteo altamente dinamici e visualizzazioni nelle proprie soluzioni.
Questo articolo illustra come richiedere dati meteo in tempo reale e previsti:
- Richiedere dati meteo in tempo reale (corrente) usando l'API Recupera condizioni correnti.
- Richiedere avvisi meteo gravi usando l'API Ottieni avvisi meteo gravi.
- Richiedere previsioni giornaliere usando l'API Get Daily Forecast.
- Richiedere previsioni orarie usando l'API Get Hourly Forecast.
- Previsioni minuti per minuto usando l'API Get Minute Forecast.
Questo video fornisce esempi per effettuare chiamate REST ai servizi meteo Mappe di Azure.
Prerequisiti
Chiave di sottoscrizione
Importante
L'API Get Minute Forecast richiede un piano tariffario Gen1 (S1) o Gen2.
Questa esercitazione usa l'applicazione Postman, tuttavia è possibile scegliere un ambiente di sviluppo API diverso.
Richiedere dati meteo in tempo reale
L'API Get Current Conditions restituisce condizioni meteo dettagliate, ad esempio precipitazioni, temperatura e vento per una determinata posizione di coordinata. Inoltre, le osservazioni degli ultimi 6 o 24 ore per una determinata posizione possono essere recuperate. La risposta include dettagli come data di osservazione e ora, descrizione delle condizioni meteo, icona meteo, flag di indicatore di precipitazione e temperatura. Viene restituito anche l'indice RealFeel™ Temperature e ultraviolett(UV).
In questo esempio si usa l'API Get Current Condition per recuperare le condizioni meteorologiche correnti alle coordinate che si trovano a Seattle, WA.
Aprire l'app Postman. Selezionare Nuovo per creare la richiesta. Nella finestra Crea nuovo selezionare Richiesta HTTP. Immettere un Request Name (Nome richiesta) per la richiesta.
Selezionare il metodo GET HTTP nella scheda Generatore e immettere l'URL seguente. Per questa richiesta e altre richieste indicate in questo articolo, sostituire
{Your-Azure-Maps-Subscription-key}con la chiave di sottoscrizione Mappe di Azure.https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.0&query=47.60357,-122.32945&subscription-key={Your-Azure-Maps-Subscription-key}Selezionare il pulsante Invia blu. Il corpo della risposta contiene informazioni meteo correnti.
{ "results": [ { "dateTime": "2020-10-19T20:39:00+00:00", "phrase": "Cloudy", "iconCode": 7, "hasPrecipitation": false, "isDayTime": true, "temperature": { "value": 12.4, "unit": "C", "unitType": 17 }, "realFeelTemperature": { "value": 13.7, "unit": "C", "unitType": 17 }, "realFeelTemperatureShade": { "value": 13.7, "unit": "C", "unitType": 17 }, "relativeHumidity": 87, "dewPoint": { "value": 10.3, "unit": "C", "unitType": 17 }, "wind": { "direction": { "degrees": 23.0, "localizedDescription": "NNE" }, "speed": { "value": 4.5, "unit": "km/h", "unitType": 7 } }, "windGust": { "speed": { "value": 9.0, "unit": "km/h", "unitType": 7 } }, "uvIndex": 1, "uvIndexPhrase": "Low", "visibility": { "value": 9.7, "unit": "km", "unitType": 6 }, "obstructionsToVisibility": "", "cloudCover": 100, "ceiling": { "value": 1494.0, "unit": "m", "unitType": 5 }, "pressure": { "value": 1021.2, "unit": "mb", "unitType": 14 }, "pressureTendency": { "localizedDescription": "Steady", "code": "S" }, "past24HourTemperatureDeparture": { "value": -2.1, "unit": "C", "unitType": 17 }, "apparentTemperature": { "value": 15.0, "unit": "C", "unitType": 17 }, "windChillTemperature": { "value": 12.2, "unit": "C", "unitType": 17 }, "wetBulbTemperature": { "value": 11.3, "unit": "C", "unitType": 17 }, "precipitationSummary": { "pastHour": { "value": 0.0, "unit": "mm", "unitType": 3 }, "past3Hours": { "value": 0.0, "unit": "mm", "unitType": 3 }, "past6Hours": { "value": 0.0, "unit": "mm", "unitType": 3 }, "past9Hours": { "value": 0.0, "unit": "mm", "unitType": 3 }, "past12Hours": { "value": 0.0, "unit": "mm", "unitType": 3 }, "past18Hours": { "value": 0.0, "unit": "mm", "unitType": 3 }, "past24Hours": { "value": 0.4, "unit": "mm", "unitType": 3 } }, "temperatureSummary": { "past6Hours": { "minimum": { "value": 12.2, "unit": "C", "unitType": 17 }, "maximum": { "value": 14.0, "unit": "C", "unitType": 17 } }, "past12Hours": { "minimum": { "value": 12.2, "unit": "C", "unitType": 17 }, "maximum": { "value": 14.0, "unit": "C", "unitType": 17 } }, "past24Hours": { "minimum": { "value": 12.2, "unit": "C", "unitType": 17 }, "maximum": { "value": 15.6, "unit": "C", "unitType": 17 } } } } ] }
Richiedere avvisi meteo gravi
Mappe di Azure Get Severe Weather Alert API restituisce gli avvisi meteorologici gravi disponibili in tutto il mondo dalle agenzie meteorologiche ufficiali e portando a livello globale i provider di avvisi meteorologici regionali. Il servizio restituisce dettagli come tipo di avviso, categoria, livello. Il servizio restituisce anche descrizioni dettagliate sugli avvisi gravi attivi per la posizione richiesta, ad esempio uragani, temporali, fulmini, onde di calore o incendi di foresta. Ad esempio, i responsabili della logistica possono visualizzare condizioni meteorologiche gravi su una mappa, insieme alle località aziendali e alle route pianificate, e coordinare ulteriormente i driver e i lavoratori locali.
In questo esempio si usa l'API Get Severe Weather Alert per recuperare le condizioni meteorologiche correnti alle coordinate che si trovano a Cheyenne, WY.
Nota
In questo esempio vengono recuperati avvisi meteo gravi al momento della scrittura. È probabile che non ci siano più avvisi meteorologici gravi nella posizione richiesta. Per recuperare i dati di avviso gravi effettivi durante l'esecuzione di questo esempio, è necessario recuperare i dati in una posizione di coordinata diversa.
Nell'app Postman selezionare Nuovo per creare la richiesta. Nella finestra Crea nuovo selezionare Richiesta HTTP. Immettere un Request Name (Nome richiesta) per la richiesta.
Selezionare il metodo GET HTTP nella scheda Generatore e immettere l'URL seguente. Per questa richiesta e altre richieste indicate in questo articolo, sostituire
{Your-Azure-Maps-Subscription-key}con la chiave di sottoscrizione Mappe di Azure.https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.0&query=41.161079,-104.805450&subscription-key={Your-Azure-Maps-Subscription-key}Selezionare il pulsante Invia blu. Se non sono presenti avvisi meteo gravi, il corpo della risposta contiene una matrice vuota
results[]. Se sono presenti avvisi meteo gravi, il corpo della risposta contiene una risposta simile alla seguente risposta JSON:{ "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" } ] },... ] }
Richiedere i dati delle previsioni meteo giornaliere
L'API Get Daily Forecast restituisce previsioni meteo giornaliere dettagliate, ad esempio temperatura e vento. La richiesta può specificare il numero di giorni da restituire: 1, 5, 10, 15, 25 o 45 giorni per una determinata posizione di coordinata. La risposta include dettagli come temperatura, vento, precipitazioni, qualità dell'aria e indice UV. In questo esempio viene richiesto per cinque giorni impostando duration=5.
Importante
Nel piano tariffario S0 è possibile richiedere previsioni giornaliere per i successivi 1, 5, 10 e 15 giorni. Nel piano tariffario Gen1 (S1) o Gen2 è possibile richiedere previsioni giornaliere per i prossimi 25 giorni e 45 giorni.
ritiro del piano tariffario Mappe di Azure Gen1
Il piano tariffario Gen1 è ora deprecato e verrà ritirato il 9/15/26. Il piano tariffario Gen2 sostituisce il piano tariffario Gen1 (sia S0 che S1). Se l'account Mappe di Azure ha selezionato il piano tariffario Gen1, è possibile passare ai prezzi di Gen2 prima del ritiro, altrimenti verrà aggiornato automaticamente. Per altre informazioni, vedere Gestire il piano tariffario dell'account Mappe di Azure.
In questo esempio si usa l'API Get Daily Forecast per recuperare le previsioni meteo di cinque giorni per le coordinate che si trovano a Seattle, WA.
Nell'app Postman selezionare Nuovo per creare la richiesta. Nella finestra Crea nuovo selezionare Richiesta HTTP. Immettere un Request Name (Nome richiesta) per la richiesta.
Selezionare il metodo GET HTTP nella scheda Generatore e immettere l'URL seguente. Per questa richiesta e altre richieste indicate in questo articolo, sostituire
{Your-Azure-Maps-Subscription-key}con la chiave di sottoscrizione Mappe di Azure.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}Selezionare il pulsante Invia blu. Il corpo della risposta contiene i dati delle previsioni meteo di cinque giorni. Per motivi di brevità, la risposta JSON seguente mostra la previsione per il primo giorno.
{ "summary": { "startDate": "2020-10-18T17:00:00+00:00", "endDate": "2020-10-19T23:00:00+00:00", "severity": 2, "phrase": "Snow, mixed with rain at times continuing through Monday evening and a storm total of 3-6 cm", "category": "snow/rain" }, "forecasts": [ { "date": "2020-10-19T04:00:00+00:00", "temperature": { "minimum": { "value": -1.1, "unit": "C", "unitType": 17 }, "maximum": { "value": 1.3, "unit": "C", "unitType": 17 } }, "realFeelTemperature": { "minimum": { "value": -6.0, "unit": "C", "unitType": 17 }, "maximum": { "value": 0.5, "unit": "C", "unitType": 17 } }, "realFeelTemperatureShade": { "minimum": { "value": -6.0, "unit": "C", "unitType": 17 }, "maximum": { "value": 0.7, "unit": "C", "unitType": 17 } }, "hoursOfSun": 1.8, "degreeDaySummary": { "heating": { "value": 18.0, "unit": "C", "unitType": 17 }, "cooling": { "value": 0.0, "unit": "C", "unitType": 17 } }, "airAndPollen": [ { "name": "AirQuality", "value": 23, "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": 22, "iconPhrase": "Snow", "hasPrecipitation": true, "precipitationType": "Mixed", "precipitationIntensity": "Light", "shortPhrase": "Chilly with snow, 2-4 cm", "longPhrase": "Chilly with snow, accumulating an additional 2-4 cm", "precipitationProbability": 90, "thunderstormProbability": 0, "rainProbability": 54, "snowProbability": 85, "iceProbability": 8, "wind": { "direction": { "degrees": 36.0, "localizedDescription": "NE" }, "speed": { "value": 9.3, "unit": "km/h", "unitType": 7 } }, "windGust": { "direction": { "degrees": 70.0, "localizedDescription": "ENE" }, "speed": { "value": 25.9, "unit": "km/h", "unitType": 7 } }, "totalLiquid": { "value": 4.3, "unit": "mm", "unitType": 3 }, "rain": { "value": 0.5, "unit": "mm", "unitType": 3 }, "snow": { "value": 2.72, "unit": "cm", "unitType": 4 }, "ice": { "value": 0.0, "unit": "mm", "unitType": 3 }, "hoursOfPrecipitation": 9.0, "hoursOfRain": 1.0, "hoursOfSnow": 9.0, "hoursOfIce": 0.0, "cloudCover": 96 }, "night": { "iconCode": 29, "iconPhrase": "Rain and snow", "hasPrecipitation": true, "precipitationType": "Mixed", "precipitationIntensity": "Light", "shortPhrase": "Showers of rain and snow", "longPhrase": "A couple of showers of rain or snow this evening; otherwise, cloudy; storm total snowfall 1-3 cm", "precipitationProbability": 65, "thunderstormProbability": 0, "rainProbability": 60, "snowProbability": 54, "iceProbability": 4, "wind": { "direction": { "degrees": 16.0, "localizedDescription": "NNE" }, "speed": { "value": 16.7, "unit": "km/h", "unitType": 7 } }, "windGust": { "direction": { "degrees": 1.0, "localizedDescription": "N" }, "speed": { "value": 35.2, "unit": "km/h", "unitType": 7 } }, "totalLiquid": { "value": 4.3, "unit": "mm", "unitType": 3 }, "rain": { "value": 3.0, "unit": "mm", "unitType": 3 }, "snow": { "value": 0.79, "unit": "cm", "unitType": 4 }, "ice": { "value": 0.0, "unit": "mm", "unitType": 3 }, "hoursOfPrecipitation": 4.0, "hoursOfRain": 1.0, "hoursOfSnow": 3.0, "hoursOfIce": 0.0, "cloudCover": 94 }, "sources": [ "AccuWeather" ] },... ] }
Richiedere dati di previsione meteo oraria
L'API Get Hourly Forecast restituisce previsioni meteo dettagliate per l'ora per i successivi 1, 12, 24 (1 giorno), 72 (3 giorni), 120 (5 giorni) e 240 ore (10 giorni) per la posizione della coordinata specificata. L'API restituisce dettagli come temperatura, umidità, vento, precipitazioni e indice UV.
Importante
Nel piano tariffario Gen1 (S0) è possibile richiedere previsioni orarie per i successivi 1, 12, 24 ore (1 giorno) e 72 ore (3 giorni). Nel piano tariffario Gen1 (S1) o Gen2 è possibile richiedere previsioni orarie per i successivi 120 (5 giorni) e 240 ore (10 giorni).
In questo esempio si usa l'API Get Hourly Forecast per recuperare le previsioni meteo orarie per le prossime 12 ore alle coordinate che si trovano a Seattle, WA.
Nell'app Postman selezionare Nuovo per creare la richiesta. Nella finestra Crea nuovo selezionare Richiesta HTTP. Immettere un Request Name (Nome richiesta) per la richiesta.
Selezionare il metodo GET HTTP nella scheda Generatore e immettere l'URL seguente. Per questa richiesta e altre richieste indicate in questo articolo, sostituire
{Your-Azure-Maps-Subscription-key}con la chiave di sottoscrizione Mappe di Azure.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}Selezionare il pulsante Invia blu. Il corpo della risposta contiene i dati delle previsioni meteo per le prossime 12 ore. Per motivi di brevità, la risposta JSON seguente mostra la previsione per la prima ora.
{ "forecasts": [ { "date": "2020-10-19T21:00:00+00:00", "iconCode": 12, "iconPhrase": "Showers", "hasPrecipitation": true, "precipitationType": "Rain", "precipitationIntensity": "Light", "isDaylight": true, "temperature": { "value": 14.7, "unit": "C", "unitType": 17 }, "realFeelTemperature": { "value": 13.3, "unit": "C", "unitType": 17 }, "wetBulbTemperature": { "value": 12.0, "unit": "C", "unitType": 17 }, "dewPoint": { "value": 9.5, "unit": "C", "unitType": 17 }, "wind": { "direction": { "degrees": 242.0, "localizedDescription": "WSW" }, "speed": { "value": 9.3, "unit": "km/h", "unitType": 7 } }, "windGust": { "speed": { "value": 14.8, "unit": "km/h", "unitType": 7 } }, "relativeHumidity": 71, "visibility": { "value": 9.7, "unit": "km", "unitType": 6 }, "cloudCover": 100, "ceiling": { "value": 1128.0, "unit": "m", "unitType": 5 }, "uvIndex": 1, "uvIndexPhrase": "Low", "precipitationProbability": 51, "rainProbability": 51, "snowProbability": 0, "iceProbability": 0, "totalLiquid": { "value": 0.3, "unit": "mm", "unitType": 3 }, "rain": { "value": 0.3, "unit": "mm", "unitType": 3 }, "snow": { "value": 0.0, "unit": "cm", "unitType": 4 }, "ice": { "value": 0.0, "unit": "mm", "unitType": 3 } }... ] }
Richiedere dati di previsione meteo minuti per minuto
L'API Get Minute Forecast restituisce previsioni minuti per minuto per una determinata posizione per i successivi 120 minuti. Gli utenti possono richiedere previsioni meteo a intervalli di 1, 5 e 15 minuti. La risposta include dettagli come il tipo di precipitazioni (tra cui pioggia, neve o una miscela di entrambi), ora di inizio e valore di intensità di precipitazione (dBZ).
In questo esempio si usa l'API Get Minute Forecast per recuperare le previsioni meteo minuti per minuto in corrispondenza delle coordinate che si trovano a Seattle, WA. Le previsioni meteo sono fornite per i prossimi 120 minuti. La query richiede che la previsione venga fornita a intervalli di 15 minuti, ma è possibile modificare il parametro per essere 1 o 5 minuti.
Nell'app Postman selezionare Nuovo per creare la richiesta. Nella finestra Crea nuovo selezionare Richiesta HTTP. Immettere un Request Name (Nome richiesta) per la richiesta.
Selezionare il metodo GET HTTP nella scheda Generatore e immettere l'URL seguente. Per questa richiesta e altre richieste indicate in questo articolo, sostituire
{Your-Azure-Maps-Subscription-key}con la chiave di sottoscrizione Mappe di Azure.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}Selezionare il pulsante Invia blu. Il corpo della risposta contiene i dati di previsione meteo per i prossimi 120 minuti, in intervalli di 15 minuti.
{ "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": 7 }, "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": 7 } ], "intervals": [ { "startTime": "2020-10-19T20:51:00+00:00", "minute": 0, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T21:06:00+00:00", "minute": 15, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T21:21:00+00:00", "minute": 30, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T21:36:00+00:00", "minute": 45, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T21:51:00+00:00", "minute": 60, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T22:06:00+00:00", "minute": 75, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T22:21:00+00:00", "minute": 90, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T22:36:00+00:00", "minute": 105, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 } ] }