Weather - Get Hourly Forecast

Servicio:: Maps

Versión de la API:: 1.1

Úselo para obtener un pronóstico meteorológico detallado por hora para un máximo de 24 horas o un pronóstico diario para un máximo de 10 días.
La Get Hourly Forecast API es un HTTP GET que solicita un pronóstico meteorológico detallado por hora para los próximos 1, 12, 24 (1 día), 72 (3 días), 120 (5 días) y 240 horas (10 días) para la ubicación de coordenadas dada. La API devuelve detalles como la temperatura, la humedad, el viento, la precipitación y el índice ultravioleta (UV). Para obtener más información, consulte Solicitar datos de previsión meteorológica por hora.

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

Con parámetros opcionales:

GET {endpoint}/weather/forecast/hourly/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&language={language}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string (uri)	El nombre de host del servicio Azure Maps. Usa `https://atlas.microsoft.com` para la nube pública Azure. Para dirigirse a una geografía Azure Maps específica o a una nube soberana, véase Azure Maps alcance geográfico.
format	path	True	JsonFormat	Formato deseado de la respuesta. Solo se admite `json` formato.
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.
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". La información meteorológica generalmente está disponible para ubicaciones en tierra, cuerpos de agua rodeados de tierra y áreas del océano que se encuentran dentro de aproximadamente 50 millas náuticas de una costa.
duration	query		integer (int32)	Marco temporal de la previsión meteorológica devuelta. De forma predeterminada, se devolverán los datos de previsión para la próxima hora. Los valores disponibles son: `1` - Devolver los datos de previsión para la próxima hora. Valor predeterminado. `12` - Devolución de pronóstico por hora para las próximas 12 horas. `24` - Devolución del pronóstico por hora para las próximas 24 horas. `72` - Devolución de previsión horaria para las próximas 72 horas (3 días). `120` - Pronóstico de retorno por hora para las próximas 120 horas (5 días). `240` - Pronóstico de retorno por hora para las próximas 240 horas (10 días).
language	query		string	Idioma en el que se deben devolver los resultados de la búsqueda. Debe ser una de las etiquetas de idioma 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.
unit	query		WeatherDataUnit	Especifica que se devuelvan los datos en unidades métricas o en unidades imperiales. El valor predeterminado es metric.

Encabezado de solicitud

Nombre	Requerido	Tipo	Description
x-ms-client-id		string	Indica la cuenta destinada a usarse con el modelo de seguridad Microsoft Entra ID. Este ID único para la cuenta de Azure Maps puede obtenerse desde la API de la cuenta Azure Maps plano de gestión. Para más información sobre el uso de la seguridad Microsoft Entra ID en Azure Maps, consulte Gestionar la autenticación en Azure Maps.

Respuestas

Nombre	Tipo	Description
200 OK	HourlyForecastResult	La solicitud se ha realizado correctamente.
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

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.

Note

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 Maps.
El Authorization URL es específico de la instancia de nube pública de Azure. Las nubes soberanas tienen URLs de Autorización y configuraciones de Microsoft Entra ID únicas.
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.
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

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 detailed weather forecast by the hour

Solicitud de ejemplo

HTTP

GET https://atlas.microsoft.com/weather/forecast/hourly/json?api-version=1.1&query=47.632346,-122.138874&duration=12

Respuesta de muestra

status code:: 200

