Compartir a través de


Weather - Get Tropical Storm Forecast

Úselo para obtener una lista de tormentas tropicales pronosticadas por las agencias nacionales de pronóstico del tiempo.

La Get Tropical Storm Forecasts API es una solicitud HTTP GET que devuelve pronósticos individuales de tormentas tropicales emitidos por el gobierno. La información sobre las tormentas tropicales pronosticadas incluye la ubicación, el estado, la fecha en que se creó el pronóstico, la ventana, la velocidad del viento y los radios del viento.

GET https://atlas.microsoft.com/weather/tropical/storms/forecasts/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}
GET https://atlas.microsoft.com/weather/tropical/storms/forecasts/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}&unit={unit}&details={details}&radiiGeometry={radiiGeometry}&windowGeometry={windowGeometry}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
format
path True

JsonFormat

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

api-version
query True

string

Número de versión de la API de Azure Maps.

basinId
query True

basinId

Identificador de cuenca

govId
query True

integer (int32)

Id de tormenta del gobierno

year
query True

integer (int32)

Año del (los) ciclo(s)

details
query

boolean

Cuando es true, los datos de resumen de los radios del viento se incluyen en la respuesta

radiiGeometry
query

boolean

Cuando es true, los datos de resumen de radios de viento y los detalles de geoJSON se incluyen en la respuesta

unit
query

WeatherDataUnit

Especifica que se devuelvan los datos en unidades métricas o en unidades imperiales. El valor predeterminado es metric.

windowGeometry
query

boolean

Cuando es true, los datos de geometría de ventana (geoJSON) se incluyen en la respuesta

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 Microsoft Entra. 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 del identificador de Entra de Microsoft en Azure Maps, consulte los siguientes artículos de para obtener instrucciones.

Respuestas

Nombre Tipo Description
200 OK

StormForecastResult

De acuerdo

Other Status Codes

ErrorResponse

Error inesperado.

Seguridad

AADToken

Estos son los flujos de Microsoft Entra OAuth 2.0. Cuando se empareja con acceso basado en rol de Azure control, 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 a través de un rol integrado o de un rol personalizado compuesto por uno o varios permisos para las API REST de Azure Maps.

Para implementar escenarios, se recomienda ver 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 encabezado x-ms-client-id para indicar a qué recurso de Azure Maps solicita acceso la aplicación. Esto se puede adquirir desde la API de administración de de Maps.

El 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 a través de Azure Portal, PowerShell, la CLI, los SDK de Azure o las API REST. * El uso de sdk web de Azure Maps permite la configuración basada en la configuración de una aplicación para varios casos de uso.

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 Creación de 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.

Para las aplicaciones expuestas públicamente, nuestra recomendación es usar las aplicaciones cliente confidenciales enfoque 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 crea un token de firma de acceso compartido a partir de la operación List SAS en el recurso de Azure Maps a través del plano de administración de Azure a través de Azure Portal, PowerShell, CLI, SDK de Azure o API REST.

Con este token, cualquier aplicación tiene autorización para acceder a los controles de acceso basados en rol de Azure y el control específico a la expiración, la tasa y las regiones de uso para el token determinado. Es decir, el token de SAS se puede usar para permitir que las aplicaciones controle 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 cuenta de mapa de limitar el abuso de representación y renovar periódicamente el token de SAS.

Tipo: apiKey
En: header

Ejemplos

Get Tropical Storm Forecasts

Solicitud de ejemplo

GET https://atlas.microsoft.com/weather/tropical/storms/forecasts/json?api-version=1.1&year=2021&basinId=NP&govId=2

Respuesta de muestra

{
  "results": [
    {
      "dateTime": "2021-04-25T06:00:00+00:00",
      "initializedDateTime": "2021-04-24T18:00:00+00:00",
      "location": {
        "latitude": 22,
        "longitude": 137.8
      },
      "maxWindGust": {
        "value": 92.6,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 74.1,
        "unit": "km/h",
        "unitType": 7
      },
      "status": "Tropical Storm",
      "window": {
        "left": {
          "latitude": 22.56387,
          "longitude": 137.739517
        },
        "right": {
          "latitude": 21.4361,
          "longitude": 137.860489
        }
      }
    },
    {
      "dateTime": "2021-04-25T18:00:00+00:00",
      "initializedDateTime": "2021-04-24T18:00:00+00:00",
      "location": {
        "latitude": 23.7,
        "longitude": 142.4
      },
      "maxWindGust": {
        "value": 92.6,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 74.1,
        "unit": "km/h",
        "unitType": 7
      },
      "status": "Tropical Storm",
      "window": {
        "left": {
          "latitude": 24.45283,
          "longitude": 142.055313
        },
        "right": {
          "latitude": 22.94641,
          "longitude": 142.744675
        }
      }
    }
  ]
}

