Weather - Get Current Conditions

Servicio:: Maps

Versión de la API:: 1.1

Úselo para obtener las condiciones climáticas actuales.
La Get Current Conditions API es una solicitud HTTP GET que devuelve las condiciones meteorológicas actuales detalladas, como la precipitación, la temperatura y el viento, para una ubicación de coordenadas determinada. Además, se pueden recuperar las observaciones de las últimas 6 o 24 horas para una ubicación determinada. La información básica devuelta con La respuesta incluye detalles como la fecha y hora de observación, una breve descripción de las condiciones meteorológicas, el icono meteorológico, los indicadores de precipitación y la temperatura. También se devuelven detalles adicionales, como RealFeel™, temperatura e índice UV. Para obtener más información, consulte Solicitar datos meteorológicos en tiempo real

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

Con parámetros opcionales:

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&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.
details	query		string	Devolver todos los detalles de las condiciones actuales. Los valores disponibles son: `true` - Devuelve todos los detalles. De forma predeterminada, se devuelven todos los detalles. `false` - Devuelve una versión truncada de los datos de condición actual, que incluye la observación, la fecha, la hora, la frase meteorológica, el código de icono, el indicador de precipitación y la temperatura.
duration	query		integer (int32)	Marco temporal de las condiciones meteorológicas devueltas. De forma predeterminada, se devolverán las condiciones meteorológicas más actuales. El valor predeterminado es 0. Los valores admitidos son: `0` - Devolver las condiciones meteorológicas más actuales. `6` - Devolver las condiciones meteorológicas de las últimas 6 horas. `24` - Devolver las condiciones meteorológicas de las últimas 24 horas.
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	CurrentConditionsResult	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 current weather conditions for a given coordinate location

Solicitud de ejemplo

HTTP

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

Respuesta de muestra

status code:: 200

{
  "results": [
    {
      "apparentTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 16.1
      },
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4359
      },
      "cloudCover": 95,
      "dateTime": "2019-11-14T15:08:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 9.2
      },
      "hasPrecipitation": false,
      "iconCode": 7,
      "isDayTime": true,
      "obstructionsToVisibility": "",
      "pastTwentyFourHourTemperatureDeparture": {
        "unit": "C",
        "unitType": 17,
        "value": 1.8
      },
      "phrase": "Cloudy",
      "precipitationSummary": {
        "past12Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past18Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past24Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past3Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past6Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past9Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "pastHour": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.5
        }
      },
      "pressure": {
        "unit": "mb",
        "unitType": 14,
        "value": 1014.9
      },
      "pressureTendency": {
        "code": "S",
        "localizedDescription": "Steady"
      },
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "realFeelTemperatureShade": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "relativeHumidity": 75,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.7
      },
      "temperatureSummary": {
        "past12Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past24Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past6Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 8.3
          }
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 8
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.4
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 3.6
        }
      },
      "windChillTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.9
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 4.9
        }
      }
    }
  ]
}

Definiciones

Nombre	Description
CurrentConditions	Una única observación meteorológica para la ubicación especificada, devuelto por la operación Obtener Condiciones Actuales. Dependiendo de la `duration`petición, esta observación puede ser la lectura más reciente (más reciente) o una de las observaciones horarias anteriores. Por defecto se devuelve un subconjunto simplificado: fecha y hora de observación, frase meteorológica, código de iconos, indicador de precipitación y temperatura. Cuando la solicitud pide todos los detalles, se incluye cada propiedad, añadiendo medidas como RealFeel, punto de rocío, viento, visibilidad, cobertura de nubes, presión y resúmenes de precipitaciones y temperaturas en movimiento de las últimas horas.
CurrentConditionsResult	La respuesta devuelve la operación Obtener Condiciones de Corriente, que contiene una o más observaciones de condiciones de corriente para una ubicación especificada. Por defecto, se devuelve una única observación para el tiempo presente; cuando el `duration` parámetro se establece en 6 o 24, la respuesta también incluye una observación por última hora durante esa ventana.
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).
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.
PastHoursTemperature	Las temperaturas más altas y más bajas observadas durante una de las ventanas giratorias ( `TemperatureSummary` más allá de 6, 12 o 24 horas), en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud.
PrecipitationSummary	La precipitación líquida equivalente total que ha caído en el lugar de observación sobre ventanas móviles que terminan en la hora de observación. Cada valor cubre la ventana completa medida desde "ahora" —por ejemplo, `past3Hours` es el total acumulado de las tres horas más recientes, no solo de la tercera hora—, así que las ventanas se solapan y las ventanas más largas incluyen la precipitación reportada en las más cortas. La nieve y el hielo contribuyen a su equivalente derretido (líquido). Reportado en milímetros (mm) o pulgadas (in) dependiendo de la unidad especificada en la solicitud.
PressureTendency	La tendencia reciente de la presión atmosférica —ya sea que la presión esté subiendo, bajando o estable— volvió tanto como frase localizada como código de una sola letra. Útil para anticipar cambios meteorológicos a corto plazo; la caída de la presión suele indicar el deterioro del tiempo, mientras que la subida suele indicar la mejora de las condiciones.
TemperatureSummary	Las temperaturas más altas y más bajas observadas en el lugar sobre ventanas enrollables terminan en el momento de observación. Cada valor cubre la ventana completa medida desde "ahora" —por ejemplo, `past12Hours` informa del máximo y el mínimo de las últimas 12 horas, no solo de la duodécima hora—, así que las ventanas se solapan y las ventanas más largas incluyen las temperaturas reportadas para las más cortas. Reportado en grados Celsius (°C) o Fahrenheit (°F) según la unidad especificada en la solicitud.
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.

