Weather - Get Daily Forecast

Service:: Maps

Versione API:: 1.1

Utilizzare per ottenere previsioni meteo dettagliate giornaliere per i prossimi 1, 5, 10, 15, 25 o 45 giorni.
L'API Get Daily Forecast è una richiesta HTTP GET che restituisce previsioni meteorologiche dettagliate, come la temperatura e il vento di giorno, per i prossimi 1, 5, 10, 15, 25 o 45 giorni per una determinata posizione di coordinate. La risposta include dettagli come temperatura, vento, precipitazioni, qualità dell'aria e indice UV. Per ulteriori informazioni, vedere Richiedere i dati delle previsioni meteo giornaliere.

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

Con parametri facoltativi:

GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}&unit={unit}&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.
duration	query		integer (int32)	Specifica il numero di giorni in cui vengono restituite le risposte di previsione giornaliere. I valori disponibili sono `1` - Restituisce i dati delle previsioni per il giorno successivo. Restituito per impostazione predefinita. `5` - Restituisci i dati di previsione per i prossimi 5 giorni. `10` - Restituisci i dati di previsione per i prossimi 10 giorni. `25` - Restituisci i dati di previsione per i prossimi 25 giorni. `45` - Restituisci i dati di previsione per i prossimi 45 giorni.
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	DailyForecastResult	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 daily weather forecast for a given coordinate location

Esempio di richiesta

HTTP

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5

Risposta di esempio

Codice di stato:: 200

{
  "forecasts": [
    {
      "airAndPollen": [
        {
          "name": "AirQuality",
          "type": "Ozone",
          "category": "Good",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Grass",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Mold",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Ragweed",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Tree",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "UVIndex",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        }
      ],
      "date": "2019-11-13T21:00:00-08:00",
      "day": {
        "cloudCover": 100,
        "hasPrecipitation": true,
        "hoursOfIce": 0,
        "hoursOfPrecipitation": 3.5,
        "hoursOfRain": 3.5,
        "hoursOfSnow": 0,
        "ice": {
          "unit": "mm",
          "unitType": 3,
          "value": 0
        },
        "iceProbability": 0,
        "iconCode": 12,
        "iconPhrase": "Showers",
        "longPhrase": "Cloudy with a couple of showers, mainly later",
        "precipitationIntensity": "Light",
        "precipitationProbability": 75,
        "precipitationType": "Rain",
        "rain": {
          "unit": "mm",
          "unitType": 3,
          "value": 6.1
        },
        "rainProbability": 75,
        "shortPhrase": "Cloudy with a few showers",
        "snow": {
          "unit": "cm",
          "unitType": 4,
          "value": 0
        },
        "snowProbability": 40,
        "thunderstormProbability": 20,
        "totalLiquid": {
          "unit": "mm",
          "unitType": 3,
          "value": 6.1
        },
        "wind": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 16.7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 48.2
          }
        }
      },
      "degreeDaySummary": {
        "cooling": {
          "unit": "C",
          "unitType": 17,
          "value": 0
        },
        "heating": {
          "unit": "C",
          "unitType": 17,
          "value": 15
        }
      },
      "hoursOfSun": 1.1,
      "night": {
        "cloudCover": 98,
        "hasPrecipitation": true,
        "hoursOfIce": 0,
        "hoursOfPrecipitation": 2.5,
        "hoursOfRain": 2.5,
        "hoursOfSnow": 0,
        "ice": {
          "unit": "mm",
          "unitType": 3,
          "value": 0
        },
        "iceProbability": 0,
        "iconCode": 12,
        "iconPhrase": "Showers",
        "longPhrase": "Breezy this evening; otherwise, low clouds",
        "precipitationIntensity": "Light",
        "precipitationProbability": 65,
        "precipitationType": "Rain",
        "rain": {
          "unit": "mm",
          "unitType": 3,
          "value": 4
        },
        "rainProbability": 64,
        "shortPhrase": "Breezy early; cloudy",
        "snow": {
          "unit": "cm",
          "unitType": 4,
          "value": 0
        },
        "snowProbability": 40,
        "thunderstormProbability": 0,
        "totalLiquid": {
          "unit": "mm",
          "unitType": 3,
          "value": 4
        },
        "wind": {
          "direction": {
            "degrees": 181,
            "localizedDescription": "S"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 20.4
          }
        },
        "windGust": {
          "direction": {
            "degrees": 170,
            "localizedDescription": "S"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 42.6
          }
        }
      },
      "realFeelTemperature": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 1.3
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": -3.4
        }
      },
      "realFeelTemperatureShade": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 1.6
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": -3.4
        }
      },
      "sources": [
        "AccuWeather"
      ],
      "temperature": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 5.3
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": 0.8
        }
      }
    }
  ],
  "summary": {
    "category": "rain",
    "endDate": "2019-11-17T15:00:00-08:00",
    "phrase": "Rain Sunday evening",
    "severity": 5,
    "startDate": "2019-11-17T09:00:00-08:00"
  }
}

