Weather - Get Severe Weather Alerts
Use para obter informações sobre condições climáticas severas, como furacões, tempestades, inundações, raios, ondas de calor ou incêndios florestais para um determinado local.
O fenómeno meteorológico severo pode afetar significativamente a nossa vida quotidiana e as nossas operações comerciais. Por exemplo, condições meteorológicas adversas, como tempestades tropicais, ventos fortes ou inundações, podem fechar estradas e forçar as empresas de logística a redirecionar a sua frota, causando atrasos na chegada aos destinos e quebrando a cadeia de frio dos produtos alimentares refrigerados.
A Get Severe Weather Alerts API é uma solicitação HTTP GET que retorna os alertas de tempo severo que estão disponíveis em todo o mundo das agências meteorológicas oficiais do governo e dos principais provedores de alertas meteorológicos globais e regionais. O serviço pode retornar detalhes como tipo de alerta, categoria, nível e descrição detalhada sobre os alertas severos ativos para o local solicitado, como furacões, tempestades, raios, ondas de calor ou incêndios florestais. Para obter mais informações, consulte Solicitar alertas de mau tempo
GET {endpoint}/weather/severe/alerts/json?api-version=1.1&query={query}
GET {endpoint}/weather/severe/alerts/json?api-version=1.1&query={query}&language={language}&details={details}
Parâmetros do URI
| Nome | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
O nome de host do serviço Azure Maps. Usa |
|
format
|
path | True |
Formato desejado da resposta. Apenas |
|
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a utilizar para esta operação. |
|
query
|
query | True |
number[] |
A consulta aplicável especificada como uma cadeia de caracteres separada por vírgulas composta por latitude seguida de longitude, por exemplo, "47.641268,-122.125679". As informações meteorológicas estão geralmente disponíveis para locais em terra, corpos de água cercados por terra e áreas do oceano que estão a aproximadamente 50 milhas náuticas de uma costa. |
|
details
|
query |
string |
Retorne todos os detalhes dos alertas de mau tempo. Os valores disponíveis são
|
|
|
language
|
query |
string |
Idioma em que os resultados da pesquisa devem ser retornados. Deve ser uma das tags de idioma IETF suportadas, sem distinção entre maiúsculas e minúsculas. Quando os dados no idioma especificado não estão disponíveis para um campo específico, o idioma padrão é usado. |
Cabeçalho do Pedido
| Nome | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| x-ms-client-id |
string |
Indica a conta destinada a ser utilizada com o modelo de segurança do Microsoft Entra ID. Este ID único para a conta Azure Maps pode ser obtido a partir da API da conta Azure Maps plano de gestão. Para mais informações sobre o uso da segurança Microsoft Entra ID em Azure Maps, consulte Gerir autenticação em Azure Maps. |
Respostas
| Nome | Tipo | Descrição |
|---|---|---|
| 200 OK |
O pedido foi bem-sucedido. |
|
| Other Status Codes |
Uma resposta de erro inesperada. |
Segurança
AadToken
Estes são os fluxos Microsoft Entra OAuth 2.0. Quando combinado com controlo Azure baseado em funções, pode ser usado para controlar o acesso a APIs REST Azure Maps. Os controlos de acesso baseados em papéis do Azure são usados para designar o acesso a uma ou mais contas ou subrecursos de recursos do Azure Maps. 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 APIs REST do Azure Maps.
Para implementar cenários, recomendamos a visualização conceitos de autenticação. Em resumo, essa definição de segurança fornece uma solução para modelar aplicativos(s) por meio de objetos capazes de controle de acesso em APIs e escopos específicos.
Note
- Essa definição de segurança requer o uso do cabeçalho
x-ms-client-idpara indicar a qual recurso do Azure Maps o aplicativo está solicitando acesso. Isso pode ser adquirido na API de gerenciamento do Maps. - O
Authorization URLé específico para a instância de nuvem pública do Azure. As clouds soberanas têm URLs de Autorização e configurações de Microsoft Entra ID únicas. - O controle de acesso baseado em função do Azure é configurado a partir do plano de gerenciamento do Azure por meio do portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST.
- O uso do SDK da Web do Azure Maps permite a configuração baseada em configuração de um aplicativo para vários casos de uso.
- Para obter mais informações sobre a plataforma de identidade da Microsoft, consulte visão geral da plataforma de identidade da Microsoft.
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
| Nome | Descrição |
|---|---|
| https://atlas.microsoft.com/.default |
subscription-key
Esta é uma chave compartilhada que é provisionada quando você Criar uma conta do Azure Maps no portal do Azure ou usando PowerShell, CLI, SDKs do Azure ou API REST.
Com essa chave, qualquer aplicativo pode acessar todas as APIs REST. Em outras palavras, essa chave pode ser usada como uma chave mestra na conta em que eles são emitidos.
Para aplicativos expostos publicamente, nossa recomendação é usar a abordagem de de aplicativos cliente confidenciais para acessar APIs REST do Azure Maps para que sua chave possa ser armazenada com segurança.
Tipo:
apiKey
Em:
header
SAS Token
Este é um token de assinatura de acesso compartilhado criado a partir da operação Listar SAS no de recursos do
Com esse token, qualquer aplicativo é autorizado a acessar com controles de acesso baseados em função do Azure e controle de grão fino para a expiração, taxa e região(õ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 forma mais segura do que a chave compartilhada.
Para aplicativos expostos publicamente, nossa recomendação é configurar uma lista específica de origens permitidas no de recursos da conta do
Tipo:
apiKey
Em:
header
Exemplos
Successfully retrieve severe weather alerts
Pedido de amostra
GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query=48.057,-81.091
Resposta da amostra
{
"results": [
{
"description": {
"english": "Heat Warning",
"localized": "Heat Warning"
},
"alertAreas": [
{
"name": "Kirkland Lake - Englehart",
"alertDetails": "\nA heat event continues through Thursday.\n\nDaytime high temperatures in the low thirties with overnight lows near 18 degrees Celsius are expected to continue until Thursday. Humidex values are expected to reach between 36 and 40 today. Cooler air will move into the region Thursday night. \n\nPlease refer to your public forecast for further details on expected temperatures.\n\nHot and humid air can also bring deteriorating air quality and can result in the air quality health index to approach the high risk category.\n\n###\n\nExtreme heat affects everyone.\n\nThe risks are greater for young children, pregnant women, older adults, people with chronic illnesses and people working or exercising outdoors.\n\nWatch for the effects of heat illness: swelling, rash, cramps, fainting, heat exhaustion, heat stroke and the worsening of some health conditions.\n\nPlease continue to monitor alerts and forecasts issued by Environment Canada. To report severe weather, send an email to ONstorm@canada.ca or tweet reports using #ONStorm.\n",
"alertDetailsLanguageCode": "en-CA",
"endTime": "2020-07-02T07:16:03+00:00",
"latestStatus": {
"english": "Continue",
"localized": "Continue"
},
"startTime": "2020-06-29T19:44:00+00:00",
"summary": "Heat Warning in effect until Thursday, 3:16 AM EDT. Source: Environment Canada"
}
],
"alertId": 242621,
"category": "NON-PRECIPITATION",
"countryCode": "CA",
"priority": 31,
"source": "Environment Canada",
"sourceId": 3
},
{
"description": {
"english": "Heat Warning",
"localized": "Heat Warning"
},
"alertAreas": [
{
"name": "Kirkland Lake - Englehart",
"alertDetails": "\nA heat event is expected through Thursday. \n\nDaytime high temperatures in the low thirties on Wednesday and Thursday with overnight lows near 18 degrees Celsius are expected. This heat event may be extended into the weekend with daytime high temperatures near 30 degrees Celsius. \n\nPlease refer to your public forecast for further details on expected temperatures. \n\nHot and humid air can also bring deteriorating air quality and can result in the Air Quality Health Index to approach the high risk category.\n\n###\n\nExtreme heat affects everyone.\n\nThe risks are greater for young children, pregnant women, older adults, people with chronic illnesses and people working or exercising outdoors.\n\nPlease continue to monitor alerts and forecasts issued by Environment Canada. To report severe weather, send an email to ONstorm@canada.ca or tweet reports using #ONStorm.\n",
"alertDetailsLanguageCode": "en-CA",
"endTime": "2020-07-02T01:25:59+00:00",
"latestStatus": {
"english": "New",
"localized": "New"
},
"startTime": "2020-07-01T09:25:59+00:00",
"summary": "Heat Warning in effect until 9:25 PM EDT. Source: Environment Canada"
}
],
"alertId": 242633,
"category": "NON-PRECIPITATION",
"countryCode": "CA",
"priority": 31,
"source": "Environment Canada",
"sourceId": 3
}
]
}
Definições
| Nome | Descrição |
|---|---|
|
Alert |
Uma área geográfica coberta por um alerta de tempo severo, devolvida como uma entrada em |
|
Error |
O erro de gerenciamento de recursos informações adicionais. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro comum para todas as APIs do Azure Resource Manager devolver detalhes de erro para operações falhadas. (Isso também segue o formato de resposta de erro OData.) |
|
Json |
Formato desejado da resposta. Apenas |
|
Latest |
O estado mais recente de um alerta de tempo severo numa área específica, retornado em |
|
Latest |
Uma lista predefinida de oito palavras-chave utilizadas para descrever o estado atual de um alerta de mau tempo. |
|
Severe |
Um alerta de tempo severo ativo no local especificado, devolvido como uma entrada em |
|
Severe |
Frases resumidas curtas para alerta de tempo severo, retornadas em |
|
Severe |
A resposta foi dada pela operação Obter Alertas de Tempo Severo, contendo todos os alertas de tempo severo ativos no local especificado.
Os alertas abrangem fenómenos como furacões, trovoadas, inundações, relâmpagos, ondas de calor e incêndios florestais – independentemente do que as autoridades meteorológicas locais tenham emitido. O |
AlertArea
Uma área geográfica coberta por um alerta de tempo severo, devolvida como uma entrada em SevereWeatherAlert.alertAreas. Cada AlertArea um identifica a área afetada por name, indica os horários de início e fim durante os quais o alerta está em vigor ali (startTime, endTime), reporta o estado mais recente do alerta nessa área (latestStatus), e apresenta uma breve exibição summary do alerta. Quando o pedido solicita todos os detalhes, o texto de alerta completo também é devolvido em alertDetails, identificando alertDetailsLanguageCode a língua em que é fornecido.
| Nome | Tipo | Descrição |
|---|---|---|
| alertDetails |
string |
O texto completo de alerta em formato livre emitido pela fonte para esta área, adequado para exibir o aviso completo. Devolvido apenas quando o pedido pede todos os detalhes. O texto é devolvido na língua em que o fornecedor emissor o forneceu, o que pode diferir da língua solicitada para o resto da resposta; o acompanhante |
| alertDetailsLanguageCode |
string |
A língua de |
| endTime |
string (date-time) |
A data e hora em que o alerta termina ou terminará para esta área, no formato RFC 3339 (yyy-mm-ddThh:mm:ss-hh:mm). Por exemplo, 2025-04-29T07:00:00-07:00. Se o alerta abranger vários fusos horários, o valor reflete a hora local nas coordenadas fornecidas no pedido. |
| latestStatus |
O estado mais recente do alerta nesta área (por exemplo, se é recentemente emitido, em curso ou cancelado).
Devolvido tanto como frase localizada como valor independente |
|
| name |
string |
O nome da área geográfica afetada pelo alerta nesta entrada - por exemplo, Kirkland Lake - Englehart. Identifica a região ou localidade específica a que se aplicam os horários, o estado e o texto detalhado |
| startTime |
string (date-time) |
A data e hora em que o alerta começa para esta área, no formato RFC 3339 (yyy-mm-ddThh:mm:ss-hh:mm). Por exemplo, 2025-04-29T07:00:00-07:00. Se o alerta abranger vários fusos horários, o valor reflete a hora local nas coordenadas fornecidas no pedido. |
| summary |
string |
Um resumo curto e exibível do alerta para esta área, incluindo o período em que está em vigor e a fonte emissora. Por exemplo, Aviso de Calor em vigor até quinta-feira, às 3:16 EDT. Fonte: Ambiente Canadá. |
ErrorAdditionalInfo
O erro de gerenciamento de recursos informações adicionais.
| Nome | Tipo | Descrição |
|---|---|---|
| info |
As informações adicionais. |
|
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Nome | Tipo | Descrição |
|---|---|---|
| additionalInfo |
O erro informações adicionais. |
|
| 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 comum para todas as APIs do Azure Resource Manager devolver detalhes de erro para operações falhadas. (Isso também segue o formato de resposta de erro OData.)
| Nome | Tipo | Descrição |
|---|---|---|
| error |
O objeto de erro. |
JsonFormat
Formato desejado da resposta. Apenas json formato é suportado.
| Valor | Descrição |
|---|---|
| json |
O formato de intercâmbio de dados de notação de objeto JavaScript |
LatestStatus
O estado mais recente de um alerta de tempo severo numa área específica, retornado em AlertArea.latestStatus. A mesma palavra-chave de estado (uma de New, Continue, Update, Correct, Extend, Upgrade, Cancel, ou Expire - ver LatestStatusKeyword a lista completa) é devolvida duas vezes: uma vez traduzida para a língua especificada no pedido (localized), e outra em inglês (english), para que os chamadores possam mostrar uma etiqueta localizada aos utilizadores finais, mantendo ainda um valor estável e independente da língua para ativar o estado.
| Nome | Tipo | Descrição |
|---|---|---|
| english |
A palavra-chave status em inglês (en-US) - um dos valores definidos por |
|
| localized |
string |
A palavra-chave status traduzida para a língua especificada no pedido – por exemplo, Continu para francês. Se não foi especificada nenhuma cláusula no pedido, isto corresponde |
LatestStatusKeyword
Uma lista predefinida de oito palavras-chave utilizadas para descrever o estado atual de um alerta de mau tempo.
| Valor | Descrição |
|---|---|
| Cancel |
Indica que o alerta foi cancelado antes do seu prazo de expiração. |
| Continue |
Indica que o alerta foi atualizado desde sua emissão inicial, mas nenhuma alteração foi feita em |
| Correct |
Indica que o alerta foi modificado para corrigir um erro anterior. |
| Expire |
Indica que o alerta expirou e não está mais ativo. |
| Extend |
Indica que o alerta foi estendido em duração, área ou ambos desde sua emissão inicial. |
| New |
O status de um alerta quando emitido pela primeira vez. |
| Update |
Indica que o alerta foi modificado desde a sua emissão inicial. |
| Upgrade |
Indica que o alerta foi elevado a uma classe ou categoria superior desde que foi emitido pela primeira vez. |
SevereWeatherAlert
Um alerta de tempo severo ativo no local especificado, devolvido como uma entrada em SevereWeatherAlertsResult.results. Combina metadados sobre o próprio alerta (país, identificador, categoria, classificação de gravidade, prioridade, fonte de emissão e qualquer aviso) com frases description resumidas localizadas e em inglês e um alertAreas array que descreve as áreas geográficas específicas que o alerta cobre, os períodos em que está em vigor e o detalhe completo do alerta. Os alertas subjacentes são emitidos por agências meteorológicas governamentais oficiais e pelos principais fornecedores globais de alertas meteorológicos, e abrangem fenómenos como furacões, trovoadas, inundações, relâmpagos, ondas de calor e incêndios florestais.
| Nome | Tipo | Descrição |
|---|---|---|
| alertAreas |
As áreas geográficas abrangidas pelo alerta. Cada uma |
|
| alertId |
integer (int32) |
Um identificador numérico para o alerta, único dentro do fornecedor emissor. |
| category |
string |
Uma etiqueta curta, independente da língua, que classifica o alerta pelo fenómeno meteorológico a que se refere – por exemplo, |
| class |
string |
Uma classificação específica do prestador do alerta (por exemplo, uma classe de aviso ou tipo de alerta), quando é fornecida pela agência emissora. Não está disponível em todos os países e pode ser omitida. |
| countryCode |
string |
O código de país ISO 3166-1 Alpha-2 de 2 caracteres para o país ou região onde o alerta foi emitido – por exemplo, |
| description |
Frases resumidas curtas para o alerta (por exemplo, Heat Warning ou Tornado Alert), devolvidas tanto na língua especificada no pedido ( |
|
| disclaimer |
string |
Um aviso sobre a informação de alerta proveniente da fonte – por exemplo, uma nota sobre possíveis atrasos ou limitações de dados. Se estiver presente, deve ser exibido juntamente com o alerta. Nem sempre devolvido. |
| level |
string |
O nível de gravidade do alerta, quando este é fornecido pela entidade emissora. O conjunto exato de valores é específico de cada fornecedor. Não está disponível em todos os países e pode ser omitida. |
| priority |
integer (int32) |
A importância do alerta dentro do país ou região de origem, onde 1 é a prioridade mais alta e números maiores têm prioridade menor. A escala exata é específica de cada fornecedor e pode mudar ao longo do tempo à medida que os sistemas de alerta evoluem. |
| source |
string |
O nome da agência que emitiu o alerta – por exemplo, Environment Canada ou Serviço Nacional de Meteorologia dos EUA. Os alertas são normalmente emitidos por agências meteorológicas governamentais oficiais ou pelos principais fornecedores globais de alertas meteorológicos. |
| sourceId |
integer (int32) |
Um identificador numérico para o fornecedor de origem que emparelha com |
SevereWeatherAlertDescription
Frases resumidas curtas para alerta de tempo severo, retornadas em SevereWeatherAlert.description. A mesma frase é fornecida duas vezes: uma vez traduzida para a língua especificada no pedido (localized) e outra em inglês (),english para que os chamadores possam mostrar uma etiqueta localizada aos utilizadores finais, mantendo ainda uma cadeia estável e independente da língua para registo, correspondência ou exibição de recurso.
| Nome | Tipo | Descrição |
|---|---|---|
| english |
string |
A frase resumida em inglês (en-US) - por exemplo, Heat Warning ou Tornado Watch. Sempre devolvido em inglês, independentemente da língua solicitada, o que o torna adequado como um rótulo estável e independente da língua. |
| localized |
string |
A frase resumida traduzida para a língua especificada no pedido (por exemplo, Avis de chaleur para francês). Se não foi especificada nenhuma cláusula no pedido, isto corresponde |
SevereWeatherAlertsResult
A resposta foi dada pela operação Obter Alertas de Tempo Severo, contendo todos os alertas de tempo severo ativos no local especificado.
Os alertas abrangem fenómenos como furacões, trovoadas, inundações, relâmpagos, ondas de calor e incêndios florestais – independentemente do que as autoridades meteorológicas locais tenham emitido. O results array fica vazio quando não há alertas ativos.
| Nome | Tipo | Descrição |
|---|---|---|
| results |
Os alertas de tempo severo ativos no local especificado, ordenados por |