Weather - Get Current Conditions

Service:: Maps

Versione API:: 1.1

Utilizzare per ottenere le condizioni meteorologiche correnti.
L'API Get Current Conditions è una richiesta HTTP GET che restituisce le condizioni meteorologiche attuali dettagliate, ad esempio precipitazioni, temperatura e vento per una determinata posizione delle coordinate. Inoltre, è possibile recuperare le osservazioni delle ultime 6 o 24 ore per una determinata posizione. Le informazioni di base restituite con La risposta include dettagli quali la data e l'ora di osservazione, una breve descrizione delle condizioni meteorologiche, l'icona del tempo, le bandiere degli indicatori di precipitazione e la temperatura. Vengono restituiti anche dettagli aggiuntivi come la temperatura RealFeel™ e l'indice UV. Per ulteriori informazioni, consulta Richiedere dati meteo in tempo reale

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}

Con parametri facoltativi:

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&duration={duration}&language={language}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	Il nome host del servizio Mappe di Azure. Usa `https://atlas.microsoft.com` per il cloud pubblico Azure. Per puntare a una specifica Mappe di Azure geografica o a una nuvola sovrana, vedi Mappe di Azure ambito geografico.
format	path	True	JsonFormat	Formato desiderato della risposta. È supportato solo `json` formato.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
query	query	True	number[]	La query applicabile specificata come stringa delimitata da virgole composta da latitudine seguita da longitudine, ad esempio "47.641268,-122.125679". Le informazioni meteorologiche sono generalmente disponibili per le località sulla terraferma, i corpi idrici circondati dalla terraferma e le aree dell'oceano che si trovano entro circa 50 miglia nautiche da una costa.
details	query		string	Restituisci tutti i dettagli per le condizioni attuali. I valori disponibili sono `true` - Restituisce tutti i dettagli. Per impostazione predefinita, vengono restituiti tutti i dettagli. `false` - Restituisce una versione troncata dei dati della condizione corrente, che include la data e l'ora di osservazione, la frase meteorologica, il codice icona, l'indicatore di precipitazione e la temperatura.
duration	query		integer (int32)	Lasso di tempo delle condizioni meteo di ritorno. Per impostazione predefinita, verranno restituite le condizioni meteorologiche più aggiornate. Il valore predefinito è 0. I valori supportati sono: `0` - Restituisci le condizioni meteorologiche più aggiornate. `6` - Condizioni meteorologiche di ritorno delle ultime 6 ore. `24` - Condizioni meteorologiche di ritorno delle ultime 24 ore.
language	query		string	Lingua in cui devono essere restituiti i risultati della ricerca. Deve essere uno dei tag di lingua IETF supportati, senza distinzione tra maiuscole e minuscole. Quando i dati nella lingua specificata non sono disponibili per un campo specifico, viene usata la lingua predefinita. Per informazioni dettagliate, vedere lingue supportate.
unit	query		WeatherDataUnit	Specifica di restituire i dati in unità metriche o imperiali. Il valore predefinito è metrico.

Intestazione di richiesta

Nome	Necessario	Tipo	Descrizione
x-ms-client-id		string	Indica l'account destinato all'uso con il modello di sicurezza Microsoft Entra ID. Questo ID univoco per l'account Mappe di Azure può essere ottenuto dall'Account API Mappe di Azure piano di gestione. Per maggiori informazioni sull'uso della sicurezza Microsoft Entra ID in Mappe di Azure, vedi Gestire l'autenticazione in Mappe di Azure.

Risposte

Nome	Tipo	Descrizione
200 OK	CurrentConditionsResult	La richiesta ha avuto esito positivo.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

AadToken

Questi sono i flussi Microsoft Entra OAuth 2.0. Quando abbinata al controllo Azure basato su ruolo può essere utilizzata per controllare l'accesso alle API REST di Mappe di Azure. I controlli di accesso basati su ruoli di Azure sono utilizzati per designare l'accesso a uno o più account o sottorisorse risorse di Mappe di Azure. A qualsiasi utente, gruppo o entità servizio può essere concesso l'accesso tramite un ruolo predefinito o un ruolo personalizzato composto da una o più autorizzazioni per le API REST di Mappe di Azure.

