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 https://atlas.microsoft.com para a Azure cloud pública. Para direcionar uma geografia Azure Maps específica ou uma nuvem soberana, veja Azure Maps âmbito geográfico.

format
path True

JsonFormat

Formato desejado da resposta. Apenas json formato é suportado.

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

  • true - Devolve todos os detalhes. Por padrão, todos os detalhes são retornados.
  • false - Devolve uma versão truncada dos dados dos alertas, que exclui a descrição completa específica da área dos detalhes do alerta (alertDetails).
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.

Consulte de idiomas suportados para obter detalhes.

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

SevereWeatherAlertsResult

O pedido foi bem-sucedido.

Other Status Codes

ErrorResponse

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-id para 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 Azure Maps por meio do plano de gerenciamento do Azure por meio do portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST.

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 Map para limitar o abuso de renderização e renovar regularmente o Token SAS.

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
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.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe 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.)

JsonFormat

Formato desejado da resposta. Apenas json formato é suportado.

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.

LatestStatusKeyword

Uma lista predefinida de oito palavras-chave utilizadas para descrever o estado atual de um alerta de mau tempo.

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.

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.

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.

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 identifica essa linguagem. Alguns países ou regiões podem oferecer tanto a sua língua materna como o inglês.

alertDetailsLanguageCode

string

A língua de alertDetails, como código de língua ISO 639-1 Alpha-2 – por exemplo, en-CA para inglês canadiano. Pode diferir da linguagem solicitada para o resto da resposta. Devolvido apenas quando o pedido pede todos os detalhes.

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

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 LatestStatusKeyword da língua.

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 AlertArea .

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

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

ErrorDetail[]

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

ErrorDetail

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

LatestStatusKeyword

A palavra-chave status em inglês (en-US) - um dos valores definidos por LatestStatusKeyword (New, Continue, Update, Correct, Extend, Upgrade, Cancel, ou Expire). Sempre devolvido em inglês, independentemente da língua solicitada, o que o torna adequado para verificações de estado estáveis e independentes da língua.

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 englisha .

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 alertDetails, startTime, endTime, ou class.

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

AlertArea[]

As áreas geográficas abrangidas pelo alerta. Cada uma AlertArea identifica uma área afetada pelo nome, indica as horas de início e fim do alerta para essa área, o estado do alerta mais recente e (quando o pedido pede todos os detalhes) o texto completo do alerta. Um alerta pode abranger uma ou várias áreas – por exemplo, um aviso de calor pode aplicar-se a várias regiões adjacentes no mesmo aviso.

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, NON-PRECIPITATION, PRECIPITATION, THUNDERSTORM, TROPICAL, ou FIRE. O conjunto exato de valores depende do fornecedor emissor.

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, US ou CA.

description

SevereWeatherAlertDescription

Frases resumidas curtas para o alerta (por exemplo, Heat Warning ou Tornado Alert), devolvidas tanto na língua especificada no pedido (localized) como em inglês (english).

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 source. Adequado para uma pesquisa estável e independente da língua do fornecedor.

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 englisha .

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

SevereWeatherAlert[]

Os alertas de tempo severo ativos no local especificado, ordenados por priority (prioridade máxima primeiro). Vazio quando não há alertas ativos.