{
  "forecasts": [
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 3901
      },
      "cloudCover": 100,
      "date": "2019-11-14T16:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 8.4
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": true,
      "precipitationProbability": 39,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 39,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 14.1
      },
      "relativeHumidity": 72,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.4
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.9
      },
      "wind": {
        "direction": {
          "degrees": 311,
          "localizedDescription": "NW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 3.7
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 5.6
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4054
      },
      "cloudCover": 94,
      "date": "2019-11-14T17:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.8
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 34,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 34,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 12.8
      },
      "relativeHumidity": 73,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 12.5
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.2
      },
      "wind": {
        "direction": {
          "degrees": 281,
          "localizedDescription": "W"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 5.6
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 7.4
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4176
      },
      "cloudCover": 94,
      "date": "2019-11-14T18:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.4
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 29,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 29,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.3
      },
      "relativeHumidity": 77,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.3
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.5
      },
      "wind": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 7.4
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4542
      },
      "cloudCover": 93,
      "date": "2019-11-14T19:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "relativeHumidity": 79,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.4
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.8
      },
      "wind": {
        "direction": {
          "degrees": 169,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 7.4
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 11.1
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4389
      },
      "cloudCover": 92,
      "date": "2019-11-14T20:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.9
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.2
      },
      "relativeHumidity": 80,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.1
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "wind": {
        "direction": {
          "degrees": 170,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 11.1
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4481
      },
      "cloudCover": 91,
      "date": "2019-11-14T21:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.1
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9
      },
      "relativeHumidity": 82,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.1
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.8
      },
      "wind": {
        "direction": {
          "degrees": 170,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4481
      },
      "cloudCover": 92,
      "date": "2019-11-14T22:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.2
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 84,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "wind": {
        "direction": {
          "degrees": 174,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 3688
      },
      "cloudCover": 94,
      "date": "2019-11-14T23:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 82,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "wind": {
        "direction": {
          "degrees": 175,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 2926
      },
      "cloudCover": 97,
      "date": "2019-11-15T00:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.9
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.8
      },
      "relativeHumidity": 81,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.1
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "wind": {
        "direction": {
          "degrees": 176,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 2164
      },
      "cloudCover": 99,
      "date": "2019-11-15T01:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.8
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 21,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 21,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 81,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.9
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "wind": {
        "direction": {
          "degrees": 177,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 1737
      },
      "cloudCover": 100,
      "date": "2019-11-15T02:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.8
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 21,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 21,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 82,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.4
      },
      "wind": {
        "direction": {
          "degrees": 172,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 1311
      },
      "cloudCover": 100,
      "date": "2019-11-15T03:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.9
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 26,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 26,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "relativeHumidity": 83,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.7
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.4
      },
      "wind": {
        "direction": {
          "degrees": 161,
          "localizedDescription": "SSE"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    }
  ]
}

Definiciones

Nombre	Description
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).
HourlyForecast	El `HourlyForecast` objeto proporciona detalles meteorológicos cada hora, incluyendo fecha y hora, temperaturas esperadas y percibidas, y punto de rocío. Cubre la velocidad y dirección del viento, ráfagas de viento, humedad relativa, visibilidad y probabilidad de precipitación. Indica si se espera precipitación y especifica su tipo. Otras propiedades incluyen el índice UV, el porcentaje de cobertura nubosa y la altura del techo de nubes. También incluye un icono en código y una frase que describen las condiciones meteorológicas.
HourlyForecastResult	La respuesta devolvía la operación Get Hourly Forecast, que contenía pronósticos meteorológicos hora a hora para una ubicación específica. El número de `HourlyForecast` inscripciones devueltas coincide con la duración prevista solicitada: una de 1, 12, 24, 48, 72 o 96 horas (véase la `HourlyDuration` unión).
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.
JsonFormat	Formato deseado de la respuesta. Solo se admite `json` formato.
UnitType	Un valor entero asociado al tipo de unidad que se está mostrando. Por ejemplo, 17 para Celsius, 18 para Fahrenheit. Se puede utilizar para la traducción de unidades. Para más información, consulte Servicios meteorológicos en Azure Maps.
WeatherDataUnit	Especifica si devolver datos en unidades métricas o imperiales, con métrica como valor predeterminado. Por ejemplo: Métrica: milímetro (mm), metro (m), kilómetro (km), Celsius (C) Imperial: pulgada (pulgada), pie (pie), milla (mi), Fahrenheit (F)
WeatherValue	Valores para métricas relacionadas con el clima, como temperatura, punto de rocío y velocidad del viento, presentados en unidades métricas o imperiales, según se especifica en el parámetro unitario URI. Para más información, véase Tipos de unidades en el artículo Servicios meteorológicos en Azure Maps.
WindDetails	Proporciona la velocidad prevista del viento, medida en unidades como kilómetros por hora (km/h) o millas por hora (mph), dependiendo de la unidad especificada en la solicitud. También indica la dirección del viento medida en grados acimutales, comenzando en el norte verdadero y moviéndose en sentido horario. El norte corresponde a 0°, el este a 90°, el sur a 180° y el oeste a 270°. Los valores posibles varían de 0° a 359°.
WindDirection	Proporciona detalles sobre la dirección del viento, incluyendo la dirección en grados de azimut y una abreviatura localizada de la dirección del viento.

ErrorAdditionalInfo

Objeto

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

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

ErrorDetail

Objeto

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

Objeto

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

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

HourlyForecast

Objeto

