Weather - Get Severe Weather Alerts

Referência

Serviço:: Maps

Versão da API:: 1.1

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 API Get Severe Weather Alerts é uma solicitação de GET HTTP que retorna os alertas de mau tempo 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 https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query={query}

Com parâmetros opcionais:

GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query={query}&language={language}&details={details}

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
format	path	True	JsonFormat	Formato desejado da resposta. Apenas `json` formato é suportado.
api-version	query	True	string	Número da versão da API do Azure Maps.
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, o que exclui a descrição completa dos detalhes do alerta específica da área (`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

Name	Necessário	Tipo	Description
x-ms-client-id		string	Especifica qual conta deve ser usada em conjunto com o modelo de segurança do Microsoft Entra ID. Ele representa uma ID exclusiva para a conta do Azure Maps e pode ser recuperado da API de Conta do plano de gerenciamento do Azure Maps. Para usar a segurança do Microsoft Entra ID no Azure Maps, consulte os seguintes artigos para obter orientação.

Respostas

Name	Tipo	Description
200 OK	SevereWeatherAlertsResult	OK
Other Status Codes	ErrorResponse	Ocorreu um erro inesperado.

Segurança

AADToken

Estes são os Microsoft Entra OAuth 2.0 Flows. Quando emparelhado com controle de de acesso baseado em função do Azure, ele pode ser usado para controlar o acesso às APIs REST do Azure Maps. Os controles de acesso baseados em função do Azure são usados para designar o acesso a uma ou mais contas de recursos ou subrecursos 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.

Observações

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 de do Maps.

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 ID do Microsoft Entra. * 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

Name	Description
https://atlas.microsoft.com/.default	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: query

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

HTTP

GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query=48.057,-81.091

Resposta da amostra

Código de estado:: 200

{
  "results": [
    {
      "countryCode": "CA",
      "alertId": 242621,
      "description": {
        "localized": "Heat Warning",
        "english": "Heat Warning"
      },
      "category": "NON-PRECIPITATION",
      "priority": 31,
      "source": "Environment Canada",
      "sourceId": 3,
      "alertAreas": [
        {
          "name": "Kirkland Lake - Englehart",
          "summary": "Heat Warning in effect until Thursday, 3:16 AM EDT.  Source: Environment Canada",
          "startTime": "2020-06-29T19:44:00+00:00",
          "endTime": "2020-07-02T07:16:03+00:00",
          "latestStatus": {
            "localized": "Continue",
            "english": "Continue"
          },
          "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"
        }
      ]
    },
    {
      "countryCode": "CA",
      "alertId": 242633,
      "description": {
        "localized": "Heat Warning",
        "english": "Heat Warning"
      },
      "category": "NON-PRECIPITATION",
      "priority": 31,
      "source": "Environment Canada",
      "sourceId": 3,
      "alertAreas": [
        {
          "name": "Kirkland Lake - Englehart",
          "summary": "Heat Warning in effect until 9:25 PM EDT.  Source: Environment Canada",
          "startTime": "2020-07-01T09:25:59+00:00",
          "endTime": "2020-07-02T01:25:59+00:00",
          "latestStatus": {
            "localized": "New",
            "english": "New"
          },
          "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"
        }
      ]
    }
  ]
}

Definições

Name	Description
AlertArea	Informações sobre um alerta de mau tempo emitido na(s) área(s) afetada(s). Se vários alertas estiverem ativos para o mesmo local, os alertas serão retornados em ordem de `priority` na resposta da API, com o alerta de prioridade mais alta sendo retornado na parte superior da resposta.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
JsonFormat	Formato desejado da resposta. Apenas `json` formato é suportado.
LatestStatus	O estado mais recente do alerta na área atual.
LatestStatusKeyword	Palavra-chave para o status mais recente do alerta.
SevereWeatherAlert	Informações sobre um alerta de mau tempo.
SevereWeatherAlertDescription	Descrição de um alerta de mau tempo.
SevereWeatherAlertsResult	Este objeto é retornado de uma chamada Get Severe Weather Alerts bem-sucedida.

AlertArea

Informações sobre um alerta de mau tempo emitido na(s) área(s) afetada(s). Se vários alertas estiverem ativos para o mesmo local, os alertas serão retornados em ordem de priority na resposta da API, com o alerta de prioridade mais alta sendo retornado na parte superior da resposta.

Name	Tipo	Description
alertDetails	string	Detalhes completos associados ao alerta. Retornado se `details`=True. Este campo é sempre devolvido no(s) idioma(s) escolhido(s) pelo fornecedor emissor e o Azure Maps apenas devolve o que é criado pelo fornecedor. Por favor, note que alguns países/regiões podem oferecer o seu idioma nativo e Inglês. O parâmetro Language não se aplica a este campo.
alertDetailsLanguageCode	string	Língua do `alertDetails`. Este campo ajuda a salientar que o idioma do `alertDetails` pode diferir do parâmetro de idioma solicitado. Retornado se `details`=True. O código da linguagem foi derivado dos códigos ISO 639-1 Alpha-2.
endTime	string	A data e hora de fim do alerta no formato ISO 8601, por exemplo, 2019-10-27T19:39:57-08:00. Se o alerta cruzar vários fusos horários, a hora retornada na resposta será a hora local para o local de coordenadas solicitado.
latestStatus	LatestStatus	O estado mais recente do alerta na área atual.
name	string	O nome de uma área afetada pelo alerta. O local que foi solicitado enquadra-se na área de alerta.
startTime	string	A data e hora de início do alerta no formato ISO 8601, por exemplo, 2019-10-27T19:39:57-08:00. Se o alerta cruzar vários fusos horários, a hora retornada na resposta será a hora local para o local de coordenadas solicitado.
summary	string	Texto resumindo o alerta na área retornada.

ErrorAdditionalInfo

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

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name	Tipo	Description
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

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

JsonFormat

Formato desejado da resposta. Apenas json formato é suportado.

Name	Tipo	Description
json	string	O formato de intercâmbio de dados de notação de objeto JavaScript

LatestStatus

O estado mais recente do alerta na área atual.

Name	Tipo	Description
english	LatestStatusKeyword	Palavra-chave de estado mais recente para o alerta, em inglês (en-US).
localized	string	A palavra-chave de status mais recente para o alerta, no idioma especificado. Por padrão, retornado em inglês (en-US).

LatestStatusKeyword

Palavra-chave para o status mais recente do alerta.

Name	Tipo	Description
Cancel	string	"Cancelar" - o alerta foi cancelado antes do seu tempo de expiração original.
Continue	string	"Continuar" - o alerta foi atualizado desde a sua emissão inicial, mas nenhuma alteração foi feita em `alertDetails`, `startTime`, `endTime`ou `class`.
Correct	string	"Correto" - o alerta foi modificado para corrigir um erro anterior.
Expire	string	"Expirar" - o alerta expirou e não está mais ativo.
Extend	string	"Prorrogar" - o alerta foi prorrogado no tempo, na área ou em ambos desde a sua emissão inicial.
New	string	"Novo" - o status de um alerta após a emissão inicial.
Update	string	"Atualização" - o alerta foi atualizado desde a sua emissão inicial.
Upgrade	string	"Upgrade" - o alerta foi atualizado para uma classe ou categoria superior desde a sua emissão inicial.

SevereWeatherAlert

Informações sobre um alerta de mau tempo.

Name	Tipo	Description
alertAreas	AlertArea[]	Informações sobre o alerta específico para a(s) área(s) afetada(s).
alertId	integer	Um identificador numérico único para um alerta meteorológico.
category	string	Categoria do alerta.
class	string	Classificação do alerta. Este campo não está disponível para todos os países e, portanto, nem sempre é devolvido.
countryCode	string	Código de país ISO 3166-1 Alpha-2 de 2 caracteres, por exemplo, "EUA".
description	SevereWeatherAlertDescription	Descrição do alerta.
disclaimer	string	Uma declaração de exoneração de responsabilidade relativa à fonte das informações de alerta. Este campo nem sempre está disponível. Por exemplo, a declaração de exoneração de responsabilidade pode incluir detalhes sobre os atrasos ou potenciais problemas relacionados com o alarme.
level	string	Nível de gravidade do alerta. Este campo não está disponível para todos os países e, portanto, nem sempre é devolvido.
priority	integer	Número que significa a importância ou a ordem de classificação do alerta dado dentro do país/região de origem. Um número mais baixo significa uma prioridade mais elevada. Por exemplo, 1 é a prioridade mais alta. O número varia consoante o país/região e pode mudar ao longo do tempo à medida que cada país/região evolui os seus sistemas de alerta.
source	string	O fornecedor das informações de alerta. Por padrão, a fonte é retornada em inglês (en-US). Os alertas são de agências meteorológicas oficiais do governo e dos principais provedores globais de alertas meteorológicos.
sourceId	integer	Um identificador numérico associado ao nome do provedor de origem dos dados de alerta.

SevereWeatherAlertDescription

Descrição de um alerta de mau tempo.

Name	Tipo	Description
english	string	Descrição do alerta em inglês (en-US).
localized	string	Descrição do alerta no idioma especificado. Por padrão, o inglês (en-US) é retornado se o parâmetro language não for especificado na solicitação.

SevereWeatherAlertsResult

Este objeto é retornado de uma chamada Get Severe Weather Alerts bem-sucedida.

Name	Tipo	Description
results	SevereWeatherAlert[]	Uma lista de todos os alertas de mau tempo para o local consultado.

Partilhar via