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 https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}

Con parámetros opcionales:

GET https://atlas.microsoft.com/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
format	path	True	JsonFormat	Formato deseado de la respuesta. Solo se admite `json` formato.
api-version	query	True	string	Número de versión de Azure Maps API.
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	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 la 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	OK
Other Status Codes	ErrorResponse	Error inesperado.

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. Cualquier usuario, grupo o principal de servicio puede recibir acceso mediante un rol incorporado o un rol personalizado compuesto por uno o más permisos para las APIs REST de Azure Maps.

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

Notas

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

El Authorization URL es específico para la instancia Azure nube pública. Las nubes soberanas tienen URLs de Autorización y configuraciones de Microsoft Entra ID únicas. * El control de acceso basado en roles Azure se configura desde el plano de gestión Azure a través de Azure portal, PowerShell, CLI, Azure SDKs o APIs REST. * El uso del Azure Maps Web SDK permite la configuración de una aplicación para múltiples casos de uso.

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

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

Ámbitos

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

subscription-key

Esta es una clave compartida que se provisiona cuando Crea una cuenta Azure Maps en el portal Azure o usando PowerShell, CLI, Azure SDKs o REST API.

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 aplicaciones expuestas públicamente, nuestra recomendación es utilizar el enfoque confidenciales para acceder a Azure Maps APIs REST y así almacenar tu clave de forma segura.

Tipo: apiKey
En: query

SAS Token

Este token de firma de acceso compartido se crea a partir de la operación List SAS en el recurso Azure Maps a través del plano de gestión Azure mediante portal Azure, PowerShell, CLI, Azure SDKs o APIs REST.

