Weather - Get Severe Weather Alerts

Referencia

Servicio:: Maps

Versión de la API:: 1.1

Utilice para obtener información sobre las condiciones meteorológicas graves, como los huracanes, las tormentas, las inundaciones, los rayos, las olas de calor o los incendios forestales para una ubicación determinada.

El fenómeno meteorológico grave puede afectar significativamente a nuestra vida cotidiana y a las operaciones empresariales. Por ejemplo, condiciones meteorológicas severas como tormentas tropicales, vientos altos o inundaciones pueden cerrar carreteras y forzar a las empresas logísticas a volver a enrutar su flota causando retrasos en llegar a destinos y romper la cadena fría de productos alimenticios refrigerados.

La Get Severe Weather Alerts API es una solicitud HTTP GET que devuelve las alertas meteorológicas graves que están disponibles en todo el mundo tanto desde agencias meteorológicas oficiales gubernamentales como líderes globales a proveedores de alertas meteorológicas regionales. El servicio puede devolver detalles como el tipo de alerta, la categoría, el nivel y la descripción detallada sobre las alertas graves activas para la ubicación solicitada, como los huracanes, las tormentas, los rayos, las olas de calor o los incendios forestales. Para más información, consulte Solicitud de alertas meteorológicas graves.

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

Con parámetros opcionales:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
format	path	True	JsonFormat	Formato deseado de la respuesta. Solo se admite el formato `json`.
api-version	query	True	string	Número de versión de la API de Azure Maps.
query	query	True	number[]	La consulta aplicable especificada como una cadena separada por comas compuesta por latitud seguida de longitud, por ejemplo, "47.641268,-122.125679".
details	query		string	Devuelve los detalles completos de las alertas meteorológicas graves. Los valores disponibles son `true` : devuelve los detalles completos. De forma predeterminada, se devuelven todos los detalles. `false` : devuelve una versión truncada de los datos de alertas, que excluye la descripción completa específica del área de detalles de alerta (`alertDetails`).
language	query		string	Idioma en el que se deben devolver los resultados de búsqueda. Debe ser una de las etiquetas de lenguaje IETF admitidas, sin distinción entre mayúsculas y minúsculas. Cuando los datos del idioma especificado no están disponibles para un campo específico, se usa el idioma predeterminado. Consulte Idiomas admitidos para obtener más información.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
x-ms-client-id		string	Especifica qué cuenta está pensada para su uso junto con el modelo de seguridad de Id. de Entra de Microsoft. Representa un identificador único para la cuenta de Azure Maps y se puede recuperar de la API de cuenta del plano de administración de Azure Maps. Para usar la seguridad de id. de Entra de Microsoft en Azure Maps, consulte los siguientes artículos para obtener instrucciones.

Respuestas

Nombre	Tipo	Description
200 OK	SevereWeatherAlertsResult	De acuerdo
Other Status Codes	ErrorResponse	Se ha producido un error inesperado.

Seguridad

AADToken

Estos son los flujos de Microsoft Entra OAuth 2.0 . Cuando se empareja con el control de acceso basado en rol de Azure , se puede usar para controlar el acceso a las API REST de Azure Maps. Los controles de acceso basados en roles de Azure se usan para designar el acceso a una o varias cuentas de recursos o subrecursos de Azure Maps. Se puede conceder acceso a cualquier usuario, grupo o entidad de servicio mediante un rol integrado o un rol personalizado compuesto por uno o varios permisos para las API REST de Azure Maps.

Para implementar escenarios, se recomienda ver los conceptos de autenticación. En resumen, esta definición de seguridad proporciona una solución para modelar aplicaciones a través de objetos capaces de controlar el acceso en determinadas API y ámbitos.

Notas

Esta definición de seguridad requiere el uso del x-ms-client-id encabezado para indicar a qué recurso de Azure Maps solicita acceso la aplicación. Esto se puede adquirir desde la API de administración de Maps .