CurrentConditions

Objeto

Una única observación meteorológica para la ubicación especificada, devuelto por la operación Obtener Condiciones Actuales. Dependiendo de la durationpetición, esta observación puede ser la lectura más reciente (más reciente) o una de las observaciones horarias anteriores. Por defecto se devuelve un subconjunto simplificado: fecha y hora de observación, frase meteorológica, código de iconos, indicador de precipitación y temperatura. Cuando la solicitud pide todos los detalles, se incluye cada propiedad, añadiendo medidas como RealFeel, punto de rocío, viento, visibilidad, cobertura de nubes, presión y resúmenes de precipitaciones y temperaturas en movimiento de las últimas horas.

Nombre	Tipo	Description
apparentTemperature	WeatherValue	La temperatura aparente en el momento de observación: cómo se siente realmente el aire para los humanos, teniendo en cuenta la temperatura del aire, la humedad relativa y la velocidad del viento. Medido en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud.
ceiling	WeatherValue	El techo de nubes en el momento de observación —la altura sobre el suelo de la capa más baja de nubes— en pies (ft) o metros (m), dependiendo de la unidad especificada en la solicitud. Es importante para la aviación, ya que afecta a la visibilidad y operaciones de vuelo.
cloudCover	integer (int32)	El porcentaje del cielo cubierto de nubes en el momento de la observación, de 0 (despejado) a 100 (nublado). Puede ser NULL.
dateTime	string (date-time)	La fecha y hora de esta observación, en formato RFC 3339 (aaa-mm-ddThh:mm:ss-hh:mm). Por ejemplo, 2025-04-29T07:00:00-07:00.
dewPoint	WeatherValue	El punto de rocío en el momento de observación es la temperatura a la que el aire debe enfriarse para saturarse (100% humedad relativa). Medido en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud. Un punto de rocío más alto indica más humedad en el aire.
hasPrecipitation	boolean	`true` si en el momento de observación se produce precipitación (lluvia, nieve, aguanieve o granizo); de lo contrario `false`.
iconCode	IconCode	El icono meteorológico representativo para esta observación, junto con la `phrase` propiedad. El valor numérico corresponde a un icono meteorológico de Azure Maps; para la lista completa, consulta Servicios meteorológicos en Azure Maps. Puede ser NULL.
isDayTime	boolean	`true` si es de día en la ubicación especificada a la hora de observación; `false` si es de noche.
obstructionsToVisibility	string	Un código que identifica el factor dominante que reduce la visibilidad en el momento de observación, como niebla, humo, neblina o precipitación. Útil para actividades que dependen de la visibilidad clara, como conducir y la aviación. Valores posibles: A = tormenta fuerte/granizo BD = polvo soplado BN = arena soplando BS = sopla nieve D = polvo F = niebla GF = niebla del suelo HZ = neblina I = hielo IC = cristales de hielo SI = niebla de hielo IP = pellets de hielo IPW = lluvia de pellets de hielo K = humo L = llovizna R = lluvia RS = lluvia/nieve RW = chaparrón S = nieve SG = gránulos de nieve SP = grábolas de nieve SW = chubasco de nieve T = tormenta eléctrica UP = precipitación indefinida ZL = llovizna helada ZR = lluvia helada + = pesado - = luz
pastTwentyFourHourTemperatureDeparture	WeatherValue	El cambio en la temperatura del aire respecto a hace 24 horas, en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud. Los valores positivos indican que el aire está más caliente que ayer a la misma hora; los valores negativos indican que está más fresco.
phrase	string	Un término descriptivo corto para las condiciones meteorológicas en el momento de observación: por ejemplo, soleado o parcialmente nublado. Se empareja con `iconCode`, que identifica el icono del clima correspondiente. Para más información, consulte Servicios meteorológicos en Azure Maps.
precipitationSummary	PrecipitationSummary	Un resumen de las cantidades de precipitación líquida equivalente en el lugar de observación durante ventanas móviles de las últimas 1, 3, 6, 9, 12, 18 y 24 horas, en milímetros (mm) o pulgadas (in) dependiendo de la unidad especificada en la solicitud.
pressure	WeatherValue	La presión atmosférica (del aire) a nivel del suelo en el momento de observación, en milibares (mb) o pulgadas de mercurio (inHg), dependiendo de la unidad especificada en la solicitud.
pressureTendency	PressureTendency	La tendencia reciente de la presión atmosférica: subiendo, bajando o constante. Útil para anticipar cambios meteorológicos a corto plazo; la caída de la presión suele indicar el deterioro del tiempo, mientras que la subida suele indicar la mejora de las condiciones.
realFeelTemperature	WeatherValue	La temperatura RealFeel™ en el momento de observación, en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud. Desarrollado por AccuWeather, RealFeel combina la temperatura del aire con la humedad, el viento, la cobertura de nubes, la intensidad solar y otros factores para indicar cómo se siente realmente el tiempo. Para más información, consulta ¿Cuál es la temperatura RealFeel de AccuWeather?
realFeelTemperatureShade	WeatherValue	La temperatura RealFeel™ en el momento de observación en áreas sombreadas, en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud. Como `realFeelTemperature`, pero excluye el efecto de calentamiento de la luz solar directa, dando una sensación más precisa de cómo se siente el clima a la sombra.
relativeHumidity	integer (int32)	La humedad relativa en el momento de observación, expresada como un porcentaje de 0 a 100 de la cantidad máxima de vapor de agua que el aire puede retener a la misma temperatura.
temperature	WeatherValue	La temperatura del aire en el momento de observación, en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud.
temperatureSummary	TemperatureSummary	Un resumen de las temperaturas del aire más altas y más bajas observadas en este lugar durante ventanas móviles de las últimas 6, 12 y 24 horas, en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud.
uvIndex	integer (int32)	El índice ultravioleta (UV) en el momento de observación, que indica el riesgo de daño por exposición solar no protegida. Los valores admitidos son: 0-2: Bajo peligro de los rayos UV del sol para 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	Una etiqueta descriptiva corta para `uvIndex` , por ejemplo, Bajo, Moderado, Alto, Muy Alto o Extremo.
visibility	WeatherValue	La visibilidad horizontal en el momento de observación —la distancia a la que un objeto o luz puede discernirse claramente— en kilómetros (km) o millas (mi), dependiendo de la unidad especificada en la solicitud.
wetBulbTemperature	WeatherValue	La temperatura del bulbo húmedo en el momento de observación es la temperatura que alcanzaría el aire si se enfriara hasta saturarse (100% humedad relativa) evaporando agua en él a presión constante. Medido en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud. Útil para evaluar el estrés térmico y el enfriamiento por evaporación.
wind	WindDetails	La velocidad y dirección del viento en el momento de observación. La velocidad está en kilómetros por hora (km/h) o millas por hora (mph) dependiendo de la unidad especificada en la solicitud; la dirección está en grados de azimut, medidos en sentido horario desde el norte verdadero (0° = N, 90° = E, 180° = S, 270° = W).
windChillTemperature	WeatherValue	La temperatura térmica en el momento de observación es lo frío que se siente el aire sobre la piel expuesta debido al efecto combinado del viento y la temperatura baja. Normalmente es más baja que la temperatura real del aire. Medido en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud.
windGust	WindDetails	La velocidad y dirección máxima de ráfaga de ráfaga corta en el momento de observación, usando las mismas unidades y convención de azimut que `wind`. Las ráfagas de viento son picos breves en la velocidad del viento que pueden afectar a actividades como la aviación, la vela, el vuelo de cometas y otros eventos al aire libre.