Per implementare scenari, è consigliabile visualizzare concetti di autenticazione. In sintesi, questa definizione di sicurezza offre una soluzione per la modellazione di applicazioni tramite oggetti in grado di controllare l'accesso su API e ambiti specifici.

Note

Questa definizione di sicurezza richiede l'uso dell'intestazione x-ms-client-id per indicare a quale risorsa di Mappe di Azure l'applicazione richiede l'accesso. Questa operazione può essere acquisita dall'API di gestione di mappe .
Il Authorization URL è specifico dell'istanza del cloud pubblico di Azure. I cloud sovrani hanno URL di autorizzazione unici e configurazioni Microsoft Entra ID.
Il controllo degli accessi in base al ruolo di Azure viene configurato dal piano di gestione di Azure tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST.
L'utilizzo della Sdk Web di Mappe di Azure consente la configurazione basata sulla configurazione di un'applicazione per più casi d'uso.
Per altre informazioni su Microsoft Identity Platform, vedere panoramica di Microsoft Identity Platform.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://atlas.microsoft.com/.default

subscription-key

Si tratta di una chiave condivisa di cui viene effettuato il provisioning quando si Creare un account di Mappe di Azure nel portale di Azure o usando PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o l'API REST.

Con questa chiave, qualsiasi applicazione può accedere a tutte le API REST. In altre parole, questa chiave può essere usata come chiave master nell'account in cui vengono rilasciati.

Per le applicazioni esposte pubblicamente, è consigliabile usare l'approccio applicazioni client riservate per accedere alle API REST di Mappe di Azure in modo che la chiave possa essere archiviata in modo sicuro.

Tipo: apiKey
In: header

SAS Token

Si tratta di un token di firma di accesso condiviso creato dall'operazione List SAS nell'risorsa di Mappe di Azure tramite il piano di gestione di Azure tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST.

Con questo token, qualsiasi applicazione è autorizzata ad accedere ai controlli di accesso in base al ruolo di Azure e al controllo granulare per la scadenza, la frequenza e le aree d'uso per il token specifico. In altre parole, il token di firma di accesso condiviso può essere usato per consentire alle applicazioni di controllare l'accesso in modo più protetto rispetto alla chiave condivisa.

Per le applicazioni esposte pubblicamente, è consigliabile configurare un elenco specifico di origini consentite nella risorsa account mappa per limitare l'abuso di rendering e rinnovare regolarmente il token di firma di accesso condiviso.

Tipo: apiKey
In: header

Esempio

Successfully retrieve detailed current weather conditions for a given coordinate location

Esempio di richiesta

HTTP

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

Risposta di esempio

Codice di stato:: 200

{
  "results": [
    {
      "apparentTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 16.1
      },
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4359
      },
      "cloudCover": 95,
      "dateTime": "2019-11-14T15:08:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 9.2
      },
      "hasPrecipitation": false,
      "iconCode": 7,
      "isDayTime": true,
      "obstructionsToVisibility": "",
      "pastTwentyFourHourTemperatureDeparture": {
        "unit": "C",
        "unitType": 17,
        "value": 1.8
      },
      "phrase": "Cloudy",
      "precipitationSummary": {
        "past12Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past18Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past24Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past3Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past6Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past9Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "pastHour": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.5
        }
      },
      "pressure": {
        "unit": "mb",
        "unitType": 14,
        "value": 1014.9
      },
      "pressureTendency": {
        "code": "S",
        "localizedDescription": "Steady"
      },
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "realFeelTemperatureShade": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "relativeHumidity": 75,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.7
      },
      "temperatureSummary": {
        "past12Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past24Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past6Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 8.3
          }
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 8
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.4
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 3.6
        }
      },
      "windChillTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.9
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 4.9
        }
      }
    }
  ]
}

Definizioni