Definiciones

Nombre Description
basinId

Identificador de cuenca

ErrorAdditionalInfo

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

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

GeoJsonGeometry

Un objeto geometry válido GeoJSON. El tipo debe ser uno de los siete tipos de geometría GeoJSON válidos: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon y GeometryCollection. Consulte RFC 7946 para obtener más información.

GeoJsonGeometryCollection

Tipo de objeto GeoJSON GeometryCollection válido. Consulte RFC 7946 para obtener más información.

GeoJsonLineString

Un tipo de geometría GeoJSON LineString válido. Consulte RFC 7946 para obtener más información.

GeoJsonMultiLineString

Un tipo de geometría GeoJSON MultiLineString válido. Consulte RFC 7946 para obtener más información.

GeoJsonMultiPoint

Un tipo de geometría GeoJSON MultiPoint válido. Consulte RFC 7946 para obtener más información.

GeoJsonMultiPolygon

Tipo de objeto GeoJSON MultiPolygon válido. Consulte RFC 7946 para obtener más información.

GeoJsonPoint

Un tipo de geometría GeoJSON Point válido. Consulte RFC 7946 para obtener más información.

GeoJsonPolygon

Un tipo de geometría GeoJSON Polygon válido. Consulte RFC 7946 para obtener más información.

JsonFormat

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

LatLongPair

Ubicación representada como latitud y longitud.

RadiusSector

Rumbo 0–90 = cuadrante NE; 90–180 = cuadrante SE; 180–270 = cuadrante SW; 270–360 = cuadrante noroeste.

StormForecast

Pronóstico de tormentas emitido por el gobierno

StormForecastResult

La lista de previsiones emitidas por el Gobierno

StormWindRadiiSummary

Se muestra cuando details=true o radiiGeometry=true en la solicitud.

UnitType

Valor de ID numérico asociado al tipo de unidad que se muestra. Se puede utilizar para la traducción de unidades. Consulte Servicios meteorológicos en Azure Maps para obtener más información.

WeatherDataUnit

Especifica que se devuelvan los datos en unidades métricas o en unidades imperiales. El valor predeterminado es metric.

WeatherUnit

Valor específico de una unidad dada en relación con el clima.

WeatherWindow

Ventana de pronóstico para la tormenta

basinId

Identificador de cuenca

Valor Description
AL

Atlántico

CP

Pacífico Central

EP

Pacífico Oriental

NI

Océano Índico Norte

NP

Pacífico Noroeste

SI

Suroeste del Océano Índico

SP

Pacífico sur

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[]

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.

GeoJsonGeometry

Un objeto geometry válido GeoJSON. El tipo debe ser uno de los siete tipos de geometría GeoJSON válidos: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon y GeometryCollection. Consulte RFC 7946 para obtener más información.

Nombre Tipo Description
type

GeoJsonObjectType

Especifica el tipo de GeoJSON. Debe ser uno de los nueve tipos de objeto GeoJSON válidos: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature y FeatureCollection.

GeoJsonGeometryCollection

Tipo de objeto GeoJSON GeometryCollection válido. Consulte RFC 7946 para obtener más información.

Nombre Tipo Description
geometries GeoJsonGeometry[]:

Contiene una lista de objetos de geometría de GeoJSON válidos. Nota que las coordenadas de GeoJSON están en x, y order (longitud, latitud).

type string:

GeometryCollection

Especifica el tipo de GeoJSON. Debe ser uno de los nueve tipos de objeto GeoJSON válidos: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature y FeatureCollection.

GeoJsonLineString

Un tipo de geometría GeoJSON LineString válido. Consulte RFC 7946 para obtener más información.

Nombre Tipo Description
coordinates

number[] (double)

Coordenadas de la geometría GeoJson LineString.

type string:

LineString