CurrentConditionsResult

Objeto

La respuesta devuelve la operación Obtener Condiciones de Corriente, que contiene una o más observaciones de condiciones de corriente para una ubicación especificada. Por defecto, se devuelve una única observación para el tiempo presente; cuando el duration parámetro se establece en 6 o 24, la respuesta también incluye una observación por última hora durante esa ventana.

Nombre	Tipo	Description
results	CurrentConditions[]	Las observaciones de las condiciones actuales, en orden cronológico con la más reciente primero. Por defecto, una sola entrada: la última observación se devuelve; la respuesta también puede contener una entrada por hora durante una ventana reciente (normalmente las últimas 6 o 24 horas), dependiendo de la solicitud.

Nombre

Tipo

Description

results

CurrentConditions[]

Las observaciones de las condiciones actuales, en orden cronológico con la más reciente primero. Por defecto, una sola entrada: la última observación

se devuelve; la respuesta también puede contener una entrada por hora durante una ventana reciente (normalmente las últimas 6 o 24 horas), dependiendo de la solicitud.

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.

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

PastHoursTemperature

Objeto

Las temperaturas más altas y más bajas observadas durante una de las ventanas giratorias ( TemperatureSummary más allá de 6, 12 o 24 horas), en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud.

Nombre	Tipo	Description
maximum	WeatherValue	La temperatura más alta observada durante la ventana.
minimum	WeatherValue	La temperatura más baja observada durante la ventana.