Definizioni

Nome	Descrizione
AirAndPollen	Una voce che `DailyForecast.airAndPollen` descrive un singolo indicatore di polline, qualità dell'aria o indice UV per la giornata. La `name` proprietà determina quale tipo di indicatore rappresenta la voce: Polline: `name` è Albero, Erba, Ambrosia o Muffa. `value` fornisce l'importo previsto e `category` / `categoryValue` lo valuti da Basso a Alto. Qualità dell'aria: `name` è qualità dell'aria e `type` identifica l'inquinante misurato ( uno di PM2.5, PM10, O3, NO2, SO2 o CO). `category` / `categoryValue` valuta la qualità dell'aria da Buona a Pericolosa. Indice UV: `name` è UVIndex. `value` è l'indice UV (0 a 11+), e `category` / `categoryValue` si valuta il rischio di esposizione da Basso a Estremo. `category` è l'etichetta qualitativa dell'indicatore e `categoryValue` è la valutazione corrispondente da 1 a 6, dove 1 indica le condizioni più sicure e 6 le più pericolose.
DailyForecast	La previsione per un giorno di calendario nella posizione specificata restituiva una voce al giorno nell'array `forecasts` su `DailyForecastResult`. Include l'intervallo di temperatura alta/bassa del giorno, intervalli RealFeel (normali e ombreggiati), ore di sole previste, totali di calore/raffreddamento gradi-giorno, una serie di indicatori di qualità dell'aria, polline e indice UV, e blocchi di dettaglio separati per le porzioni diurne e notturna (precipitazioni, vento, copertura nuvolosa e altro ancora). L'array `sources` elenca i fornitori di dati che contribuiscono alla previsione.
DailyForecastDetail	Dettagli previsti per mezza giornata. La stessa forma viene usata sia `DailyForecast.day` per (dall'alba al tramonto) sia `DailyForecast.night` per (dal tramonto all'alba successiva), quindi tutti i riferimenti a "questo periodo" qui sotto indicano quella specifica porzione diurna o notturna - mai l'intera giornata di 24 ore. Include un'icona di previsione e frasi, tipo/intensità/probabilità di precipitazione, totali di accumulo, ore di precipitazione, vento e copertura nuvolosa.
DailyForecastResult	La risposta è stata restituita dall'operazione Get Daily Forecast, fornendo una previsione meteo giorno per giorno per una località specifica. Include un livello `summary` principale che descrive le condizioni dominanti e la gravità per la finestra richiesta, oltre a un `forecasts` array con una `DailyForecast` voce al giorno. Il numero di candidature corrisponde a quello richiesto `duration` (1, 5, 10, 15, 25 o 45 giorni; 25 e 45 richiedono una SKU S1).
DailyForecastSummary	Un riassunto a alto livello delle condizioni meteorologiche dominanti su parte o tutta la finestra di previsione giornaliera richiesta. La finestra riassunta può essere più stretta della richiesta completa - ad esempio, quando si prevede condizioni meteorologiche significative (come un sistema di tempesta) solo per una parte del periodo - ed è delimitata da `startDate` e `endDate`. Le condizioni stesse sono descritte sia come una forma `phrase`libera, un'etichetta di una o due parole `category` e una valutazione numerica `severity` .
DegreeDaySummary	I totali di grado giorno-riscaldamento e raffreddamento per un singolo giorno, utilizzati per stimare la domanda energetica per il riscaldamento o il raffreddamento di un edificio. Ogni valore è il numero di gradi di cui la temperatura media giornaliera differisce dalla linea di base a 65°F (18°C ), nell'unità di temperatura specificata nella richiesta - i gradi sotto la linea di base contribuiscono a `heating`, gradi sopra di essa contribuiscono a `cooling`.
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.
LocalSource	Informazioni su un fornitore locale di dati meteorologici utilizzato per ottenere la previsione su `DailyForecastDetail.localSource`. Identifica il provider (`id`, `name`) ed espone il suo nativo `weatherCode` in modo che le applicazioni possano visualizzare l'insieme di icone del provider invece delle icone predefinite di Mappe di Azure.
PrecipitationType	Specifica il tipo di precipitazione. I valori validi sono Pioggia, Neve, Ghiaccio o Miscela. Questa proprietà è inclusa nella risposta quando dBZ è maggiore di zero.
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.
WeatherValueRange	Fornisce le temperature previste più alte e più basse per il periodo specificato, misurate in gradi Celsius (°C) o Fahrenheit (°F), in base all'unità specificata nella richiesta.
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.

