Weather - Get Weather Along Route
Usare per ottenere una previsione accurata e precisa in base al minuto che include valutazioni dei rischi meteorologici e notifiche lungo un percorso.
L'API Get Weather Along Route
è una richiesta HTTP GET
che restituisce hyper local (un chilometro o meno), ora meteo fino al minuto, valutazioni dei rischi meteorologici e notifiche lungo un percorso descritto come una sequenza di punti di direzione.
Questo include un elenco di pericoli meteorologici che interessano il punto di strada o il percorso e l'indice di pericolo aggregato per ogni punto di navigazione può essere utilizzato per disegnare ogni parte di un percorso in base a quanto sia sicuro per il conducente. Quando si inviano i punti di marcia, è consigliabile rimanere all'interno o vicino a, la distanza che può essere viaggiata entro 120 minuti o poco dopo. I dati vengono aggiornati ogni cinque minuti.
Il servizio integra il servizio di route di Mappe di Azure che consente di richiedere prima una route tra un'origine e una destinazione e usarla come input per l'endpoint Weather Along Route.
Inoltre, il servizio supporta gli scenari per generare notifiche meteo per i waypoint che riscontrano un aumento dell'intensità di un rischio meteorologico. Ad esempio, se si prevede che il veicolo inizi a riscontrare una pioggia intensa mentre raggiunge un punto di arrivo, verrà generata una notifica meteo per il punto di pioggia intenso che consente al prodotto finale di visualizzare una notifica di pioggia intensa prima che il conducente raggiunga tale punto di arrivo. Il trigger per quando visualizzare la notifica per un punto di percorso può essere basato, ad esempio, su un recinto virtuale o su una distanza selezionabile per il punto di percorso.
L'API copre tutte le regioni del pianeta, ad eccezione delle latitudine sopra la Groenlandia e l'Antartide.
GET https://atlas.microsoft.com/weather/route/json?api-version=1.1&query={query}
GET https://atlas.microsoft.com/weather/route/json?api-version=1.1&query={query}&language={language}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
format
|
path | True |
Formato desiderato della risposta. È supportato solo il formato |
|
api-version
|
query | True |
string |
Numero di versione dell'API Mappe di Azure. |
query
|
query | True |
string |
Coordinate attraverso cui viene calcolato il percorso, separato da due punti (:) e immesso in ordine cronologico. È necessario un minimo di due punti di direzione. Una singola chiamata API può contenere fino a 60 punti di direzione. Un punto di direzione indica la posizione, l'ETA e l'intestazione facoltativa: latitudine, longitudine, ETA, intestazione, dove
Si consiglia di rimanere all'interno o vicino a, la distanza che può essere viaggiato entro 120 minuti o poco dopo. In questo modo è possibile fornire una valutazione più accurata per il viaggio e impedire l'acquisizione di eventi isolati tra punti di direzione. Le informazioni possono e devono essere aggiornate lungo il percorso (soprattutto per i viaggi superiori a 2 ore) per tirare continuamente nuovi punti di marcia in avanti, ma anche per garantire che le informazioni di previsione per il contenuto, ad esempio il tipo di precipitazione e l'intensità, siano accurate man mano che le tempeste si sviluppano e si disssipano nel tempo. |
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 . |
Intestazione della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
x-ms-client-id |
string |
Specifica l'account destinato all'utilizzo in combinazione con il modello di sicurezza Microsoft Entra ID. Rappresenta un ID univoco per l'account Mappe di Azure e può essere recuperato dall'API del piano di gestione mappe di Azure. Per usare la sicurezza di Microsoft Entra ID in Mappe di Azure, vedere gli articoli seguenti per indicazioni. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Si è verificato un errore imprevisto. |
Sicurezza
AADToken
Si tratta dei flussi Microsoft Entra OAuth 2.0 . Se abbinato al controllo degli accessi in base al ruolo di Azure , può essere usato per controllare l'accesso alle API REST di Mappe di Azure. I controlli di accesso in base al ruolo di Azure vengono usati per designare l'accesso a uno o più account di risorse di Mappe di Azure o a risorse secondarie. 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 i 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 mappe .
è Authorization URL
specifico dell'istanza del cloud pubblico di Azure. I cloud sovrani hanno URL di autorizzazione univoci e configurazioni ID Microsoft Entra.
* 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 di Azure Maps Web SDK 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 | https://atlas.microsoft.com/.default |
subscription-key
Si tratta di una chiave condivisa di cui viene effettuato il provisioning quando si crea un account 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 alle 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:
query
SAS Token
Si tratta di un token di firma di accesso condiviso creato dall'operazione Elenca firma di accesso condiviso nella risorsa 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 con i controlli di accesso in base al ruolo di Azure e il controllo granulare alla scadenza, alla frequenza e alle 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 dell'account map per limitare l'abuso di rendering e rinnovare regolarmente il token di firma di accesso condiviso.
Tipo:
apiKey
In:
header
Esempio
Successfully retrieve detailed weather casts along a route described as a sequence of waypoints
Esempio di richiesta
GET https://atlas.microsoft.com/weather/route/json?api-version=1.1&query=38.907,-77.037,0:38.907,-77.009,10:38.926,-76.928,20:39.033,-76.852,30:39.168,-76.732,40:39.269,-76.634,50:39.287,-76.612,60
Risposta di esempio
{
"summary": {
"iconCode": 35,
"hazards": {
"maxHazardIndex": 0
}
},
"waypoints": [
{
"iconCode": 38,
"shortPhrase": "Mostly cloudy",
"isDayTime": false,
"cloudCover": 70,
"temperature": {
"value": 3.4,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 142
},
"speed": {
"value": 2,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 3,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 90,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
},
{
"iconCode": 38,
"shortPhrase": "Mostly cloudy",
"isDayTime": false,
"cloudCover": 65,
"temperature": {
"value": 3.4,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 166
},
"speed": {
"value": 1,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 2,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 77,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
},
{
"iconCode": 35,
"shortPhrase": "Partly cloudy",
"isDayTime": false,
"cloudCover": 43,
"temperature": {
"value": 3.2,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 163
},
"speed": {
"value": 2,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 2,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 44,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
},
{
"iconCode": 35,
"shortPhrase": "Partly cloudy",
"isDayTime": false,
"cloudCover": 34,
"temperature": {
"value": 1.6,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 189
},
"speed": {
"value": 2,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 4,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 32,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
},
{
"iconCode": 38,
"shortPhrase": "Mostly cloudy",
"isDayTime": false,
"cloudCover": 54,
"temperature": {
"value": 0.5,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 202
},
"speed": {
"value": 4,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 5,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 36,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
},
{
"iconCode": 35,
"shortPhrase": "Partly cloudy",
"isDayTime": false,
"cloudCover": 46,
"temperature": {
"value": 2.4,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 222
},
"speed": {
"value": 4,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 5,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 38,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
},
{
"iconCode": 35,
"shortPhrase": "Partly cloudy",
"isDayTime": false,
"cloudCover": 39,
"temperature": {
"value": 2.3,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 231
},
"speed": {
"value": 4,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 5,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 43,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Error |
Informazioni aggiuntive sulla gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Hazard |
|
Hazard |
Indice di gravità/rischio.
|
Icon |
Valore numerico che rappresenta un'immagine che visualizza . |
Json |
Formato desiderato della risposta. È supportato solo il formato |
Sun |
Classificazione che indica come è cieco il sole per il conducente. |
Unit |
Valore ID numerico associato al tipo di unità visualizzata. Può essere usato per la traduzione unità. Per informazioni dettagliate, vedere Servizi meteo in Mappe di Azure . |
Weather |
Previsione delle precipitazioni del tempo lungo il percorso. |
Weather |
Questo oggetto viene restituito da un percorso meteo riuscito. |
Weather |
Breve riepilogo del tempo lungo il percorso. |
Weather |
Descrizione del rischio meteorologico che influisce sul viaggio. |
Weather |
|
Weather |
Valore specifico di una determinata unità correlata al meteo. |
Weather |
|
Wind |
I dettagli del vento vengono restituiti, tra cui velocità e direzione. |
Wind |
Direzione del vento |
ErrorAdditionalInfo
Informazioni aggiuntive sulla gestione delle risorse.
Nome | Tipo | Descrizione |
---|---|---|
info |
object |
Informazioni aggiuntive. |
type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalInfo |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
HazardDetail
Nome | Tipo | Descrizione |
---|---|---|
hazardCode |
string |
Identificatore univoco (non visualizzabile) per ogni tipo di pericolo: LightRain, ModerateRain, HeavyRain, LightMix, ModerateMix, HeavyMix, LightSnow, ModerateSnow, HeavySnow, LightIce, ModerateIce, HeavyIce, HeavyIce, Hail, LargeHail, SunGlare, SunGlareHigh, Lightning, SevereLightning, WindModerate, WindHigh, WindAccount, FloodWarning, FlashFloodWarning, TornadoWarning, TsunamiWarning, SevereThunderstormWarning. |
hazardIndex |
Indice di gravità/rischio.
|
|
shortPhrase |
string |
Una frase breve visualizzabile che descrive le condizioni previste e l'intensità di precipitazione/tipo. |
HazardIndex
Indice di gravità/rischio.
-
0
- Nessun rischio. -
1
- Essere informati, essere consapevoli. -
2
- Prestare attenzione, essere preparati. -
3
-Agire. -
4
- Pericolo di vita, emergenza.
Nome | Tipo | Descrizione |
---|---|---|
0 |
Integer |
|
1 |
Integer |
|
2 |
Integer |
|
3 |
Integer |
|
4 |
Integer |
IconCode
Valore numerico che rappresenta un'immagine che visualizza .iconPhrase
Per informazioni dettagliate, vedere Servizi meteo in Mappe di Azure .
Nome | Tipo | Descrizione |
---|---|---|
1 |
Integer |
|
10 |
Integer |
|
11 |
Integer |
|
12 |
Integer |
|
13 |
Integer |
|
14 |
Integer |
|
15 |
Integer |
|
16 |
Integer |
|
17 |
Integer |
|
18 |
Integer |
|
19 |
Integer |
|
2 |
Integer |
|
20 |
Integer |
|
21 |
Integer |
|
22 |
Integer |
|
23 |
Integer |
|
24 |
Integer |
|
25 |
Integer |
|
26 |
Integer |
|
27 |
Integer |
|
28 |
Integer |
|
29 |
Integer |
|
3 |
Integer |
|
30 |
Integer |
|
31 |
Integer |
|
32 |
Integer |
|
33 |
Integer |
|
34 |
Integer |
|
35 |
Integer |
|
36 |
Integer |
|
37 |
Integer |
|
38 |
Integer |
|
39 |
Integer |
|
4 |
Integer |
|
40 |
Integer |
|
41 |
Integer |
|
42 |
Integer |
|
43 |
Integer |
|
44 |
Integer |
|
5 |
Integer |
|
6 |
Integer |
|
7 |
Integer |
|
8 |
Integer |
|
9 |
Integer |
JsonFormat
Formato desiderato della risposta. È supportato solo il formato json
.
Nome | Tipo | Descrizione |
---|---|---|
json |
string |
SunGlare
Classificazione che indica come è cieco il sole per il conducente.
Nome | Tipo | Descrizione |
---|---|---|
calculatedVehicleHeading |
integer |
Se il valore dell'intestazione del veicolo non viene fornito per un punto di modo, il servizio calcola un titolo in base alla posizione dei punti di strada vicini se specificato. |
glareIndex |
integer |
Indice compreso tra 0 e 100 che indica l'intensità del sole per un driver. Un valore pari a 50 e sopra può essere considerato un rischio per alcuni conducenti e un valore di 100 indica che il conducente sta guidando direttamente al sole e le condizioni atmosferiche sono chiare consentendo l'intensità piena del sole per accecare il conducente. |
UnitType
Valore ID numerico associato al tipo di unità visualizzata. Può essere usato per la traduzione unità. Per informazioni dettagliate, vedere Servizi meteo in Mappe di Azure .
Nome | Tipo | Descrizione |
---|---|---|
0 |
Integer |
|
1 |
Integer |
|
10 |
Integer |
|
11 |
Integer |
|
12 |
Integer |
|
13 |
Integer |
|
14 |
Integer |
|
15 |
Integer |
|
16 |
Integer |
|
17 |
Integer |
|
18 |
Integer |
|
19 |
Integer |
|
2 |
Integer |
|
20 |
Integer |
|
21 |
Integer |
|
22 |
Integer |
|
3 |
Integer |
|
31 |
Integer |
|
4 |
Integer |
|
5 |
Integer |
|
6 |
Integer |
|
7 |
Integer |
|
8 |
Integer |
|
9 |
Integer |
WeatherAlongRoutePrecipitation
Previsione delle precipitazioni del tempo lungo il percorso.
Nome | Tipo | Descrizione |
---|---|---|
dbz |
number |
L'intensità di precipitazione prevista in dBZ (decibels rispetto alla Z) da 0,0 a 100,0. |
type |
string |
Tipo di precipitazione. Se le precipitazioni devono verificarsi, il tipo che sarà: "PIOGGIA", "HAIL", "SNOW", "ICE" o "MIX". |
WeatherAlongRouteResult
Questo oggetto viene restituito da un percorso meteo riuscito.
Nome | Tipo | Descrizione |
---|---|---|
summary |
Breve riepilogo del tempo lungo il percorso. |
|
waypoints |
Dati per ogni punto di modo restituito nello stesso ordine specificato nella richiesta. |
WeatherAlongRouteSummary
Breve riepilogo del tempo lungo il percorso.
Nome | Tipo | Descrizione |
---|---|---|
hazards |
Descrizione del rischio meteorologico che influisce sul viaggio. |
|
iconCode |
Valore numerico che rappresenta un'immagine che visualizza . |
WeatherHazards
Descrizione del rischio meteorologico che influisce sul viaggio.
Nome | Tipo | Descrizione |
---|---|---|
hazardDetails |
Dettagli dei rischi meteorologici che interessano il viaggio. |
|
maxHazardIndex |
Indice di gravità/rischio.
|
WeatherNotification
Nome | Tipo | Descrizione |
---|---|---|
hazardCode |
string |
Identificatore univoco (non visualizzabile) per ogni tipo di pericolo: LightRain, ModerateRain, HeavyRain, LightMix, ModerateMix, HeavyMix, LightSnow, ModerateSnow, HeavySnow, LightIce, ModerateIce, HeavyIce, HeavyIce, Hail, LargeHail, SunGlare, SunGlareHigh, Lightning, SevereLightning, WindModerate, WindHigh, WindAccount, FloodWarning, FlashFloodWarning, TornadoWarning, TsunamiWarning, SevereThunderstormWarning. |
hazardIndex |
Indice di gravità/rischio.
|
|
shortPhrase |
string |
Una frase breve visualizzabile che descrive le condizioni previste e l'intensità di precipitazione/tipo. |
type |
string |
Tipo di notifica generato per avvisare i conducenti dell'inizio di un pericolo o aumentare l'intensità di un rischio. |
WeatherUnit
Valore specifico di una determinata unità correlata al meteo.
Nome | Tipo | Descrizione |
---|---|---|
unit |
string |
Tipo di unità per il valore restituito. |
unitType |
Valore ID numerico associato al tipo di unità visualizzata. Può essere usato per la traduzione unità. Per informazioni dettagliate, vedere Servizi meteo in Mappe di Azure . |
|
value |
number |
Valore arrotondato. |
WeatherWaypoint
Nome | Tipo | Descrizione |
---|---|---|
cloudCover |
integer |
Percentuale che rappresenta la copertura cloud. |
hazards |
Descrizione del rischio meteorologico che influisce sul viaggio. |
|
iconCode |
Valore numerico che rappresenta un'immagine che visualizza . |
|
isDayTime |
boolean |
Indica l'ora del giorno. True indica "giorno", false indica "notte". |
lightningCount |
integer |
Stima dell'intensità del temporale su una scala aperta. Un valore pari a 0 significa che non c'è alcun temporale; valori di 1 e maggiore media c'è un temporale in maggiore intensità. |
notifications |
Elenco delle notifiche di rischio meteo. |
|
precipitation |
Previsione delle precipitazioni del tempo lungo il percorso. |
|
shortPhrase |
string |
Una frase breve visualizzabile che descrive le condizioni previste e l'intensità di precipitazione/tipo. |
sunGlare |
Classificazione che indica come è cieco il sole per il conducente. |
|
temperature |
Valore specifico di una determinata unità correlata al meteo. |
|
wind |
I dettagli del vento vengono restituiti, tra cui velocità e direzione. |
|
windGust |
I dettagli del vento vengono restituiti, tra cui velocità e direzione. |
WindDetails
I dettagli del vento vengono restituiti, tra cui velocità e direzione.
Nome | Tipo | Descrizione |
---|---|---|
direction |
Direzione del vento |
|
speed |
Velocità del vento nell'unità specificata. |
WindDirection
Direzione del vento
Nome | Tipo | Descrizione |
---|---|---|
degrees |
integer |
Direzione del vento in gradi Azimuth, a partire da true Nord e continuando in direzione orario. Nord è 0 gradi, est è 90 gradi, sud è 180 gradi, ovest è 270 gradi. Valori possibili da 0 a 359. |
localizedDescription |
string |
Abbreviazione di direzione nella lingua specificata. |