Authorization URL es específico de la instancia de nube pública de Azure. Las nubes soberanas tienen direcciones URL de autorización únicas y configuraciones de id. de Microsoft Entra. * El control de acceso basado en rol de Azure se configura desde el plano de administración de Azure mediante Azure Portal, PowerShell, la CLI, los SDK de Azure o las API REST. * El uso del SDK web de Azure Maps permite la configuración basada en la configuración de una aplicación para varios casos de uso.

Para obtener más información sobre la plataforma de identidad de Microsoft, consulte Introducción a la plataforma de identidad de Microsoft.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Se trata de una clave compartida que se aprovisiona al crear una cuenta de Azure Maps en Azure Portal o mediante PowerShell, la CLI, los SDK de Azure o la API REST.

Con esta clave, cualquier aplicación puede acceder a todas las API REST. En otras palabras, esta clave se puede usar como clave maestra en la cuenta en la que se emiten.

En el caso de las aplicaciones expuestas públicamente, nuestra recomendación es usar el enfoque de aplicaciones cliente confidenciales para acceder a las API REST de Azure Maps para que la clave se pueda almacenar de forma segura.

Tipo: apiKey
En: query

SAS Token

Se trata de un token de firma de acceso compartido que se crea a partir de la operación List SAS en el recurso de Azure Maps a través de Azure Portal, PowerShell, CLI, SDK de Azure o API REST.

Con este token, cualquier aplicación está autorizada para acceder a los controles de acceso basado en rol de Azure y el control específico a la expiración, la tasa y las regiones de uso para el token determinado. En otras palabras, el token de SAS se puede usar para permitir que las aplicaciones controlen el acceso de forma más segura que la clave compartida.

En el caso de las aplicaciones expuestas públicamente, nuestra recomendación es configurar una lista específica de orígenes permitidos en el recurso de la cuenta de asignación para limitar la representación del abuso y renovar periódicamente el token de SAS.

Tipo: apiKey
En: header

Ejemplos

Successfully retrieve severe weather alerts

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 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"
        }
      ]
    }
  ]
}

Definiciones

Nombre	Description
AlertArea	Información sobre una alerta meteorológica grave emitida dentro de áreas afectadas. Si hay varias alertas activas para la misma ubicación, las alertas se devolverán en orden dentro de la respuesta de `priority` la API, con la alerta de prioridad más alta que se devuelve en la parte superior de la respuesta.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
JsonFormat	Formato deseado de la respuesta. Solo se admite el formato `json`.
LatestStatus	Estado más reciente de la alerta en el área actual.
LatestStatusKeyword	Palabra clave para el estado más reciente de la alerta.
SevereWeatherAlert	Información sobre una alerta meteorológica grave.
SevereWeatherAlertDescription	Descripción de una alerta meteorológica grave.
SevereWeatherAlertsResult	Este objeto se devuelve de una llamada a Get Severe Weather Alerts correcta.

AlertArea

Información sobre una alerta meteorológica grave emitida dentro de áreas afectadas. Si hay varias alertas activas para la misma ubicación, las alertas se devolverán en orden dentro de la respuesta de priority la API, con la alerta de prioridad más alta que se devuelve en la parte superior de la respuesta.

Nombre	Tipo	Description
alertDetails	string	Detalles completos asociados a la alerta. Se devuelve si `details`=True. Este campo siempre se devuelve en los idiomas que elija el proveedor emisor y Azure Maps solo devuelve lo que crea el proveedor. Tenga en cuenta que algunos países o regiones pueden ofrecer su idioma nativo e inglés. El parámetro language no se aplicará a este campo.
alertDetailsLanguageCode	string	Idioma de `alertDetails`. Este campo ayuda a señalar que el idioma de `alertDetails` puede diferir del parámetro de idioma solicitado. Se devuelve si `details`=True. El código de idioma se ha derivado de los códigos ISO 639-1 Alfa-2.
endTime	string	La fecha y hora de finalización de la alerta en formato ISO 8601, por ejemplo, 2019-10-27T19:39:57-08:00. Si la alerta cruza varias zonas horarias, la hora devuelta en la respuesta es la hora local a la ubicación de coordenadas solicitada.
latestStatus	LatestStatus	Estado más reciente de la alerta en el área actual.
name	string	Nombre de un área que se ve afectada por la alerta. La ubicación solicitada se encuentra en el área de alerta.
startTime	string	La fecha y hora de inicio de la alerta en formato ISO 8601, por ejemplo, 2019-10-27T19:39:57-08:00. Si la alerta cruza varias zonas horarias, la hora devuelta en la respuesta es la hora local a la ubicación de coordenadas solicitada.
summary	string	Texto que resume la alerta en el área devuelta.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Los detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

