Weather - Get Weather Along Route
Usare per ottenere una previsione precisa e precisa in base al minuto che include valutazioni e notifiche dei rischi meteorologici lungo un percorso.
L'API Get Weather Along Route
è una richiesta HTTP GET
che restituisce hyper local (un chilometro o meno), ora ora meteo fino al minuto, valutazioni dei rischi meteorologici e notifiche lungo una route descritta come una sequenza di punti di modo.
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 uscita può essere usato per disegnare ogni parte di un percorso in base al modo in cui è sicuro per il conducente. Quando si inviano i punti di via, è consigliabile rimanere all'interno o vicino, la distanza che può essere viaggiata entro 120 minuti o poco dopo. I dati vengono aggiornati ogni cinque minuti.
Il servizio integra Mappe di Azure Servizio route 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 scenari per generare notifiche meteo per i punti di modo che riscontrano un aumento dell'intensità di un pericolo meteorologico. Ad esempio, se il veicolo dovrebbe iniziare a riscontrare una pioggia pesante mentre raggiunge un punto di modo, verrà generata una notifica meteo per il punto di pioggia pesante che consente al prodotto finale di visualizzare una notifica di pioggia pesante prima che il conducente raggiunga tale punto. Il trigger per quando visualizzare la notifica per un punto di modo può essere basato, ad esempio, su un geofence o su una distanza selezionabile al punto di modo.
L'API copre tutte le regioni del pianeta, ad eccezione delle latitudine sopra la Groenlandia e dell'Antartica.
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 calcolata la route, separata da due punti (:) e immessa in ordine cronologico. È necessario un minimo di due punti di modalità. Una singola chiamata API può contenere fino a 60 waypoint. Un punto di modo indica la posizione, l'ETA e l'intestazione facoltativa: latitudine, longitudine,ETA,intestazione, dove
È consigliabile rimanere all'interno o vicino, la distanza che può essere viaggiata 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 strada. Le informazioni possono e devono essere aggiornate lungo il percorso (soprattutto per i viaggi superiori a 2 ore) per tirare continuamente nuovi punti di strada in avanti, ma anche per garantire che le informazioni di previsione per il contenuto, ad esempio il tipo di precipitazione e l'intensità, siano accurati come le tempeste si sviluppano e disssiseguono nel tempo. |
language
|
query |
string |
Lingua in cui devono essere restituiti i risultati della ricerca. Deve essere uno dei tag del linguaggio 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 Microsoft Entra ID sicurezza 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 OAuth 2.0 Microsoft Entra. Quando è associato al controllo degli accessi in base al ruolo di Azure, può essere usato per controllare l'accesso alle API REST Mappe di Azure. I controlli di accesso basati sul ruolo di Azure vengono usati per designare l'accesso a uno o più Mappe di Azure account delle risorse o alle sotto-risorse. 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 Mappe di Azure API REST.
Per implementare scenari, è consigliabile visualizzare i concetti di autenticazione. In riepilogo, questa definizione di sicurezza offre una soluzione per la modellazione di applicazioni tramite oggetti in grado di controllare l'accesso in API e ambiti specifici.
Note
- Questa definizione di sicurezza richiede l'uso dell'intestazione
x-ms-client-id
per indicare quale Mappe di Azure risorsa a cui l'applicazione richiede l'accesso. Questa operazione può essere acquisita dall'API di gestione mappe .
L'oggetto Authorization URL
è specifico dell'istanza del cloud pubblico di Azure. I cloud sovrani hanno URL di autorizzazione univoci e configurazioni Microsoft Entra ID.
* Il controllo degli accessi in base al ruolo di Azure viene configurato dal piano di gestione di Azure tramite portale di Azure, PowerShell, interfaccia della riga di comando, SDK di Azure o API REST.
* L'utilizzo dell'SDK Web 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 Microsoft Identity Platform.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Descrizione |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Si tratta di una chiave condivisa di cui viene eseguito il provisioning quando si Create un account Mappe di Azure nell'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 delle applicazioni client riservate per accedere alle API REST Mappe di Azure in modo che la chiave possa essere archiviata in modo sicuro.
Type:
apiKey
In:
query
SAS Token
Si tratta di un token di firma di accesso condiviso creato dall'operazione Elenco firma di accesso condiviso nella risorsa Mappe di Azure tramite il piano di gestione di Azure tramite portale di Azure, PowerShell, interfaccia della riga di comando, SDK di Azure o API REST.
Con questo token, qualsiasi applicazione è autorizzata ad accedere con i controlli di accesso basati sul 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 account mappa per limitare l'abuso di rendering e rinnovare regolarmente il token di firma di accesso condiviso.
Type:
apiKey
In:
header
Esempio
Successfully retrieve detailed weather casts along a route described as a sequence of waypoints
Sample Request
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
Sample Response
{
"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
- Eseguire l'azione.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. |