AirAndPollen

Oggetto

Una voce che DailyForecast.airAndPollen descrive un singolo indicatore di polline, qualità dell'aria o indice UV per la giornata. La name proprietà determina quale tipo di indicatore rappresenta la voce:

Polline: name è Albero, Erba, Ambrosia o Muffa. value fornisce l'importo previsto e category / categoryValue lo valuti da Basso a Alto.
Qualità dell'aria: name è qualità dell'aria e type identifica l'inquinante misurato ( uno di PM2.5, PM10, O3, NO2, SO2 o CO). category / categoryValue valuta la qualità dell'aria da Buona a Pericolosa.
Indice UV: name è UVIndex. value è l'indice UV (0 a 11+), e category / categoryValue si valuta il rischio di esposizione da Basso a Estremo.

category è l'etichetta qualitativa dell'indicatore e categoryValue è la valutazione corrispondente da 1 a 6, dove 1 indica le condizioni più sicure e 6 le più pericolose.

Nome	Tipo	Descrizione
category	string	Una breve etichetta qualitativa per l'indicatore, restituita nella lingua specificata nella richiesta. I valori possibili dipendono da `name`: Polline: basso, moderato, alto o molto alto. Qualità dell'aria: Buona, Moderata, Malsana per i gruppi sensibili, Malsana, Molto malsana o Pericolosa. Indice UV: Basso, Moderato, Alto, Molto Alto o Estremo.
categoryValue	integer (int32)	Un valore numerico da 1 a 6 che si abbina a `category`, dove 1 indica le condizioni più sicure e 6 le più pericolose. Usalo quando è necessario un valore numerico stabile e indipendente dalla lingua al posto dell'etichetta localizzata `category` .
name	string	Identifica quale indicatore rappresenta questa voce. O il nome di una fonte di polline (Albero, Erba, Ambrosia o Muffa), Qualità dell'aria (in tal `type` caso identifica l'inquinante) o UVIndex.
type	string	Quando `name` si verifica AirQuality, l'inquinante specifico misurato uno di PM2.5, PM10, O3 (ozono), NO2 (anidride di azoto), SO2 (anidride di zolfo) o CO (monossido di carbonio). Non è stato restituito per le voci di polline o UV.
value	integer (int32)	La misura numerica per questo indicatore. L'unità dipende da:`name` Per il polline, il conteggio del polline previsto. Per la qualità dell'aria, la concentrazione di inquinanti in unità appropriate all'inquinante - tipicamente microgrammi per metro cubo (μg/m³) per il particolato e parti per miliardo (ppb) per gas come l'ozono. Per l'indice UV, un valore di indice da 0 a 11+. Sia la qualità dell'aria che l'indice UV sono essi stessi indici, quindi sono riportati come numeri senza unità.