Con este token, cualquier aplicación está autorizada para acceder mediante Azure a controles de acceso basados en roles y a un control minucioso de la expiración, tasa y región(es) de uso para el token en particular. 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": [
    {
      "dateTime": "2019-11-14T15:08:00-08:00",
      "phrase": "Cloudy",
      "iconCode": 7,
      "hasPrecipitation": false,
      "isDayTime": true,
      "temperature": {
        "value": 13.7,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperatureShade": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 75,
      "dewPoint": {
        "value": 9.2,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "value": 3.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 4.9,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "obstructionsToVisibility": "",
      "cloudCover": 95,
      "ceiling": {
        "value": 4359,
        "unit": "m",
        "unitType": 5
      },
      "pressure": {
        "value": 1014.9,
        "unit": "mb",
        "unitType": 14
      },
      "pressureTendency": {
        "localizedDescription": "Steady",
        "code": "S"
      },
      "pastTwentyFourHourTemperatureDeparture": {
        "value": 1.8,
        "unit": "C",
        "unitType": 17
      },
      "apparentTemperature": {
        "value": 16.1,
        "unit": "C",
        "unitType": 17
      },
      "windChillTemperature": {
        "value": 13.9,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 11.4,
        "unit": "C",
        "unitType": 17
      },
      "precipitationSummary": {
        "pastHour": {
          "value": 0.5,
          "unit": "mm",
          "unitType": 3
        },
        "past3Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past6Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past9Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past12Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past18Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past24Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        }
      },
      "temperatureSummary": {
        "past6Hours": {
          "minimum": {
            "value": 8.3,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "past12Hours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "past24Hours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        }
      }
    }
  ]
}

Definiciones

Nombre	Description
CurrentConditions
CurrentConditionsResult
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
IconCode	Valor numérico que representa una imagen que corresponde a la condición meteorológica actual descrita por la `Phrase` propiedad. Para más información, consulte Servicios meteorológicos en Azure Maps. Puede ser NULL.
JsonFormat	Formato deseado de la respuesta. Solo se admite `json` formato.
PastHoursTemperature	Resumen de las fluctuaciones de temperatura a lo largo de las últimas horas.
PrecipitationSummary
PressureTendency
TemperatureSummary
UnitType	Un número entero que representa el tipo de unidad. Por ejemplo, 17 para Celsius, 18 para Fahrenheit. Se puede utilizar para la traducción de unidades. Para una lista completa, véase Servicios meteorológicos en Azure Maps.
WeatherDataUnit	Especifica que se devuelvan los datos en unidades métricas o en unidades imperiales. El valor predeterminado es metric.
WeatherUnit	Valor específico de una unidad dada en relación con el clima.
WindDetails	Se devuelven los detalles del viento, incluida la velocidad y la dirección.
WindDirection	Dirección del viento

CurrentConditions

Objeto

Nombre	Tipo	Description
apparentTemperature	WeatherUnit	Temperatura exterior percibida causada por la combinación de la temperatura del aire, la humedad relativa y la velocidad del viento en la unidad especificada.
ceiling	WeatherUnit	Techo de nubes en la unidad especificada. El techo es una medida de la altura de la base de las nubes más bajas.
cloudCover	integer (int32)	Porcentaje que representa la nubosidad.
dateTime	string (date-time)	Fecha y hora de la observación actual mostradas en formato ISO 8601 , por ejemplo, 2019-10-27T19:39:57-08:00.
dewPoint	WeatherUnit	La temperatura del punto de rocío en la unidad especificada. La temperatura del punto de rocío es la temperatura a la que se debe enfriar el aire para alcanzar la saturación.
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.
iconCode	IconCode (int32)	Valor numérico que representa una imagen que corresponde a la condición meteorológica actual descrita por la `Phrase` propiedad. Para más información, consulte Servicios meteorológicos en Azure Maps. Puede ser NULL.
isDayTime	boolean	Indica la hora del día. Verdadero indica 'día', falso indica 'noche'.
obstructionsToVisibility	string	Causa de visibilidad limitada. Valores posibles: A = fuerte tormenta eléctrica/granizo BD = soplando polvo BN = arena que sopla BS = nieve que sopla D = polvo F = niebla GF = niebla terrestre HZ = neblina I = hielo IC = cristales de hielo IF = niebla helada IP = pellets de hielo IPW = ducha de pellets de hielo K = humo L = llovizna R = lluvia RS = lluvia/nieve RW = chubasco S = nieve SG = gránulos de nieve SP = pellets de nieve SW = chubasco de nieve T = tormenta eléctrica UP = precipitación indefinida ZL = llovizna helada ZR = lluvia helada + = pesado - = luz
pastTwentyFourHourTemperatureDeparture	WeatherUnit	Salida de la temperatura observada hace 24 horas en la unidad especificada.
phrase	string	Descripción de las condiciones meteorológicas actuales. Se muestra en el idioma especificado.
precipitationSummary	PrecipitationSummary	Resumen de las cantidades de precipitación en las últimas 24 horas.
pressure	WeatherUnit	Presión atmosférica en la unidad especificada.
pressureTendency	PressureTendency	Cambio de presión atmosférica.
realFeelTemperature	WeatherUnit	RealFeel™ Temperature se está devolviendo.
realFeelTemperatureShade	WeatherUnit	RealFeel™ Temperature se está devolviendo. Describe cómo se siente realmente la temperatura a la sombra.
relativeHumidity	integer (int32)	La humedad relativa es la cantidad de vapor de agua presente en el aire, expresada como porcentaje de la cantidad necesaria para la saturación a la misma temperatura.
temperature	WeatherUnit	Retorno de la temperatura.
temperatureSummary	TemperatureSummary	Resumen de las fluctuaciones de temperatura en las últimas 6, 12 y 24 horas.
uvIndex	integer (int32)	Medida de la intensidad de la radiación ultravioleta del sol. Los valores admitidos son: `0-2` - Bajo peligro de los rayos UV del sol o de la persona promedio. `3-5` - Riesgo moderado de daño por la exposición al sol sin protección. `6-7` - Alto riesgo de daños por la exposición al sol sin protección. `8-10` - Riesgo muy alto de daño por la exposición al sol sin protección. `11+` - Riesgo extremo de daño por la exposición al sol sin protección.
uvIndexPhrase	string	Frase asociada con el `uvIndex`archivo .
visibility	WeatherUnit	Visibilidad en la unidad especificada. Medida de la distancia a la que se puede discernir claramente un objeto o una luz.
wetBulbTemperature	WeatherUnit	La temperatura a la que se puede enfriar el aire evaporando agua en él a presión constante hasta que alcance la saturación.
wind	WindDetails	Se devuelven los detalles del viento, incluida la velocidad y la dirección.
windChillTemperature	WeatherUnit	Temperatura del aire percibida en la piel expuesta debido al viento.
windGust	WindDetails	Ráfaga de viento. La ráfaga de viento es un aumento repentino y breve de la velocidad del viento.

CurrentConditionsResult

Objeto

Nombre	Tipo	Description
results	CurrentConditions[]	Detalle de las condiciones meteorológicas actuales.

ErrorAdditionalInfo

Objeto

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

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

ErrorDetail

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 de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

IconCode

Enumeración

Valor numérico que representa una imagen que corresponde a la condición meteorológica actual descrita por la Phrase propiedad. Para más información, consulte Servicios meteorológicos en Azure Maps. Puede ser NULL.

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)
9
10
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
27
28
29	Lluvia y nieve
30	Hot
31	Frío
32	Windy
33	Clear
34	Mayormente claro
35	Parcialmente nublado
36	Nubes intermitentes (noche)
37	Luz de luna brumosa
38	Mayormente nublado (noche)
39	Parcialmente nublado con chubascos
40	Mayormente nublado con chubascos (noche)
41	Parcialmente nublado con tormenta
42	Mayormente nublado con tormentas eléctricas (noche)
43	Mayormente nublado con ráfagas (Noche)
44	Mayormente nublado con nieve (noche)

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

