Weather - Get Minute Forecast

Utilícelo para obtener un pronóstico minuto a minuto para los próximos 120 minutos en intervalos de 1, 5 y 15 minutos.
La Get Minute Forecast API es una solicitud HTTP GET que devuelve previsiones minuto a minuto para una ubicación determinada durante los próximos 120 minutos. Los usuarios pueden solicitar previsiones meteorológicas en intervalos de 1, 5 y 15 minutos. La respuesta incluirá detalles como el tipo de precipitación (incluyendo lluvia, nieve o una combinación de ambas), la hora de inicio y el valor de intensidad de precipitación (dBZ). Para obtener más información, consulte Solicitar datos de previsión meteorológica minuto a minuto.

GET {endpoint}/weather/forecast/minute/json?api-version=1.1&query={query}

GET {endpoint}/weather/forecast/minute/json?api-version=1.1&query={query}&interval={interval}&language={language}

Parámetros de identificador URI

Encabezado de solicitud

Respuestas

Seguridad

AadToken

Estos son los flujos Microsoft Entra OAuth 2.0. Cuando se combina con el control de acceso basado en roles Azure puede usarse para controlar el acceso a Azure Maps APIs REST. Los controles de acceso basados en roles de Azure se utilizan para designar el acceso a una o más cuentas o subrecursos de recursos 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.

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

Ámbitos

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: header

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

Successfully retrieve minute-by-minute forecasts for a given location

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query=47.632346,-122.138874&interval=15

{
  "intervalSummaries": [
    {
      "briefPhrase": "Rain ending in %minute_value min",
      "endMinute": 24,
      "iconCode": 12,
      "longPhrase": "Rain ending in %minute_value min",
      "shortPhrase": "Rain ending in %minute_value min",
      "startMinute": 0,
      "totalMinutes": 25
    },
    {
      "briefPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "endMinute": 119,
      "iconCode": 7,
      "longPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "shortPhrase": "No precip for %MINUTE_VALUE min",
      "startMinute": 25,
      "totalMinutes": 95
    }
  ],
  "intervals": [
    {
      "cloudCover": 100,
      "color": {
        "blue": 2,
        "green": 98,
        "hex": "#086202",
        "red": 8
      },
      "dbz": 23,
      "iconCode": 12,
      "minute": 0,
      "precipitationType": "Rain",
      "shortPhrase": "Light Rain",
      "simplifiedColor": {
        "blue": 39,
        "green": 190,
        "hex": "#23BE27",
        "red": 35
      },
      "startTime": "2019-11-14T15:18:00-08:00",
      "threshold": "LIGHT"
    },
    {
      "cloudCover": 100,
      "color": {
        "blue": 9,
        "green": 133,
        "hex": "#208509",
        "red": 32
      },
      "dbz": 18,
      "iconCode": 12,
      "minute": 15,
      "precipitationType": "Rain",
      "shortPhrase": "Light Rain",
      "simplifiedColor": {
        "blue": 39,
        "green": 190,
        "hex": "#23BE27",
        "red": 35
      },
      "startTime": "2019-11-14T15:33:00-08:00",
      "threshold": "LIGHT"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 30,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T15:48:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 45,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:03:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 60,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:18:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 75,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:33:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 90,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:48:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 105,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T17:03:00-08:00"
    }
  ],
  "summary": {
    "briefPhrase": "Rain ending in 25 min",
    "briefPhrase60": "Rain ending in 25 min",
    "iconCode": 12,
    "longPhrase": "Rain ending in 25 min",
    "shortPhrase": "Rain ending in 25 min"
  }
}

Definiciones

ColorValue

Un color RGB, devuelto tanto en forma de componente (red, green, blue) como hexadecimal (hex). Utilizado por la predicción minuto a minuto para renderizar cada intervalo en una pantalla tipo radar - véase ForecastInterval.color para el color de espectro completo asignado a dbz, y ForecastInterval.simplifiedColor para el color más grueso derivado de precipitationType y threshold. Para los mapeos de color subyacentes, véase Servicios meteorológicos en Azure Maps.

ErrorAdditionalInfo

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

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta común a errores para todas las APIs de Azure Resource Manager para devolver detalles de error por operaciones fallidas. (Esto también sigue el formato de respuesta de error de OData).

ForecastInterval

Representa una única franja temporal dentro de un pronóstico minuto a minuto, describiendo las condiciones meteorológicas esperadas durante ese intervalo. Cada intervalo abarca 1, 5 o 15 minutos —dependiendo de la resolución solicitada— e incluye la hora de inicio, la intensidad de la precipitación (),dbz el tipo y umbral de precipitación, una breve frase descriptiva, un código de iconos, la cobertura de nubes y los colores de espectro completo y simplificados usados para representar visualmente las condiciones en una pantalla de estilo radar.

IconCode

El código numérico de condiciones meteorológicas que identifica qué icono mostrar. Cada valor en esta enumeración corresponde a un icono meteorológico de Azure Maps (como Sunny, Cloudy o Thunderstorms) y se empareja con un homólogo iconPhrase legible devuelto junto a él. El mismo código puede aparecer en respuestas actuales, horarias, diarias, de cuarto de día y minuto a minuto, permitiendo a las aplicaciones mostrar un conjunto de iconos consistente en todos los servicios meteorológicos.

Para la lista completa de códigos, los iconos a los que se asignan y ejemplos de imágenes, véase Servicios meteorológicos en Azure Maps.

IntervalSummary

Describe la previsión meteorológica para una ventana continua dentro del pronóstico minuto a minuto, normalmente un tramo de condiciones similares como lluvia que termina en 25 minutos o nieve ligera que comienza en 10 minutos. Cada resumen especifica la ventana en minutos desde el inicio del pronóstico (startMinute, endMinute, totalMinutes), proporciona descripciones de frases en tres longitudes (cortas, breves y largas) para que se pueda mostrar el nivel de detalle adecuado para el espacio disponible en la interfaz, e incluye un iconCode icono para el tiempo representativo. A MinuteForecastResult devuelve una o más IntervalSummary entradas que juntas cubren el periodo de previsión.

JsonFormat

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

MinuteForecastResult

La respuesta devolvida por la operación Get Minute Forecast, proporcionando una previsión minuto a minuto de precipitación para una ubicación especificada durante los siguientes 120 minutos a la resolución solicitada (1, 5 o 15 minutos). La respuesta está organizada en tres capas: una general summary con descripciones de frases y un icono representativo para todo el periodo; una intervalSummaries matriz que agrupa minutos consecutivos en tramos más largos de condiciones similares (como lluvia terminando en 25 minutos); y una intervals matriz que contiene los puntos detallados de pronóstico por minuto, incluyendo la intensidad de la precipitación (dbz), el tipo de precipitación, la cobertura de nubes y los colores usados para renderizar visualizaciones de estilo radar.

MinuteForecastSummary

Proporciona resúmenes de frases que describen la previsión de precipitaciones para el próximo periodo de pronóstico minuto a minuto. Se incluyen múltiples longitudes de frase: corta (~25 caracteres), breve (~60 caracteres) y larga (60+ caracteres), para que las aplicaciones puedan mostrar el nivel de detalle que mejor se adapte al espacio disponible de la interfaz. An iconCode indica el icono meteorológico representativo del periodo.

PrecipitationType

Especifica el tipo de precipitación. Los valores válidos son Lluvia, Nieve, Hielo o Mezcla. Esta propiedad se incluye en la respuesta cuando dBZ es mayor que cero.