DailyForecast

Oggetto

La previsione per un giorno di calendario nella posizione specificata restituiva una voce al giorno nell'array forecasts su DailyForecastResult. Include l'intervallo di temperatura alta/bassa del giorno, intervalli RealFeel (normali e ombreggiati), ore di sole previste, totali di calore/raffreddamento gradi-giorno, una serie di indicatori di qualità dell'aria, polline e indice UV, e blocchi di dettaglio separati per le porzioni diurne e notturna (precipitazioni, vento, copertura nuvolosa e altro ancora). L'array sources elenca i fornitori di dati che contribuiscono alla previsione.

Nome	Tipo	Descrizione
airAndPollen	AirAndPollen[]	Indicatori previsti di qualità dell'aria, polline e indice UV per la giornata. Ogni voce riporta un nome (come Albero, Erba, Ambrosia, Muffa, Qualità dell'aria o UVIndex), un valore numerico e un valore qualitativo `category` (come Basso, Moderato, Alto, Buono, Non Sano o Pericoloso) affinché le applicazioni possano segnalare i potenziali rischi per la salute.
date	string (date-time)	La data calendaria coperta da questa previsione, in formato ISO 8601 (`yyyy-mm-ddThh:mm:ss-hh:mm`). Ad esempio, 2025-04-29T07:00:00-07:00.
day	DailyForecastDetail	Le previsioni dettagliate per la parte diurna della giornata - inclusi temperatura, precipitazioni, vento, copertura nuvolosa e altri attributi chiave.
degreeDaySummary	DegreeDaySummary	I totali di riscaldamento e raffreddamento al giorno di gradi, utilizzati per stimare la domanda energetica per il controllo climatico degli edifici.
hoursOfSun	number (float)	Il numero previsto di ore di sole durante il giorno, utile per pianificare attività all'aperto e valutare le condizioni generali diurne.
night	DailyForecastDetail	Le previsioni dettagliate per la parte notturna della giornata - inclusi temperatura, precipitazioni, vento, copertura nuvolosa e altri attributi chiave.
realFeelTemperature	WeatherValueRange	I valori di temperatura RealFeel™ elevati e bassi per la giornata, 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	WeatherValueRange	I valori di temperatura RealFeel™ alti e bassi per la giornata sono 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.
sources	string[]	I fornitori di dati che hanno contribuito alla previsione di oggi.
temperature	WeatherValueRange	Le temperature dell'aria previste per la giornata, sia in gradi Celsius (°C) che Fahrenheit (°F), a seconda dell'unità specificata nella richiesta.

DailyForecastDetail

Oggetto

Dettagli previsti per mezza giornata. La stessa forma viene usata sia DailyForecast.day per (dall'alba al tramonto) sia DailyForecast.night per (dal tramonto all'alba successiva), quindi tutti i riferimenti a "questo periodo" qui sotto indicano quella specifica porzione diurna o notturna - mai l'intera giornata di 24 ore. Include un'icona di previsione e frasi, tipo/intensità/probabilità di precipitazione, totali di accumulo, ore di precipitazione, vento e copertura nuvolosa.

