Weather - Get Weather Along Route
Use para obter uma previsão localmente precisa e atualizada que inclua avaliações e notificações de risco climático ao longo de uma rota.
A Get Weather Along Route
API é uma solicitação HTTP GET
que retorna hiper local (um quilômetro ou menos), agoracasts de clima de até o minuto, avaliações de risco meteorológico e notificações ao longo de uma rota descrita como uma sequência de pontos de passagem.
Isso inclui uma lista de riscos climáticos que afetam o ponto de passagem ou a rota, e o índice de risco agregado para cada ponto de passagem pode ser usado para pintar cada parte de uma rota de acordo com o quão seguro é para o driver. Ao enviar os pontos de passagem, é recomendável permanecer dentro ou perto da distância que pode ser percorrida dentro de 120 minutos ou pouco depois. Os dados são atualizados a cada cinco minutos.
O serviço complementa Azure Mapas Serviço de Rota que permite primeiro solicitar uma rota entre uma origem e um destino e usá-la como uma entrada para o ponto de extremidade Weather Along Route.
Além disso, o serviço dá suporte a cenários para gerar notificações meteorológicas para pontos de passagem que experimentam um aumento na intensidade de um risco climático. Por exemplo, se espera-se que o veículo comece a sofrer chuva forte à medida que atinge um ponto de passagem, uma notificação meteorológica para chuva forte será gerada para esse ponto de passagem, permitindo que o produto final exiba uma notificação de chuva forte antes que o motorista atinja esse ponto de passagem. O gatilho para quando exibir a notificação de um ponto de passagem pode ser baseado, por exemplo, em uma cerca geográfica ou em uma distância selecionável até o ponto de passagem.
A API abrange todas as regiões do planeta, exceto latitudes acima da Groenlândia e da Antártida.
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}
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
format
|
path | True |
Formato desejado da resposta. Há suporte apenas para o formato |
|
api-version
|
query | True |
string |
Número de versão da API de Mapas Azure. |
query
|
query | True |
string |
Coordenadas por meio das quais a rota é calculada, separada por dois-pontos (:) e inserida em ordem cronológica. É necessário um mínimo de dois pontos de passagem. Uma única chamada à API pode conter até 60 pontos de passagem. Um ponto de passagem indica localização, ETA e título opcional: latitude, longitude, ETA, título, onde
É recomendável ficar dentro ou perto da distância que pode ser percorrida dentro de 120 minutos ou pouco depois. Dessa forma, uma avaliação mais precisa pode ser fornecida para a viagem e impedir que eventos isolados não sejam capturados entre pontos de passagem. As informações podem e devem ser atualizadas ao longo da rota (especialmente para viagens maiores que 2 horas) para puxar continuamente novos pontos de passagem, mas também para garantir que as informações de previsão para o conteúdo, como tipo de precipitação e intensidade, sejam precisas à medida que as tempestades se desenvolvem e se dissipam ao longo do tempo. |
language
|
query |
string |
Idioma no qual os resultados da pesquisa devem ser retornados. Deve ser uma das marcas de linguagem IETF com suporte, que não diferencia maiúsculas de minúsculas. Quando os dados no idioma especificado não estão disponíveis para um campo específico, o idioma padrão é usado. Consulte Idiomas com suporte para obter detalhes. |
Cabeçalho da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
x-ms-client-id |
string |
Especifica qual conta destina-se ao uso em conjunto com o modelo de segurança Microsoft Entra ID. Ele representa uma ID exclusiva para a conta Azure Mapas e pode ser recuperado da API de Conta do plano de gerenciamento do Azure Mapas. Para usar Microsoft Entra ID segurança no Azure Mapas consulte os artigos a seguir para obter diretrizes. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Erro inesperado. |
Segurança
AADToken
Esses são os fluxos Microsoft Entra OAuth 2.0. Quando emparelhado com o controle de acesso baseado em função do Azure, ele pode ser usado para controlar o acesso às APIs REST Azure Mapas. Os controles de acesso baseados em função do Azure são usados para designar o acesso a uma ou mais Azure Mapas conta de recurso ou sub-recursos. Qualquer usuário, grupo ou entidade de serviço pode receber acesso por meio de uma função interna ou uma função personalizada composta por uma ou mais permissões para Azure Mapas APIs REST.
Para implementar cenários, recomendamos exibir conceitos de autenticação. Em resumo, essa definição de segurança fornece uma solução para modelar aplicativos por meio de objetos capazes de acessar o controle em APIs e escopos específicos.
Observações
- Essa definição de segurança requer o uso do
x-ms-client-id
cabeçalho para indicar a qual Azure Mapas recurso ao qual o aplicativo está solicitando acesso. Isso pode ser adquirido da API de gerenciamento de Mapas .
O Authorization URL
é específico para a instância de nuvem pública do Azure. As nuvens soberanas têm URLs de autorização exclusivas e configurações de Microsoft Entra ID.
* O controle de acesso baseado em função do Azure é configurado no plano de gerenciamento do Azure por meio de portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST.
* O uso do SDK da Web Azure Mapas permite a configuração baseada em configuração de um aplicativo para vários casos de uso.
- Para obter mais informações sobre plataforma de identidade da Microsoft, consulte visão geral plataforma de identidade da Microsoft.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Essa é uma chave compartilhada provisionada quando você Create uma conta Azure Mapas no portal do Azure ou usando o PowerShell, a CLI, os SDKs do Azure ou a API REST.
Com essa chave, qualquer aplicativo pode acessar toda a API REST. Em outras palavras, essa chave pode ser usada como uma chave master na conta em que elas são emitidas.
Para aplicativos expostos publicamente, nossa recomendação é usar a abordagem de aplicativos cliente confidenciais para acessar Azure Mapas APIs REST para que sua chave possa ser armazenada com segurança.
Type:
apiKey
In:
query
SAS Token
Esse é um token de assinatura de acesso compartilhado criado a partir da operação Listar SAS no recurso Azure Mapas por meio do plano de gerenciamento do Azure por meio de portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST.
Com esse token, qualquer aplicativo está autorizado a acessar com controles de acesso baseados em função do Azure e controle refinado à expiração, taxa e regiões de uso para o token específico. Em outras palavras, o Token SAS pode ser usado para permitir que os aplicativos controlem o acesso de maneira mais segura do que a chave compartilhada.
Para aplicativos expostos publicamente, nossa recomendação é configurar uma lista específica de origens permitidas no recurso de conta do Mapa para limitar o abuso de renderização e renovar regularmente o Token SAS.
Type:
apiKey
In:
header
Exemplos
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": []
}
]
}
Definições
Nome | Description |
---|---|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
Os detalhes do erro. |
Error |
Resposta de erro |
Hazard |
|
Hazard |
Um índice de gravidade/risco.
|
Icon |
Valor numérico que representa uma imagem que exibe o |
Json |
Formato desejado da resposta. Há suporte apenas para o formato |
Sun |
Uma classificação que indica o quão cego o sol é para o driver. |
Unit |
Valor de ID numérica associado ao tipo de unidade que está sendo exibida. Pode ser usado para tradução de unidade. Consulte Serviços meteorológicos em Azure Mapas para obter detalhes. |
Weather |
Previsão de precipitação do tempo ao longo da rota. |
Weather |
Esse objeto é retornado de um Weather Along Route bem-sucedido. |
Weather |
Breve resumo do tempo ao longo da rota. |
Weather |
Descrição do risco climático que afeta a viagem. |
Weather |
|
Weather |
Valor específico de uma determinada unidade relacionada ao clima. |
Weather |
|
Wind |
Detalhes do vento sendo retornados, incluindo velocidade e direção. |
Wind |
Direção do vento |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
Nome | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informação adicional. |
ErrorDetail
Os detalhes do erro.
Nome | Tipo | Description |
---|---|---|
additionalInfo |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
Nome | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
HazardDetail
Nome | Tipo | Description |
---|---|---|
hazardCode |
string |
Um identificador exclusivo (não exibivel) para cada tipo de risco: LightRain, ModerateRain, HeavyRain, LightMix, ModerateMix, HeavyMix, LightSnow, ModerateSnow, HeavySnow, LightIce, ModerateIce, HeavyIce, Hail, LargeHail, SunGlare, SunGlareHigh, Lightning, SevereLightning, WindModerate, WindHigh, WindExtreme, FloodWarning, FlashFloodWarning, TornadoWarning, TsunamiWarning, SevereThunderstormWarning. |
hazardIndex |
Um índice de gravidade/risco.
|
|
shortPhrase |
string |
Uma frase curta exibivel que descreve as condições previstas e a intensidade/tipo de precipitação. |
HazardIndex
Um índice de gravidade/risco.
0
- Sem perigo.1
- Seja informado, esteja ciente.2
- Preste atenção, esteja preparado.3
- Tome medidas.4
- Risco de vida, emergência.
Nome | Tipo | Description |
---|---|---|
0 |
Integer |
|
1 |
Integer |
|
2 |
Integer |
|
3 |
Integer |
|
4 |
Integer |
IconCode
Valor numérico que representa uma imagem que exibe o iconPhrase
. Consulte Serviços meteorológicos em Azure Mapas para obter detalhes.
Nome | Tipo | Description |
---|---|---|
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 desejado da resposta. Há suporte apenas para o formato json
.
Nome | Tipo | Description |
---|---|---|
json |
string |
O formato de intercâmbio de dados de notação de objeto JavaScript |
SunGlare
Uma classificação que indica o quão cego o sol é para o driver.
Nome | Tipo | Description |
---|---|---|
calculatedVehicleHeading |
integer |
Se o valor do título do veículo não for fornecido para um ponto de passagem, o serviço calculará um título com base no local dos pontos de passagem vizinhos, se fornecido. |
glareIndex |
integer |
Um índice de 0 a 100 indicando intensidade de brilho solar para um driver. Um valor de 50 ou mais pode ser considerado um risco para alguns motoristas e um valor de 100 significa que o motorista está dirigindo direto para o sol e as condições atmosféricas estão claras permitindo que toda a intensidade do sol cegar o motorista. |
UnitType
Valor de ID numérica associado ao tipo de unidade que está sendo exibida. Pode ser usado para tradução de unidade. Consulte Serviços meteorológicos em Azure Mapas para obter detalhes.
Nome | Tipo | Description |
---|---|---|
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
Previsão de precipitação do tempo ao longo da rota.
Nome | Tipo | Description |
---|---|---|
dbz |
number |
A intensidade de precipitação prevista no dBZ (decibéis relativos a Z) de 0,0 a 100,0. |
type |
string |
Tipo de precipitação. Se a precipitação deve ocorrer, o tipo que será: "CHUVA", "GRANIZO", "NEVE", "GELO" ou "MIX". |
WeatherAlongRouteResult
Esse objeto é retornado de um Weather Along Route bem-sucedido.
Nome | Tipo | Description |
---|---|---|
summary |
Breve resumo do tempo ao longo da rota. |
|
waypoints |
Dados para cada ponto de passagem retornados na mesma ordem especificada na solicitação. |
WeatherAlongRouteSummary
Breve resumo do tempo ao longo da rota.
Nome | Tipo | Description |
---|---|---|
hazards |
Descrição do risco climático que afeta a viagem. |
|
iconCode |
Valor numérico que representa uma imagem que exibe o |
WeatherHazards
Descrição do risco climático que afeta a viagem.
Nome | Tipo | Description |
---|---|---|
hazardDetails |
Detalhes dos riscos climáticos que afetam a viagem. |
|
maxHazardIndex |
Um índice de gravidade/risco.
|
WeatherNotification
Nome | Tipo | Description |
---|---|---|
hazardCode |
string |
Um identificador exclusivo (não exibivel) para cada tipo de risco: LightRain, ModerateRain, HeavyRain, LightMix, ModerateMix, HeavyMix, LightSnow, ModerateSnow, HeavySnow, LightIce, ModerateIce, HeavyIce, Hail, LargeHail, SunGlare, SunGlareHigh, Lightning, SevereLightning, WindModerate, WindHigh, WindExtreme, FloodWarning, FlashFloodWarning, TornadoWarning, TsunamiWarning, SevereThunderstormWarning. |
hazardIndex |
Um índice de gravidade/risco.
|
|
shortPhrase |
string |
Uma frase curta exibivel que descreve as condições previstas e a intensidade/tipo de precipitação. |
type |
string |
Um tipo de notificação gerada para alertar os motoristas sobre o início de um risco ou aumentar a intensidade de um risco. |
WeatherUnit
Valor específico de uma determinada unidade relacionada ao clima.
Nome | Tipo | Description |
---|---|---|
unit |
string |
Tipo de unidade para o valor retornado. |
unitType |
Valor de ID numérica associado ao tipo de unidade que está sendo exibida. Pode ser usado para tradução de unidade. Consulte Serviços meteorológicos em Azure Mapas para obter detalhes. |
|
value |
number |
Valor arredondado. |
WeatherWaypoint
Nome | Tipo | Description |
---|---|---|
cloudCover |
integer |
Porcentagem que representa a cobertura de nuvem. |
hazards |
Descrição do risco climático que afeta a viagem. |
|
iconCode |
Valor numérico que representa uma imagem que exibe o |
|
isDayTime |
boolean |
Indica a hora do dia. True indica 'day',', false indica 'night. |
lightningCount |
integer |
Estimativa da intensidade da tempestade em escala aberta. Um valor de 0 significa que não há tempestade; valores de 1 e maior média há uma tempestade em intensidade crescente. |
notifications |
Lista de notificações de risco meteorológico. |
|
precipitation |
Previsão de precipitação do tempo ao longo da rota. |
|
shortPhrase |
string |
Uma frase curta exibivel que descreve as condições previstas e a intensidade/tipo de precipitação. |
sunGlare |
Uma classificação que indica o quão cego o sol é para o driver. |
|
temperature |
Valor específico de uma determinada unidade relacionada ao clima. |
|
wind |
Detalhes do vento sendo retornados, incluindo velocidade e direção. |
|
windGust |
Detalhes do vento sendo retornados, incluindo velocidade e direção. |
WindDetails
Detalhes do vento sendo retornados, incluindo velocidade e direção.
Nome | Tipo | Description |
---|---|---|
direction |
Direção do vento |
|
speed |
Velocidade do vento na unidade especificada. |
WindDirection
Direção do vento
Nome | Tipo | Description |
---|---|---|
degrees |
integer |
Direção do vento em graus Azimuth, começando no verdadeiro Norte e continuando na direção no sentido horário. Norte é 0 graus, leste é 90 graus, sul é 180 graus, oeste é 270 graus. Valores possíveis de 0 a 359. |
localizedDescription |
string |
Abreviação de direção no idioma especificado. |