Resumen de las fluctuaciones de temperatura a lo largo de las últimas horas.

Nombre	Tipo	Description
maximum	WeatherUnit	maximum
minimum	WeatherUnit	minimum

PrecipitationSummary

Objeto

Nombre	Tipo	Description
past12Hours	WeatherUnit	La cantidad de precipitación (equivalente líquido) que ha caído en las últimas 12 horas.
past18Hours	WeatherUnit	La cantidad de precipitación (equivalente líquido) que ha caído en las últimas 18 horas.
past24Hours	WeatherUnit	La cantidad de precipitación (equivalente líquido) que ha caído en las últimas 24 horas.
past3Hours	WeatherUnit	La cantidad de precipitación (equivalente líquido) que ha caído en las últimas tres horas.
past6Hours	WeatherUnit	La cantidad de precipitación (equivalente líquido) que ha caído en las últimas seis horas. Contiene valores métricos e imperiales.
past9Hours	WeatherUnit	La cantidad de precipitación (equivalente líquido) que ha caído en las últimas nueve horas.
pastHour	WeatherUnit	La cantidad de precipitación (equivalente líquido) que ha caído en la última hora.

PressureTendency

Objeto

Nombre	Tipo	Description
code	string	Código de tendencia de presión independientemente del idioma. Uno de F = Descendente, S = Constante, R = Ascendente.
localizedDescription	string	Descripción de la tendencia de la presión en el idioma especificado

TemperatureSummary

Objeto

Nombre	Tipo	Description
past12Hours	PastHoursTemperature	Resumen de las fluctuaciones de temperatura en las últimas 12 horas.
past24Hours	PastHoursTemperature	Resumen de las fluctuaciones de temperatura en las últimas 24 horas.
past6Hours	PastHoursTemperature	Resumen de las fluctuaciones de temperatura en las últimas 6 horas.

UnitType

Enumeración

Un número entero que representa el tipo de unidad. Por ejemplo, 17 para Celsius, 18 para Fahrenheit. Se puede utilizar para la traducción de unidades. Para una lista completa, véase 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 que se devuelvan los datos en unidades métricas o en unidades imperiales. El valor predeterminado es metric.

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

WeatherUnit

Objeto

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

Nombre	Tipo	Description
unit	string	Tipo de unidad para el valor devuelto.
unitType	UnitType (int32)	Un número entero que representa el tipo de unidad. Por ejemplo, 17 para Celsius, 18 para Fahrenheit. Se puede utilizar para la traducción de unidades. Para una lista completa, véase Servicios meteorológicos en Azure Maps.
value	number (float)	Valor redondeado.

WindDetails

Objeto

Se devuelven los detalles del viento, incluida la velocidad y la dirección.

Nombre	Tipo	Description
direction	WindDirection	Dirección del viento
speed	WeatherUnit	Velocidad del viento en unidad especificada.

WindDirection

Objeto

Dirección del viento

Nombre	Tipo	Description
degrees	integer (int32)	Dirección del viento en grados acimutales, comenzando en el norte verdadero y continuando en el sentido de las agujas del reloj. El norte es de 0 grados, el este es de 90 grados, el sur es de 180 grados, el oeste es de 270 grados. Valores posibles de 0 a 359.
localizedDescription	string	Abreviatura de dirección en el idioma especificado.

Compartir a través de

Weather - Get Current Conditions

Parámetros de identificador URI

Encabezado de la solicitud

Respuestas

Seguridad

AADToken

Notas

Ámbitos

subscription-key

SAS Token

Ejemplos

Successfully retrieve detailed current weather conditions for a given coordinate location

Solicitud de ejemplo

Respuesta de muestra

Definiciones

CurrentConditions

CurrentConditionsResult

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCode

JsonFormat

PastHoursTemperature

PrecipitationSummary

PressureTendency

TemperatureSummary

UnitType

WeatherDataUnit

WeatherUnit

WindDetails

WindDirection