El HourlyForecast objeto proporciona detalles meteorológicos cada hora, incluyendo fecha y hora, temperaturas esperadas y percibidas, y punto de rocío. Cubre la velocidad y dirección del viento, ráfagas de viento, humedad relativa, visibilidad y probabilidad de precipitación. Indica si se espera precipitación y especifica su tipo. Otras propiedades incluyen el índice UV, el porcentaje de cobertura nubosa y la altura del techo de nubes. También incluye un icono en código y una frase que describen las condiciones meteorológicas.

Nombre	Tipo	Description
ceiling	WeatherValue	La altura de la capa más baja de nubes sobre el suelo, medida en pies o metros según la unidad especificada en la solicitud. Esta medición es crucial para la aviación y la predicción meteorológica.
cloudCover	integer (int32)	El porcentaje del cielo cubierto de nubes a la hora especificada. Este valor varía desde 0% (cielo despejado) hasta 100% (completamente nublado). Puede ser NULL.
date	string (date-time)	Fecha y hora del pronóstico en formato RFC 3339 (aaaaa-mm-ddThh:mm:ss±hh:mm). Por ejemplo, 2019-11-14T16:00:00-08:00.
dewPoint	WeatherValue	La temperatura a la que el aire se satura de humedad y rocío comienza a formarse. Se mide en grados Fahrenheit (°F) o Celsius (°C), dependiendo de la unidad especificada. Este valor es crucial para entender los niveles de humedad, ya que un punto de rocío más alto indica más humedad en el aire, haciendo que se sienta más húmedo.
hasPrecipitation	boolean	Un valor booleano que indica si se espera precipitación (lluvia, nieve, aguanieve o granizo) durante el periodo especificado. Retorna verdadero si se espera precipitación, en caso contrario falso.
ice	WeatherValue	Retorna la acumulación estimada de hielo para cada hora en la prevision, medida en milímetros (mm) o pulgadas (in), dependiendo de la unidad especificada en la solicitud.
iceProbability	integer (int32)	Muestra la probabilidad de formación de hielo durante la hora especificada, expresada como un porcentaje de 0 a 100. Un valor de 0 significa que no hay posibilidad de formación de hielo, mientras que 100 significa que la formación de hielo es segura. Esta información ayuda a los usuarios a evaluar el potencial de condiciones heladas.
iconCode	IconCode	Un valor numérico que corresponde a una imagen que muestra el `iconPhrase`. Para más información, consulte Servicios meteorológicos en Azure Maps.
iconPhrase	string	Un término descriptivo que corresponde a una condición meteorológica específica, como soleado. Está emparejado con un `iconCode`, que es un valor numérico que representa una imagen que representa visualmente las condiciones meteorológicas descritas por el `iconPhrase`. Para más información, consulte Servicios meteorológicos en Azure Maps.
isDaylight	boolean	Un valor booleano que indica si es de día durante la hora especificada. Devuelve verdadero si es de día, de lo contrario falso.
precipitationProbability	integer (int32)	Muestra la probabilidad de precipitación durante la hora especificada, expresada como un porcentaje de 0 a 100. Un valor de 0 significa que no hay posibilidad de precipitación, mientras que 100 significa que la precipitación es segura. Esto ayuda a los usuarios a evaluar la probabilidad de lluvia, nieve u otras formas de precipitación.
rain	WeatherValue	Indica la cantidad de lluvia esperada durante cada hora en la previsión medida en milímetros (mm) o pulgadas (in), dependiendo de la unidad especificada en la solicitud.
rainProbability	integer (int32)	Muestra la probabilidad de lluvia durante el periodo especificado, expresada como un porcentaje de 0 a 100. Un valor de 0 significa que no hay posibilidad de lluvia, mientras que 100 significa que la lluvia es segura.
realFeelTemperature	WeatherValue	Proporciona valores de temperatura RealFeel™ para la hora especificada, medidos en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud. Esta métrica, desarrollada por AccuWeather, incorpora más de una docena de factores, incluyendo la humedad, la velocidad del viento, la cobertura de nubes y la intensidad solar, para ofrecer una medida completa de cómo se siente realmente el tiempo. Para más información, consulta ¿Cuál es la temperatura RealFeel de AccuWeather?
relativeHumidity	integer (int32)	La cantidad de vapor de agua presente en el aire, expresada como un porcentaje de la cantidad máxima que el aire puede contener a la misma temperatura. Este valor indica lo cerca que está el aire de saturarse de humedad, lo que afecta a lo cómodo o húmedo que se siente el entorno.
snow	WeatherValue	Devuelve la cantidad de nieve acumulada prevista durante la hora especificada, medida en milímetros (mm) o pulgadas (pulgadas), dependiendo de la unidad especificada en la solicitud.
snowProbability	integer (int32)	Muestra la probabilidad de nieve durante la hora especificada, expresada como porcentaje de 0 a 100. Un valor de 0 significa que no hay posibilidad de nieve, mientras que 100 significa que la nieve es segura.
temperature	WeatherValue	La temperatura esperada para la hora especificada, medida en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud.
totalLiquid	WeatherValue	Devuelve la cantidad total de precipitación líquida (como lluvia) esperada durante cada hora del periodo de previsión, medida en milímetros (mm) o pulgadas (in), dependiendo de la unidad especificada en la solicitud.
uvIndex	integer (int32)	Proporciona el índice ultravioleta (UV) para cada hora del periodo de previsión. Este índice indica el nivel de radiación ultravioleta esperado, ayudando a los usuarios a comprender el posible riesgo de exposición al sol en diferentes momentos del día. Los valores admitidos son: 0-2: Bajo peligro por los rayos UV del sol o por la persona promedio. 3-5: Riesgo moderado de daño por exposición solar no protegida. 6-7: Alto riesgo de daño por exposición solar no protegida. 8-10: Riesgo muy alto de daño por exposición solar no protegida. 11+: Riesgo extremo de daño por exposición solar no protegida.
uvIndexPhrase	string	Proporciona una frase descriptiva que indica el nivel de radiación UV, como Bajo, Moderado, Alto o Muy Alto.
visibility	WeatherValue	Devuelve la distancia a la que un objeto o luz puede discernirse claramente para cada hora del periodo de previsión, medida en kilómetros (km) o millas (mi), dependiendo de la unidad especificada en la solicitud. Esto indica hasta dónde se puede ver claramente, lo cual es crucial para actividades como la conducción y la aviación.
wetBulbTemperature	WeatherValue	Devuelve la temperatura que tendría un paquete de aire si se enfriara hasta saturarse (100% humedad relativa) mediante la evaporación del agua en él. Esta propiedad es importante para comprender el estrés térmico y el efecto de enfriamiento de la evaporación.
wind	WindDetails	Proporciona la velocidad y dirección esperadas del viento. La velocidad del viento se mide en kilómetros por hora (km/h) o millas por hora (mph), según la unidad especificada. La dirección del viento se mide en grados acimutales, que van de 0° (norte verdadero) a 359°, moviéndose en sentido horario (este es 90°, sur 180°, oeste 270°).
windGust	WindDetails	Proporciona la velocidad máxima esperada de ráfagas de viento durante cada hora del periodo de previsión, medida en kilómetros por hora (km/h) o millas por hora (mph), según la unidad especificada. La dirección del viento se indica en grados acimutales, que van de 0° (norte verdadero) a 359°, moviéndose en sentido horario. Las ráfagas de viento son aumentos breves en la velocidad del viento, importantes para comprender las variaciones a corto plazo que pueden afectar a actividades como la aviación, la vela y eventos al aire libre.