Nome	Tipo	Descrizione
cloudCover	integer (int32)	La percentuale di cielo coperto da nuvole in questo periodo da 0 (cielo limpido) a 100 (completamente coperto). Può essere NULL.
hasPrecipitation	boolean	`true` se durante questo periodo si prevedono precipitazioni (pioggia, neve, nevischio o grandine); `false` altrimenti.
hoursOfIce	number (float)	Il numero totale di ore durante questo periodo in cui si prevede la formazione di ghiaccio.
hoursOfPrecipitation	number (float)	Il numero totale di ore in questo periodo in cui si prevede precipitazioni (pioggia, neve, nevischio o grandine).
hoursOfRain	number (float)	Il numero totale di ore in questo periodo in cui si prevede pioggia.
hoursOfSnow	number (float)	Il numero totale di ore in questo periodo in cui si prevede la neve.
ice	WeatherValue	La quantità di accumulo di ghiaccio prevista in questo periodo, in millimetri (mm) o pollici (in), a seconda dell'unità specificata nella richiesta.
iceProbability	integer (int32)	La probabilità di formazione di ghiaccio durante questo periodo, espressa in percentuale da 0 a 100, dove 0 significa nessuna possibilità di ghiaccio e 100 significa condizioni di ghiaccio certe.
iconCode	IconCode	Valore numerico che rappresenta un'immagine che corrisponde alle condizioni meteorologiche previste per questo periodo, descritte dalla `iconPhrase` 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.
iconPhrase	string	Una breve frase che descrive l'icona, restituita nella lingua specificata nella richiesta. Per esempio, Sunny.
localSource	LocalSource	Informazioni sul fornitore locale di dati meteorologici il cui codice icona e il codice meteorologico sono stati utilizzati per questo periodo, quando è stato selezionato uno.
longPhrase	string	Una frase più lunga e descrittiva per questo periodo, restituita nel linguaggio specificato nella richiesta. Mappe di Azure cerca di mantenere questa frase sotto i 100 caratteri, ma alcune lingue o eventi meteorologici possono produrre una stringa più lunga.
precipitationIntensity	string	Una breve descrizione qualitativa dell'intensità delle precipitazioni per questo periodo - ad esempio, Leggera, Moderata o Intensa. Restituito nel linguaggio specificato nella richiesta, e solo quando `hasPrecipitation` è `true`.
precipitationProbability	integer (int32)	La probabilità di qualsiasi precipitazione durante questo periodo, espressa come percentuale da 0 a 100, dove 0 significa nessuna probabilità di precipitazione e 100 significa che precipitazioni è certa.
precipitationType	PrecipitationType	Il tipo dominante di precipitazione previsto in questo periodo è pioggia, neve, ghiaccio o miscela. Restituito solo quando `hasPrecipitation` è `true`.
rain	WeatherValue	La quantità di pioggia prevista in questo periodo, in millimetri (mm) o pollici (in), a seconda dell'unità specificata nella richiesta.
rainProbability	integer (int32)	La probabilità di pioggia durante questo periodo, espressa in percentuale da 0 a 100, dove 0 significa nessuna probabilità di pioggia e 100 significa che pioggia è certa.
shortPhrase	string	Una breve frase che descrive la previsione per questo periodo, restituita nel linguaggio specificato nella richiesta. Mappe di Azure cerca di mantenere questa frase sotto i 30 caratteri, ma alcune lingue o eventi meteorologici possono produrre una stringa più lunga.
snow	WeatherValue	La quantità di neve accumulata prevista in questo periodo, in centimetri (cm) o pollici (in), a seconda dell'unità specificata nella richiesta.
snowProbability	integer (int32)	La probabilità di neve in questo periodo, espressa in percentuale da 0 a 100, dove 0 significa nessuna probabilità di neve e 100 significa che la neve è certa.
thunderstormProbability	integer (int32)	La probabilità di un temporale durante questo periodo, espressa in percentuale da 0 a 100, dove 0 significa nessuna probabilità di temporale e 100 significa che un temporale è certa.
totalLiquid	WeatherValue	La quantità totale di precipitazioni liquide (come la pioggia, più l'equivalente liquido di neve o ghiaccio) prevista durante questo periodo, in millimetri (mm) o pollici (in) a seconda dell'unità specificata nella richiesta.
wind	WindDetails	La velocità e la direzione previste del vento per questo periodo. La velocità del vento è in chilometri orari (km/h) o miglia orarie (mph) a seconda dell'unità specificata nella richiesta. La direzione del vento si misura in gradi azimutali, da 0° (nord vero) a 359°, muovendosi in senso orario - est è 90°, sud 180°, ovest 270°.
windGust	WindDetails	La velocità massima prevista per brevi saffi di vento durante questo periodo. Le raffiche di vento sono improvvisi e brevi aumenti della velocità del vento che contano per attività come l'aviazione, la vela e il volo degli aquiloni. La velocità è in chilometri orari (km/h) o miglia orarie (mph) a seconda dell'unità specificata nella richiesta, e la direzione utilizza la stessa convenzione azimutale di `wind`.

DailyForecastResult

Oggetto

La risposta è stata restituita dall'operazione Get Daily Forecast, fornendo una previsione meteo giorno per giorno per una località specifica. Include un livello summary principale che descrive le condizioni dominanti e la gravità per la finestra richiesta, oltre a un forecasts array con una DailyForecast voce al giorno. Il numero di candidature corrisponde a quello richiesto duration (1, 5, 10, 15, 25 o 45 giorni; 25 e 45 richiedono una SKU S1).

Nome Tipo Descrizione

forecasts

Nome	Tipo	Descrizione
forecasts	DailyForecast[]	Le previsioni giornaliere, in ordine cronologico con una voce al giorno nel richiesto `duration`. Ogni voce riporta `DailyForecast` le temperature massime/minime del giorno, l'intervallo RealFeel, le ore di sole, i totali di calore/raffreddamento tra gradi e giorni, gli indici di aria e polline, blocchi di dettaglio separati tra giorno e notte (precipitazioni, vento, copertura nuvolosa e altro ancora), e le fonti di dati che contribuiscono alla previsione.
summary	DailyForecastSummary	Un riassunto a alto livello delle condizioni meteorologiche dominanti nella finestra di previsione richiesta. Il riassunto può coprire solo una parte della finestra ad esempio, quando si prevede condizioni meteorologiche significative (come un sistema temporale) durante una parte di esso - anziché per l'intero periodo.

DailyForecast[]

Le previsioni giornaliere, in ordine cronologico con una voce al giorno nel richiesto duration. Ogni voce riporta DailyForecast le temperature massime/minime del giorno, l'intervallo RealFeel, le ore di sole, i totali di calore/raffreddamento tra gradi e giorni, gli indici di aria e polline, blocchi di dettaglio separati tra giorno e notte (precipitazioni, vento, copertura nuvolosa e altro ancora), e le fonti di dati che contribuiscono alla previsione.

summary

DailyForecastSummary

Un riassunto a alto livello delle condizioni meteorologiche dominanti nella finestra di previsione richiesta. Il riassunto può coprire solo una parte della finestra

ad esempio, quando si prevede condizioni meteorologiche significative (come un sistema temporale) durante una parte di esso - anziché per l'intero periodo.

DailyForecastSummary

Oggetto

Un riassunto a alto livello delle condizioni meteorologiche dominanti su parte o tutta la finestra di previsione giornaliera richiesta. La finestra riassunta può essere più stretta della richiesta completa - ad esempio, quando si prevede condizioni meteorologiche significative (come un sistema di tempesta) solo per una parte del periodo - ed è delimitata da startDate e endDate. Le condizioni stesse sono descritte sia come una forma phraselibera, un'etichetta di una o due parole category e una valutazione numerica severity .

Nome	Tipo	Descrizione
category	string	Un'etichetta di una o due parole che categorizza le condizioni meteorologiche dominanti per la finestra riassunta - ad esempio, Soleata, Parzialmente Nuvolosa, Pioggia o Nevicata.
endDate	string (date-time)	La fine della finestra coperta da questo riassunto, in formato RFC 3339 - ad esempio, 2019-10-29T07:00:00-08:00. Può avvenire prima della fine della finestra di previsione richiesta se l'evento riassunto termina prima.
phrase	string	Un breve riassunto testuale libero delle condizioni meteorologiche dominanti per la finestra riassunta, restituito nel linguaggio specificato nella richiesta. Ad esempio, prevedetevi piogge da martedì a giovedì.
severity	integer (int32)	Una valutazione numerica di gravità per l'evento meteorologico riassunto. Numeri più bassi ( escluso 0) indicano una gravità maggiore: 0: Sconosciuto 1: Significativo 2: Maggiore 3: Moderato 4: Minore 5: Minimale 6: Insignificante 7: Informativo
startDate	string (date-time)	L'inizio della finestra coperta da questo riassunto, in formato RFC 3339 - ad esempio, 2019-10-27T19:39:57-08:00. Può essere più tardi dell'inizio della finestra di previsione richiesta se l'evento riassunto inizia a metà di essa.

DegreeDaySummary

Oggetto

I totali di grado giorno-riscaldamento e raffreddamento per un singolo giorno, utilizzati per stimare la domanda energetica per il riscaldamento o il raffreddamento di un edificio. Ogni valore è il numero di gradi di cui la temperatura media giornaliera differisce dalla linea di base a 65°F (18°C ), nell'unità di temperatura specificata nella richiesta - i gradi sotto la linea di base contribuiscono a heating, gradi sopra di essa contribuiscono a cooling.

Nome	Tipo	Descrizione
cooling	WeatherValue	Temperature di Grado Giorno di Raffreddamento (CDD) - il numero di gradi in cui la temperatura media del giorno supera la linea di base di 65°F (18°C). Valori più alti indicano una maggiore richiesta di raffreddamento. Riportato in gradi Celsius (°C) o Fahrenheit (°F) a seconda dell'unità specificata nella richiesta.
heating	WeatherValue	Giorni di Grado di Riscaldamento (HDD) - il numero di gradi in cui la temperatura media del giorno scende sotto la linea di base di 65°F (18°C). Valori più alti indicano una maggiore domanda di riscaldamento. Riportato in gradi Celsius (°C) o Fahrenheit (°F) a seconda dell'unità specificata nella 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

LocalSource

Oggetto

Informazioni su un fornitore locale di dati meteorologici utilizzato per ottenere la previsione su DailyForecastDetail.localSource. Identifica il provider (id, name) ed espone il suo nativo weatherCode in modo che le applicazioni possano visualizzare l'insieme di icone del provider invece delle icone predefinite di Mappe di Azure.

Nome	Tipo	Descrizione
id	integer (int32)	Un identificatore numerico che identifica in modo univoco il fornitore locale dei dati.
name	string	Il nome del fornitore locale di dati, restituito nella lingua specificata nella richiesta quando disponibile; altrimenti restituito in inglese o nella lingua in cui il fornitore lo forniva.
weatherCode	string	Il codice meteorologico nativo del provider per questa previsione, adatto per la mappatura al set di icone del provider invece che con Mappe di Azure `iconCode`predefinito.

PrecipitationType

Enumerazione

Specifica il tipo di precipitazione. I valori validi sono Pioggia, Neve, Ghiaccio o Miscela. Questa proprietà è inclusa nella risposta quando dBZ è maggiore di zero.

Valore	Descrizione
Ice	Ice
Mix	Mix
Rain	Rain
Snow	Snow

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.

WeatherValueRange

Oggetto

Fornisce le temperature previste più alte e più basse per il periodo specificato, misurate in gradi Celsius (°C) o Fahrenheit (°F), in base all'unità specificata nella richiesta.

Nome	Tipo	Descrizione
maximum	WeatherValue	Fornisce la temperatura massima per il periodo di tempo specificato, misurata in gradi Celsius (°C) o Fahrenheit (°F), in base all'unità specificata nella richiesta.
minimum	WeatherValue	Fornisce la temperatura minima per il periodo di tempo specificato, misurata in gradi Celsius (°C) o Fahrenheit (°F), in base all'unità specificata nella richiesta.

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.