Especifica el tipo de GeoJSON. Debe ser uno de los nueve tipos de objeto GeoJSON válidos: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature y FeatureCollection.

GeoJsonMultiLineString

Un tipo de geometría GeoJSON MultiLineString válido. Consulte RFC 7946 para obtener más información.

Nombre Tipo Description
coordinates

number[] (double)

Coordenadas de la geometría GeoJson MultiLineString.

type string:

MultiLineString

Especifica el tipo de GeoJSON. Debe ser uno de los nueve tipos de objeto GeoJSON válidos: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature y FeatureCollection.

GeoJsonMultiPoint

Un tipo de geometría GeoJSON MultiPoint válido. Consulte RFC 7946 para obtener más información.

Nombre Tipo Description
coordinates

number[] (double)

Coordenadas de la geometría GeoJson MultiPoint.

type string:

MultiPoint

Especifica el tipo de GeoJSON. Debe ser uno de los nueve tipos de objeto GeoJSON válidos: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature y FeatureCollection.

GeoJsonMultiPolygon

Tipo de objeto GeoJSON MultiPolygon válido. Consulte RFC 7946 para obtener más información.

Nombre Tipo Description
coordinates

number[] (double)

Contiene una lista de objetos GeoJSON Polygon válidos. Nota que las coordenadas de GeoJSON están en x, y order (longitud, latitud).

type string:

MultiPolygon

Especifica el tipo de GeoJSON. Debe ser uno de los nueve tipos de objeto GeoJSON válidos: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature y FeatureCollection.

GeoJsonPoint

Un tipo de geometría GeoJSON Point válido. Consulte RFC 7946 para obtener más información.

Nombre Tipo Description
coordinates

number[] (double)

Un Position es una matriz de números con dos o más elementos. Los dos primeros elementos son longitud y latitud, precisamente en ese orden. altitud/elevación es un tercer elemento opcional. Consulte RFC 7946 para obtener más información.

type string:

Point

Especifica el tipo de GeoJSON. Debe ser uno de los nueve tipos de objeto GeoJSON válidos: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature y FeatureCollection.

GeoJsonPolygon

Un tipo de geometría GeoJSON Polygon válido. Consulte RFC 7946 para obtener más información.

Nombre Tipo Description
coordinates

number[] (double)

Coordenadas del tipo de geometría GeoJson Polygon.

type string:

Polygon

Especifica el tipo de GeoJSON. Debe ser uno de los nueve tipos de objeto GeoJSON válidos: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature y FeatureCollection.

JsonFormat

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

Valor Description
json

el formato de intercambio de datos de notación de objetos JavaScript

LatLongPair

Ubicación representada como latitud y longitud.

Nombre Tipo Description
latitude

number (double)

Latitude (propiedad)

longitude

number (double)

Longitud (propiedad)

RadiusSector

Rumbo 0–90 = cuadrante NE; 90–180 = cuadrante SE; 180–270 = cuadrante SW; 270–360 = cuadrante noroeste.

Nombre Tipo Description
beginBearing

number (double)

Llevando, en grados, el comienzo del cuadrante.

endBearing

number (double)

Llevando, en grados, del extremo del cuadrante.

range

number (double)

El radio del cuadrante, en millas náuticas.

StormForecast

Pronóstico de tormentas emitido por el gobierno

Nombre Tipo Description
dateTime

string

Fecha y hora en que el pronóstico es válido, se muestra en formato ISO8601.

initializedDateTime

string

Fecha y hora en que se creó la previsión, que se muestra en formato ISO8601.

location

LatLongPair

Coordenadas de la tormenta

maxWindGust

WeatherUnit

Velocidad máxima de las ráfagas de viento asociadas a la tormenta. Puede ser NULL.

status

string

Entre los posibles valores de estado se incluyen:

  • Tormenta ciclónica
  • Depresión profunda
  • Depresión
  • Tormenta ciclónica extremadamente severa
  • Categoría de huracán (1-5)
  • Ciclón tropical intenso
  • Tormenta tropical moderada
  • Ciclón postropical
  • Potencial ciclón tropical
  • Tormenta ciclónica severa
  • Tormenta tropical severa
  • Subtropical
  • Súper tormenta ciclónica
  • Ciclón tropical
  • Categoría de ciclones tropicales (1-5)
  • Depresión tropical
  • Perturbación tropical
  • Tormenta tropical
  • Tifón
  • Ciclón tropical muy intenso
  • Tormenta ciclónica muy severa
  • Tifón muy fuerte
  • Tifón violento