PrecipitationSummary

Objeto

La precipitación líquida equivalente total que ha caído en el lugar de observación sobre ventanas móviles que terminan en la hora de observación. Cada valor cubre la ventana completa medida desde "ahora" —por ejemplo, past3Hours es el total acumulado de las tres horas más recientes, no solo de la tercera hora—, así que las ventanas se solapan y las ventanas más largas incluyen la precipitación reportada en las más cortas. La nieve y el hielo contribuyen a su equivalente derretido (líquido). Reportado en milímetros (mm) o pulgadas (in) dependiendo de la unidad especificada en la solicitud.

Nombre	Tipo	Description
past12Hours	WeatherValue	Precipitación equivalente líquida que ha caído en las últimas 12 horas.
past18Hours	WeatherValue	Precipitación líquida equivalente que ha caído en las últimas 18 horas.
past24Hours	WeatherValue	Precipitación líquida equivalente que ha caído en las últimas 24 horas.
past3Hours	WeatherValue	Precipitación líquida equivalente que ha caído en las últimas 3 horas.
past6Hours	WeatherValue	Precipitación líquida equivalente que ha caído en las últimas 6 horas.
past9Hours	WeatherValue	Precipitación líquida equivalente que ha caído en las últimas 9 horas.
pastHour	WeatherValue	Precipitación líquida equivalente que ha caído en la última hora.

PressureTendency

Objeto

La tendencia reciente de la presión atmosférica —ya sea que la presión esté subiendo, bajando o estable— volvió tanto como frase localizada como código de una sola letra. Útil para anticipar cambios meteorológicos a corto plazo; la caída de la presión suele indicar el deterioro del tiempo, mientras que la subida suele indicar la mejora de las condiciones.

Nombre	Tipo	Description
code	string	Un código independiente del idioma de una sola letra para la tendencia de presión: F = Descendente, S = Estable, R = Ascendente.
localizedDescription	string	Una frase corta que describía la tendencia a la presión —por ejemplo, Caída, Constante o Ascendente — respondía en el lenguaje especificado en la solicitud.

TemperatureSummary

Objeto

Las temperaturas más altas y más bajas observadas en el lugar sobre ventanas enrollables terminan en el momento de observación. Cada valor cubre la ventana completa medida desde "ahora" —por ejemplo, past12Hours informa del máximo y el mínimo de las últimas 12 horas, no solo de la duodécima hora—, así que las ventanas se solapan y las ventanas más largas incluyen las temperaturas reportadas para las más cortas. Reportado en grados Celsius (°C) o Fahrenheit (°F) según la unidad especificada en la solicitud.

Nombre	Tipo	Description
past12Hours	PastHoursTemperature	Las temperaturas más altas y más bajas se han observado en las últimas 12 horas.
past24Hours	PastHoursTemperature	Las temperaturas más altas y más bajas observadas en las últimas 24 horas.
past6Hours	PastHoursTemperature	Las temperaturas más altas y más bajas observadas en las últimas 6 horas.

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.