HourlyForecastResult

Objeto

La respuesta devolvía la operación Get Hourly Forecast, que contenía pronósticos meteorológicos hora a hora para una ubicación específica. El número de HourlyForecast inscripciones devueltas coincide con la duración prevista solicitada: una de 1, 12, 24, 48, 72 o 96 horas (véase la HourlyDuration unión).

Nombre	Tipo	Description
forecasts	HourlyForecast[]	Las entradas de previsión hora a hora, una por hora en la ventana solicitada, en orden cronológico. Cada entrada contiene la temperatura esperada, RealFeel, punto de rocío, viento, previsión de precipitación (probabilidad y cantidades de lluvia, nieve y hielo), cobertura de nubes, visibilidad, índice UV, techo y otras observaciones para esa hora. Por ejemplo, una duración de 12 devuelve 12 entradas a partir de 2019-11-14T16:00:00-08:00 y avanzando una hora cada vez.

IconCode

Enumeración

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.

Valor	Description
1	Soleado
2	Mayormente soleado
3	Parcialmente soleado
4	Nubes intermitentes
5	Sol brumoso
6	Mayormente nublado
7	Cloudy
8	Lúgubre (nublado)
11	Niebla
12	Showers
13	Principalmente nublado con chubascos
14	Parcialmente soleado con chubascos
15	Thunderstorms
16	Principalmente nublado con tormenta
17	Parcialmente soleado con tormenta
18	Lluvia
19	Flurries
20	Principalmente nublado con nevisca
21	Principalmente soleado con nevisca
22	Snow
23	Principalmente nublado con nieve
24	Hielo
25	Conjunto de reses
26	Lluvia helada
29	Lluvia y nieve
30	Hot
31	Frío
32	Windy
33	Clear
34	Mayormente claro
35	Parcialmente nublado
36	Nubes intermitentes
37	Luz de luna brumosa
38	Mayormente nublado
39	Parcialmente nublado con chubascos
40	Principalmente nublado con chubascos
41	Parcialmente nublado con tormenta
42	Principalmente nublado con tormenta
43	Principalmente nublado con nevisca
44	Principalmente nublado con nieve