sustainedWind

WeatherUnit

Velocidad máxima sostenida del viento asociada a la tormenta. Puede ser NULL.

windRadiiSummary

StormWindRadiiSummary[]

Se muestra cuando details=true o radiiGeometry=true en la solicitud.

window

WeatherWindow

Contiene información sobre la ventana de pronóstico para la tormenta durante el período de tiempo especificado (no todo el cono). Si windowGeometry=true en la solicitud, este objeto incluirá detalles geoJSON para la geometría de la ventana.

StormForecastResult

La lista de previsiones emitidas por el Gobierno

Nombre Tipo Description
nextLink

string

es el vínculo a la página siguiente de las características devueltas. Si es la última página, no hay este campo.

results

StormForecast[]

La lista de previsiones emitidas por el Gobierno

StormWindRadiiSummary

Se muestra cuando details=true o radiiGeometry=true en la solicitud.

Nombre Tipo Description
dateTime

string

DateTime para el que son válidos los datos de resumen de radios de viento, mostrados en formato ISO8601.

radiiGeometry GeoJsonGeometry:

Objeto GeoJSON. Se muestra cuando radiiGeometry=true se solicita. Describe el contorno de los cuadrantes del radio del viento.

radiusSectorData

RadiusSector[]

Contiene la información necesaria para trazar cuadrantes de radio de viento. Rumbo 0–90 = cuadrante NE; 90–180 = cuadrante SE; 180–270 = cuadrante SW; 270–360 = cuadrante noroeste.

windSpeed

WeatherUnit

Velocidad del viento asociada a radiusSectorData.

UnitType

Valor de ID numérico asociado al tipo de unidad que se muestra. Se puede utilizar para la traducción de unidades. Consulte Servicios meteorológicos en Azure Maps para obtener más información.

Valor Description
0

pies

1

Pulgadas

10

metrospor segundo

11

hectoPascales

12

pulgadasOfMercurio

13

kiloPascales

14

Milibares

15

milímetrosDeMercurio

16

librasPorPulgada Cuadrada

17

grados centígrados

18

grados Fahrenheit

19

grados Kelvin

2

millas

20

por ciento

21

flotante

22

entero

3

Milímetro

31

MicrogramosPerCubicMeterOfAir

4

centímetro

5

Metro

6

kilómetro

7

kilómetrosPor hora

8

Nudos

9

millasPor hora

WeatherDataUnit

Especifica que se devuelvan los datos en unidades métricas o en unidades imperiales. El valor predeterminado es metric.

Valor Description
imperial

Datos devueltos en unidades imperiales. Algunos ejemplos de unidades del sistema imperial son Fahrenheit y milla.

metric

Devuelva los datos en unidades métricas. Algunos ejemplos de unidades del sistema métrico son Celsius y kilómetro.

WeatherUnit

Valor específico de una unidad dada en relación con el clima.

Nombre Tipo Description
unit

string

Tipo de unidad para el valor devuelto.

unitType

UnitType (int32)

Valor de ID numérico asociado al tipo de unidad que se muestra. Se puede utilizar para la traducción de unidades. Consulte Servicios meteorológicos en Azure Maps para obtener más información.

value

number (float)

Valor redondeado.

WeatherWindow

Ventana de pronóstico para la tormenta

Nombre Tipo Description
beginDateTime

string (date-time)

DateTime del inicio de la ventana de movimiento, que se muestra en formato ISO8601.

beginStatus

string

Estado de la tormenta al principio de la ventana.

endDateTime

string (date-time)

DateTime del final de la ventana de movimiento, que se muestra en formato ISO8601.

endStatus

string

Estado de la tormenta al final de la ventana.

geometry GeoJsonGeometry:

Se muestra cuando windowGeometry=true se solicita. GeoJSON que contiene coordenadas que describen la ventana de movimiento durante el período de tiempo especificado.

left

LatLongPair

Ubicación del punto en el lado izquierdo de la ventana en el momento del período de tiempo.

right

LatLongPair

Ubicación del punto en el lado derecho de la ventana al final del período de tiempo.