Nome	Descrizione
CurrentConditions	Un'unica osservazione meteorologica per la posizione specificata, restituita dall'operazione Get Current Conditions. A seconda della richiesta `duration`, questa osservazione può essere l'ultima (più recente) lettura o una delle osservazioni orarie precedenti. Di default viene restituito un sottoinsieme semplificato: data e ora dell'osservazione, frase meteorologica, codice icona, indicatore delle precipitazioni e temperatura. Quando la richiesta richiede tutti i dettagli, ogni proprietà viene inclusa, aggiungendo misurazioni come RealFeel, punto di rugiada, vento, visibilità, copertura nuvolosa, pressione e riepilogo delle precipitazioni e delle temperature delle ultime ore.
CurrentConditionsResult	La risposta restituita dall'operazione Get Current Conditions contiene una o più osservazioni di condizioni di corrente per una posizione specificata. Per impostazione predefinita, viene restituita una singola osservazione per il tempo presente; quando il parametro `duration` è impostato a 6 o 24, la risposta include anche un'osservazione per ogni ultima ora in quella finestra.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta comune all'errore per tutte le API di Azure Resource Manager per restituire dettagli di errore per operazioni fallite. Questo segue anche il formato di risposta di errore OData.
IconCode	Il codice numerico delle condizioni meteorologiche che identifica quale icona visualizzare. Ogni valore in questa enumerazione corrisponde a un'icona meteorologica di Mappe di Azure (come Sunny, Cloudy o Thunderstorms) e si abbina a una leggibile `iconPhrase` umana restituita accanto ad essa. Lo stesso codice può apparire nelle risposte attuali, orarie, giornaliere, trimestrali e minuto per minuto, permettendo alle applicazioni di visualizzare un set di icone coerente su tutti i servizi meteorologici. Per l'elenco completo dei codici, le icone a cui si mappano e gli esempi di immagini, vedi Weather services in Mappe di Azure.
JsonFormat	Formato desiderato della risposta. È supportato solo `json` formato.
PastHoursTemperature	Le temperature dell'aria più alte e più basse osservate durante una delle finestre mobili ( `TemperatureSummary` dopo 6, 12 o 24 ore), in gradi Celsius (°C) o Fahrenheit (°F) a seconda dell'unità specificata nella richiesta.
PrecipitationSummary	La precipitazione liquida equivalente totale caduta nel luogo di osservazione sopra finestre mobili che terminano al momento dell'osservazione. Ogni valore copre l'intera finestra misurata a partire da "ora" - ad esempio, `past3Hours` è il totale corrente delle ultime tre ore, non solo della terza ora - quindi le finestre si sovrappongono e le finestre più lunghe includono le precipitazioni riportate per quelle più brevi. Neve e ghiaccio contribuiscono con il loro equivalente fuso (liquido). Riportato in millimetri (mm) o pollici (in) a seconda dell'unità specificata nella richiesta.
PressureTendency	La recente tendenza alla pressione atmosferica - che la pressione stia aumentando, diminuendo o costante - è tornata sia come frase localizzata che come codice di una sola lettera. Utile per anticipare cambiamenti meteorologici a breve termine; la pressione in calo spesso segnala il deterioramento del tempo, mentre l'aumento della pressione indica tipicamente il miglioramento delle condizioni.
TemperatureSummary	Le temperature dell'aria più alte e più basse osservate nel luogo si trovano sopra finestre mobili che terminano al momento dell'osservazione. Ogni valore copre l'intera finestra misurata a partire da "ora" - ad esempio, `past12Hours` riporta il massimo e il minimo delle ultime 12 ore, non solo la dodicesima ora - quindi le finestre si sovrappongono e le finestre più lunghe includono le temperature riportate per quelle più brevi. Riportato in gradi Celsius (°C) o Fahrenheit (°F) a seconda dell'unità specificata nella richiesta.
UnitType	Un valore intero associato al tipo di unità visualizzata. Ad esempio, 17 per i gradi Celsius, 18 per i gradi Fahrenheit. Può essere utilizzato per la traslazione di unità. Per maggiori informazioni, vedi Servizi meteorologici a Mappe di Azure.
WeatherDataUnit	Specifica se restituire dati in unità metriche o imperiali, con metrica come predefinita. Per esempio: Metrica: millimetro (mm), metro (m), chilometro (km), Celsius (C) Imperiale: pollice (dentro), piede (piedi), miglio (mi), Fahrenheit (F)
WeatherValue	Valori per metriche legate al meteo come temperatura, punto di rugiada e velocità del vento, presentati in unità metriche o imperiali, come specificato nel parametro URI unitario. Per ulteriori informazioni, vedi Tipi di unità nell'articolo Weather services in Mappe di Azure.
WindDetails	Fornisce la velocità prevista del vento, misurata in unità come chilometri orari (km/h) o miglia orarie (mph), a seconda dell'unità specificata nella richiesta. Indica anche la direzione del vento misurata in gradi azimutali, partendo dal vero Nord e muovendosi in senso orario. Nord corrisponde a 0°, est a 90°, sud a 180° e ovest a 270°. I valori possibili variano da 0° a 359°.
WindDirection	Fornisce dettagli sulla direzione del vento, inclusa la direzione in gradi di azimut e un'abbreviazione localizzata della direzione del vento.