JsonFormat

Enumeración

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

UnitType

Enumeración

Un valor entero asociado al tipo de unidad que se está mostrando. Por ejemplo, 17 para Celsius, 18 para Fahrenheit. Se puede utilizar para la traducción de unidades. Para más información, consulte Servicios meteorológicos en Azure Maps.

Valor	Description
0	feet
1	inches
2	miles
3	millimeter
4	centimeter
5	meter
6	kilometer
7	kilometersPerHour
8	knots
9	milesPerHour
10	metersPerSecond
11	hectoPascals
12	inchesOfMercury
13	kiloPascals
14	millibars
15	millimetersOfMercury
16	poundsPerSquareInch
17	Grados centígrados
18	Fahrenheit
19	kelvin
20	percent
21	flotante
22	entero
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Enumeración

Especifica si devolver datos en unidades métricas o imperiales, con métrica como valor predeterminado. Por ejemplo:

Métrica: milímetro (mm), metro (m), kilómetro (km), Celsius (C)
Imperial: pulgada (pulgada), pie (pie), milla (mi), Fahrenheit (F)

Valor	Description
imperial	Devolve datos usando unidades imperiales como Fahrenheit (F) para la temperatura y millas (mi) para la distancia.
metric	Devuelve datos utilizando unidades métricas como Celsius (C) para la temperatura y kilómetro (km) para la distancia.

WeatherValue

Objeto

Valores para métricas relacionadas con el clima, como temperatura, punto de rocío y velocidad del viento, presentados en unidades métricas o imperiales, según se especifica en el parámetro unitario URI. Para más información, véase Tipos de unidades en el artículo Servicios meteorológicos en Azure Maps.

Nombre	Tipo	Description
unit	string	La unidad de medida utilizada en el valor de retorno, como "C" para Celsius, "F" para Fahrenheit.
unitType	UnitType	Un entero que representa el tipo de unidad. Por ejemplo, 0 para pies, 1 para pulgadas, 2 para millas. Para una lista completa, véase Tipos de unidades en el artículo Servicios meteorológicos en Azure Maps.
value	number (float)	El valor medido expresado en la unidad especificada.

WindDetails

Objeto

Proporciona la velocidad prevista del viento, medida en unidades como kilómetros por hora (km/h) o millas por hora (mph), dependiendo de la unidad especificada en la solicitud. También indica la dirección del viento medida en grados acimutales, comenzando en el norte verdadero y moviéndose en sentido horario. El norte corresponde a 0°, el este a 90°, el sur a 180° y el oeste a 270°. Los valores posibles varían de 0° a 359°.

Nombre	Tipo	Description
direction	WindDirection	La dirección del viento se mide en grados acimutales, comenzando en el norte verdadero (0°) y moviéndose en sentido horario. El este corresponde a 90°, el sur a 180° y el oeste a 270°. Los valores posibles varían de 0° a 359°. Esta propiedad devuelve un entero que representa la dirección del viento.
speed	WeatherValue	La velocidad esperada del viento, medida en kilómetros por hora (km/h) o millas por hora (mph), dependiendo de la unidad especificada en la solicitud.

WindDirection

Objeto

Proporciona detalles sobre la dirección del viento, incluyendo la dirección en grados de azimut y una abreviatura localizada de la dirección del viento.

Nombre	Tipo	Description
degrees	integer (int32)	La dirección del viento se mide en grados acimutales, comenzando en el norte verdadero y moviéndose en sentido horario. El norte corresponde a 0 grados, el este a 90 grados, el sur a 180 grados y el oeste a 270 grados. Los valores posibles varían de 0 a 359 grados.
localizedDescription	string	Una abreviatura localizada de la dirección del viento, devuelta en el idioma especificado en la solicitud. Por ejemplo, `N` para el Norte, `E` para el Este, `S` para el Sur y `W` para el Oeste.