JsonFormat

Formato deseado de la respuesta. Solo se admite el formato json.

Nombre	Tipo	Description
json	string	Formato de intercambio de datos de notación de objetos JavaScript

LatestStatus

Estado más reciente de la alerta en el área actual.

Nombre	Tipo	Description
english	LatestStatusKeyword	Palabra clave de estado más reciente para la alerta, en inglés (en-US).
localized	string	Palabra clave de estado más reciente de la alerta, en el idioma especificado. De forma predeterminada, se devuelve en inglés (en-US).

LatestStatusKeyword

Palabra clave para el estado más reciente de la alerta.

Nombre	Tipo	Description
Cancel	string	"Cancelar": la alerta se ha cancelado antes de su hora de expiración original.
Continue	string	"Continuar": la alerta se ha actualizado desde su emisión inicial, pero no se realizaron cambios en `alertDetails`, `startTime`, `endTime`o `class`.
Correct	string	"Correcto": la alerta se ha modificado para corregir un error anterior.
Expire	string	"Expirar": la alerta ha expirado y ya no está activa.
Extend	string	"Extender": la alerta se ha extendido en el tiempo, en el área o ambas desde su emisión inicial.
New	string	"Nuevo" : el estado de una alerta tras la emisión inicial.
Update	string	"Actualización": la alerta se ha actualizado desde su emisión inicial.
Upgrade	string	"Actualizar": la alerta se ha actualizado a una clase o categoría superior desde su emisión inicial.

SevereWeatherAlert

Información sobre una alerta meteorológica grave.

Nombre	Tipo	Description
alertAreas	AlertArea[]	Información sobre la alerta específica de las áreas afectadas.
alertId	integer	Un identificador numérico único para una alerta meteorológica.
category	string	Categoría de la alerta.
class	string	Clasificación de la alerta. Este campo no está disponible para todos los países y, por lo tanto, no siempre se devuelve.
countryCode	string	Código de país ISO 3166-1 Alfa-2 de 2 caracteres, por ejemplo, "US".
description	SevereWeatherAlertDescription	Descripción de la alerta
disclaimer	string	Declinación de responsabilidades con respecto al origen de la información de alerta. Este campo no siempre está disponible. Por ejemplo, la declinación de responsabilidades puede incluir detalles sobre los retrasos o posibles problemas relacionados con la alarma.
level	string	Nivel de gravedad de la alerta. Este campo no está disponible para todos los países y, por lo tanto, no siempre se devuelve.
priority	integer	Número que indica la importancia o el orden de clasificación de la alerta dada dentro del país o región que se ha originado. Un número menor significa una prioridad más alta. Por ejemplo, 1 es la prioridad más alta. El número varía según el país o región y puede cambiar con el tiempo a medida que cada país o región evoluciona sus sistemas de alertas.
source	string	Proveedor de la información de alerta. De forma predeterminada, el origen se devuelve en inglés (en-US). Las alertas proceden de agencias meteorológicas oficiales del Gobierno y de los principales proveedores de alertas meteorológicas globales.
sourceId	integer	Identificador numérico asociado al nombre del proveedor de origen de los datos de alerta.

SevereWeatherAlertDescription

Descripción de una alerta meteorológica grave.

Nombre	Tipo	Description
english	string	Descripción de la alerta en inglés (en-US).
localized	string	Descripción de la alerta en el idioma especificado. De forma predeterminada, se devuelve inglés (en-US) si el parámetro de idioma no se especifica en la solicitud.

SevereWeatherAlertsResult

Este objeto se devuelve de una llamada a Get Severe Weather Alerts correcta.

Nombre	Tipo	Description
results	SevereWeatherAlert[]	Una lista de todas las alertas meteorológicas graves para la ubicación consultada.

Compartir a través de