CurrentConditions

Oggetto

Un'unica osservazione meteorologica per la posizione specificata, restituita dall'operazione Get Current Conditions. A seconda della richiesta duration, questa osservazione può essere l'ultima (più recente) lettura o una delle osservazioni orarie precedenti. Di default viene restituito un sottoinsieme semplificato: data e ora dell'osservazione, frase meteorologica, codice icona, indicatore delle precipitazioni e temperatura. Quando la richiesta richiede tutti i dettagli, ogni proprietà viene inclusa, aggiungendo misurazioni come RealFeel, punto di rugiada, vento, visibilità, copertura nuvolosa, pressione e riepilogo delle precipitazioni e delle temperature delle ultime ore.

Nome	Tipo	Descrizione
apparentTemperature	WeatherValue	La temperatura apparente al momento dell'osservazione - come l'aria si percepisce realmente agli esseri umani, tenendo conto della temperatura dell'aria, dell'umidità relativa e della velocità del vento. Misurato in gradi Celsius (°C) o Fahrenheit (°F), a seconda dell'unità specificata nella richiesta.
ceiling	WeatherValue	Il soffitto delle nuvole al momento dell'osservazione - l'altezza sopra il suolo dello strato nuvoloso più basso - in piedi (ft) o metri (m) a seconda dell'unità specificata nella richiesta. Importante per l'aviazione, poiché influisce sulla visibilità e sulle operazioni di volo.
cloudCover	integer (int32)	La percentuale di cielo coperta da nuvole al momento dell'osservazione, da 0 (limpido) a 100 (coperto). Può essere NULL.
dateTime	string (date-time)	La data e l'ora di questa osservazione, in formato RFC 3339 (yyy-mm-ddThh:mm:ss-hh:mm). Ad esempio, 2025-04-29T07:00:00-07:00.
dewPoint	WeatherValue	Il punto di rugiada al momento dell'osservazione - la temperatura a cui l'aria deve raffreddarsi per diventare satura (100% l'umidità relativa). Misurato in gradi Celsius (°C) o Fahrenheit (°F), a seconda dell'unità specificata nella richiesta. Un punto di rugiada più alto indica più umidità nell'aria.
hasPrecipitation	boolean	`true` se precipitazioni (pioggia, neve, nevischio o grandine) si verificano al momento dell'osservazione; altrimenti `false`.
iconCode	IconCode	Il codice rappresentativo dell'icona meteorologica per questa osservazione, abbinato alla `phrase` proprietà. Il valore numerico corrisponde a un'icona meteo di Mappe di Azure - per l'elenco completo, vedi Servizi meteorologici in Mappe di Azure. Può essere NULL.
isDayTime	boolean	`true` se è giorno nel luogo specificato all'ora dell'osservazione; `false` se è notte.
obstructionsToVisibility	string	Un codice che identifica il fattore dominante che riduce la visibilità al momento dell'osservazione, come nebbia, fumo, foschia o precipitazioni. Utile per attività che dipendono da una visibilità chiara, come la guida e l'aviazione. Valori possibili: A = forti temporali/grandine BD = polvere soffiata BN = sabbia soffiatrice BS = neve che soffia D = polvere F = nebbia GF = nebbia del terreno HZ = foschia I = ghiaccio IC = cristalli di ghiaccio IF = nebbia di ghiaccio IP = pellet di ghiaccio IPW = doccia di pellet di ghiaccio K = fumo L = pioggerellina R = pioggia RS = pioggia/neve RW = acquazzone S = neve SG = granuli di neve SP = palline di neve SW = acquazza di neve T = temporale UP = precipitazioni indefinite ZL = pioggerellina gelata ZR = pioggia gelata + = pesante - = luce
pastTwentyFourHourTemperatureDeparture	WeatherValue	La variazione della temperatura dell'aria rispetto a 24 ore fa, in gradi Celsius (°C) o Fahrenheit (°F), a seconda dell'unità specificata nella richiesta. I valori positivi indicano che l'aria è più calda di ieri allo stesso momento; i valori negativi indicano che è più fredda.
phrase	string	Un termine descrittivo breve per le condizioni meteorologiche al momento dell'osservazione - ad esempio, Soleggiato o Parzialmente Nuvoloso. Si abbina a `iconCode`, che identifica l'icona meteo corrispondente. Per maggiori informazioni, vedi Servizi meteorologici a Mappe di Azure.
precipitationSummary	PrecipitationSummary	Un riepilogo delle quantità di precipitazioni liquide equivalenti nel luogo di osservazione durante le finestre mobili delle ultime 1, 3, 6, 9, 12, 18 e 24 ore, in millimetri (mm) o pollici (in) a seconda dell'unità specificata nella richiesta.
pressure	WeatherValue	La pressione atmosferica (dell'aria) a livello del suolo al momento dell'osservazione, in millibar (mb) o pollici di mercurio (inHg), a seconda dell'unità specificata nella richiesta.
pressureTendency	PressureTendency	La tendenza recente della pressione atmosferica - in aumento, in calo o costante. Utile per anticipare cambiamenti meteorologici a breve termine; la pressione in calo spesso segnala il deterioramento del tempo, mentre l'aumento della pressione indica tipicamente il miglioramento delle condizioni.
realFeelTemperature	WeatherValue	La temperatura RealFeel™ al momento dell'osservazione, in gradi Celsius (°C) o Fahrenheit (°F), a seconda dell'unità specificata nella richiesta. Sviluppato da AccuWeather, RealFeel combina la temperatura dell'aria con umidità, vento, copertura nuvolosa, intensità solare e altri fattori per indicare come si sente effettivamente il tempo. Per maggiori informazioni, vedi Qual è la temperatura RealFeel di AccuWeather?
realFeelTemperatureShade	WeatherValue	La temperatura RealFeel™ al momento dell'osservazione in aree ombreggiate, in gradi Celsius (°C) o Fahrenheit (°F), a seconda dell'unità specificata nella richiesta. Come `realFeelTemperature`, ma esclude l'effetto riscaldante della luce solare diretta, dando un'idea più precisa di come si sente il tempo all'ombra.
relativeHumidity	integer (int32)	L'umidità relativa al momento dell'osservazione, espressa come una percentuale da 0 a 100 della quantità massima di vapore acqueo che l'aria può trattenere alla stessa temperatura.
temperature	WeatherValue	La temperatura dell'aria al momento dell'osservazione, in gradi Celsius (°C) o Fahrenheit (°F), a seconda dell'unità specificata nella richiesta.
temperatureSummary	TemperatureSummary	Un riepilogo delle temperature dell'aria più alte e più basse osservate in questo luogo durante le finestre mobili delle ultime 6, 12 e 24 ore, in gradi Celsius (°C) o Fahrenheit (°F) a seconda dell'unità specificata nella richiesta.
uvIndex	integer (int32)	L'indice ultravioletto (UV) al momento dell'osservazione, indica il rischio di danni derivanti dall'esposizione solare non protetta. I valori supportati sono: 0-2: Basso pericolo per la persona media dei raggi UV del sole. 3-5: Rischio moderato di danni dovuti all'esposizione solare non protetta. 6-7: Alto rischio di danni dovuti all'esposizione solare non protetta. 8-10: Rischio molto alto di danni da esposizione solare non protetta. 11+: Rischio estremo di danni dovuti all'esposizione solare non protetta.
uvIndexPhrase	string	Una breve etichetta descrittiva per `uvIndex` - ad esempio, Bassa, Moderata, Alta, Molto Alta o Estrema.
visibility	WeatherValue	La visibilità orizzontale al momento dell'osservazione - la distanza alla quale un oggetto o una luce può essere chiaramente distinta - in chilometri (km) o miglia (mi) a seconda dell'unità specificata nella richiesta.
wetBulbTemperature	WeatherValue	La temperatura del bulbo umido al momento dell'osservazione - la temperatura che l'aria raggiungerebbe se raffreddata fino alla saturazione (100% di umidità relativa) evaporando acqua al suo interno a pressione costante. Misurato in gradi Celsius (°C) o Fahrenheit (°F), a seconda dell'unità specificata nella richiesta. Utile per valutare lo stress termico e il raffreddamento evaporativo.
wind	WindDetails	La velocità e la direzione del vento al momento dell'osservazione. La velocità è in chilometri orari (km/h) o miglia orarie (mph) a seconda dell'unità specificata nella richiesta; la direzione è in gradi azimutali, misurati in senso orario dal vero Nord (0° = N, 90° = E, 180° = S, 270° = W).
windChillTemperature	WeatherValue	La temperatura del vento al momento dell'osservazione - quanto l'aria si sente fredda sulla pelle esposta a causa dell'effetto combinato del vento e della bassa temperatura. Tipicamente più bassa della temperatura reale dell'aria. Misurato in gradi Celsius (°C) o Fahrenheit (°F), a seconda dell'unità specificata nella richiesta.
windGust	WindDetails	La velocità e direzione massima a brevi scatto di vento e raffiche al momento dell'osservazione, utilizzando le stesse unità e convenzione di azimut di `wind`. Le raffiche di vento sono brevi picchi di velocità che possono influenzare attività come l'aviazione, la vela, il volo di aquiloni e altri eventi all'aperto.

CurrentConditionsResult

Oggetto

La risposta restituita dall'operazione Get Current Conditions contiene una o più osservazioni di condizioni di corrente per una posizione specificata. Per impostazione predefinita, viene restituita una singola osservazione per il tempo presente; quando il parametro duration è impostato a 6 o 24, la risposta include anche un'osservazione per ogni ultima ora in quella finestra.

Nome	Tipo	Descrizione
results	CurrentConditions[]	Le osservazioni delle condizioni attuali, in ordine cronologico con la più recente per prima. Per impostazione predefinita, una singola voce - l'ultima osservazione viene restituito; la risposta può anche contenere una voce per ora in una finestra mobile recente (tipicamente nelle ultime 6 o 24 ore), a seconda della richiesta.

Nome

Tipo

Descrizione

results

CurrentConditions[]

Le osservazioni delle condizioni attuali, in ordine cronologico con la più recente per prima. Per impostazione predefinita, una singola voce - l'ultima osservazione

viene restituito; la risposta può anche contenere una voce per ora in una finestra mobile recente (tipicamente nelle ultime 6 o 24 ore), a seconda della richiesta.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info		Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta comune all'errore per tutte le API di Azure Resource Manager per restituire dettagli di errore per operazioni fallite. Questo segue anche il formato di risposta di errore OData.

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

IconCode

Enumerazione

Il codice numerico delle condizioni meteorologiche che identifica quale icona visualizzare. Ogni valore in questa enumerazione corrisponde a un'icona meteorologica di Mappe di Azure (come Sunny, Cloudy o Thunderstorms) e si abbina a una leggibile iconPhrase umana restituita accanto ad essa. Lo stesso codice può apparire nelle risposte attuali, orarie, giornaliere, trimestrali e minuto per minuto, permettendo alle applicazioni di visualizzare un set di icone coerente su tutti i servizi meteorologici.

Per l'elenco completo dei codici, le icone a cui si mappano e gli esempi di immagini, vedi Weather services in Mappe di Azure.

Valore	Descrizione
1	Sunny
2	Prevalentemente soleggiato
3	Parzialmente soleggiato
4	Cloud intermittenti
5	Sole velato
6	Principalmente nuvoloso
7	Cloudy
8	Cupo (coperto)
11	Fog
12	Showers
13	Perlopiù nuvoloso con rovesci
14	Parzialmente soleggiato con docce
15	Thunderstorms
16	Per lo più nuvoloso con temporali
17	Parzialmente soleggiato con temporali
18	Rain
19	Flurries
20	Per lo più nuvoloso con flurrie
21	Parzialmente soleggiato con nevischio
22	Snow
23	Per lo più nuvoloso con neve
24	Ice
25	Sleet
26	Pioggia gelata
29	Pioggia e neve
30	Hot
31	Cold
32	Windy
33	Chiaro
34	Per lo più chiaro
35	Parzialmente Nuvoloso
36	Cloud intermittenti
37	Luna velata
38	Principalmente nuvoloso
39	Parzialmente nuvoloso con rovesci
40	Perlopiù nuvoloso con rovesci
41	Parzialmente nuvoloso con temporali
42	Per lo più nuvoloso con temporali
43	Per lo più nuvoloso con flurrie
44	Per lo più nuvoloso con neve

JsonFormat

Enumerazione

Formato desiderato della risposta. È supportato solo json formato.

Valore	Descrizione
json	il formato dell'interscambio dati notazione oggetto JavaScript

PastHoursTemperature

Oggetto

Le temperature dell'aria più alte e più basse osservate durante una delle finestre mobili ( TemperatureSummary dopo 6, 12 o 24 ore), in gradi Celsius (°C) o Fahrenheit (°F) a seconda dell'unità specificata nella richiesta.

Nome	Tipo	Descrizione
maximum	WeatherValue	La temperatura più alta osservata durante la finestra.
minimum	WeatherValue	La temperatura più bassa osservata durante la finestra.

PrecipitationSummary

Oggetto

La precipitazione liquida equivalente totale caduta nel luogo di osservazione sopra finestre mobili che terminano al momento dell'osservazione. Ogni valore copre l'intera finestra misurata a partire da "ora" - ad esempio, past3Hours è il totale corrente delle ultime tre ore, non solo della terza ora - quindi le finestre si sovrappongono e le finestre più lunghe includono le precipitazioni riportate per quelle più brevi. Neve e ghiaccio contribuiscono con il loro equivalente fuso (liquido). Riportato in millimetri (mm) o pollici (in) a seconda dell'unità specificata nella richiesta.

Nome	Tipo	Descrizione
past12Hours	WeatherValue	Precipitazioni liquide equivalenti che sono cadute nelle ultime 12 ore.
past18Hours	WeatherValue	Precipitazioni liquide equivalenti che sono cadute nelle ultime 18 ore.
past24Hours	WeatherValue	Precipitazioni liquide equivalenti che sono calate nelle ultime 24 ore.
past3Hours	WeatherValue	Precipitazioni liquide equivalenti che sono cadute nelle ultime 3 ore.
past6Hours	WeatherValue	Precipitazioni liquide equivalenti che sono cadute nelle ultime 6 ore.
past9Hours	WeatherValue	Precipitazioni liquide equivalenti che sono cadute nelle ultime 9 ore.
pastHour	WeatherValue	Precipitazioni liquide equivalenti che sono cadute nell'ultima ora.

PressureTendency

Oggetto

La recente tendenza alla pressione atmosferica - che la pressione stia aumentando, diminuendo o costante - è tornata sia come frase localizzata che come codice di una sola lettera. Utile per anticipare cambiamenti meteorologici a breve termine; la pressione in calo spesso segnala il deterioramento del tempo, mentre l'aumento della pressione indica tipicamente il miglioramento delle condizioni.

Nome	Tipo	Descrizione
code	string	Un codice indipendente dalla lingua di una lettera per la tendenza della pressione: F = Cadente, S = Stabile, R = Risalita.
localizedDescription	string	Una breve frase che descrive la tendenza alla pressione - ad esempio, Caduta, Costante o Risalente - restituiva nel linguaggio specificato nella richiesta.

TemperatureSummary

Oggetto

Le temperature dell'aria più alte e più basse osservate nel luogo si trovano sopra finestre mobili che terminano al momento dell'osservazione. Ogni valore copre l'intera finestra misurata a partire da "ora" - ad esempio, past12Hours riporta il massimo e il minimo delle ultime 12 ore, non solo la dodicesima ora - quindi le finestre si sovrappongono e le finestre più lunghe includono le temperature riportate per quelle più brevi. Riportato in gradi Celsius (°C) o Fahrenheit (°F) a seconda dell'unità specificata nella richiesta.

Nome	Tipo	Descrizione
past12Hours	PastHoursTemperature	Temperature più alte e più basse osservate nelle ultime 12 ore.
past24Hours	PastHoursTemperature	Temperature più alte e più basse registrate nelle ultime 24 ore.
past6Hours	PastHoursTemperature	Temperature più alte e più basse registrate nelle ultime 6 ore.

UnitType

Enumerazione

Un valore intero associato al tipo di unità visualizzata. Ad esempio, 17 per i gradi Celsius, 18 per i gradi Fahrenheit. Può essere utilizzato per la traslazione di unità. Per maggiori informazioni, vedi Servizi meteorologici a Mappe di Azure.

Valore	Descrizione
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	galleggiare
22	numero intero
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Enumerazione

Specifica se restituire dati in unità metriche o imperiali, con metrica come predefinita. Per esempio:

Metrica: millimetro (mm), metro (m), chilometro (km), Celsius (C)
Imperiale: pollice (dentro), piede (piedi), miglio (mi), Fahrenheit (F)

Valore	Descrizione
imperial	Restituisci i dati usando unità imperiali come Fahrenheit (F) per la temperatura e miglia (mi) per la distanza.
metric	Restituisci i dati utilizzando unità metriche come Celsius (C) per la temperatura e chilometro (km) per la distanza.

WeatherValue

Oggetto

Valori per metriche legate al meteo come temperatura, punto di rugiada e velocità del vento, presentati in unità metriche o imperiali, come specificato nel parametro URI unitario. Per ulteriori informazioni, vedi Tipi di unità nell'articolo Weather services in Mappe di Azure.

Nome	Tipo	Descrizione
unit	string	L'unità di misura utilizzata nel valore di ritorno, come "C" per Celsius, "F" per Fahrenheit.
unitType	UnitType	Un intero che rappresenta il tipo di unità. Per esempio, 0 per piedi, 1 per pollici, 2 per miglia. Per un elenco completo, vedi Tipi di unità nell'articolo Servizi meteorologici in Mappe di Azure.
value	number (float)	Il valore misurato espresso nell'unità specificata.

WindDetails

Oggetto

Fornisce la velocità prevista del vento, misurata in unità come chilometri orari (km/h) o miglia orarie (mph), a seconda dell'unità specificata nella richiesta. Indica anche la direzione del vento misurata in gradi azimutali, partendo dal vero Nord e muovendosi in senso orario. Nord corrisponde a 0°, est a 90°, sud a 180° e ovest a 270°. I valori possibili variano da 0° a 359°.

Nome	Tipo	Descrizione
direction	WindDirection	La direzione del vento si misura in gradi azimutali, partendo dal vero Nord (0°) e muovendosi in senso orario. A est corrisponde a 90°, a sud a 180° e a ovest a 270°. I valori possibili variano da 0° a 359°. Questa proprietà restituisce un intero che rappresenta la direzione del vento.
speed	WeatherValue	La velocità del vento attesa, misurata in chilometri orari, km/h, o miglia orarie (mph), a seconda dell'unità specificata nella richiesta.

WindDirection

Oggetto

Fornisce dettagli sulla direzione del vento, inclusa la direzione in gradi di azimut e un'abbreviazione localizzata della direzione del vento.

Nome	Tipo	Descrizione
degrees	integer (int32)	La direzione del vento è misurata in gradi azimutali, partendo dal vero Nord e muovendosi in senso orario. Nord corrisponde a 0 gradi, est a 90 gradi, sud a 180 gradi e ovest a 270 gradi. I valori possibili variano da 0 a 359 gradi.
localizedDescription	string	Un'abbreviazione localizzata della direzione del vento, restituita nella lingua specificata nella richiesta. Ad esempio, `N` per Nord, `E` per Est, `S` per Sud e `W` per Ovest.