Compartir a través de


Weather - Get Current Conditions

Ú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}
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 la API de Azure Maps.

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

Especifica qué cuenta está pensada para su uso junto con el modelo de seguridad de Id. de Microsoft Entra. Representa un identificador único para la cuenta de Azure Maps y se puede recuperar de la API de cuenta del plano de administración de Azure Maps. Para usar la seguridad del identificador de Entra de Microsoft en Azure Maps, consulte los siguientes artículos de para obtener instrucciones.

Respuestas

Nombre Tipo Description
200 OK

CurrentConditionsResult

De acuerdo

Other Status Codes

ErrorResponse

Error inesperado.

Seguridad

AADToken

Estos son los flujos de Microsoft Entra OAuth 2.0. Cuando se empareja con acceso basado en rol de Azure control, se puede usar para controlar el acceso a las API REST de Azure Maps. Los controles de acceso basados en roles de Azure se usan para designar el acceso a una o varias cuentas de recursos o subrecursos de Azure Maps. Se puede conceder acceso a cualquier usuario, grupo o entidad de servicio a través de un rol integrado o de un rol personalizado compuesto por uno o varios permisos para las API REST de Azure Maps.

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

Notas

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

El Authorization URL es específico de la instancia de nube pública de Azure. Las nubes soberanas tienen direcciones URL de autorización únicas y configuraciones de id. de Microsoft Entra. * El control de acceso basado en rol de Azure se configura desde el plano de administración de Azure a través de Azure Portal, PowerShell, la CLI, los SDK de Azure o las API REST. * El uso de sdk web de Azure Maps permite la configuración basada en la configuración de una aplicación para varios casos de uso.

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

Ámbitos

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

subscription-key

Se trata de una clave compartida que se aprovisiona al Creación de una cuenta de Azure Maps en Azure Portal o mediante PowerShell, la CLI, los SDK de Azure o la API REST.

Con esta clave, cualquier aplicación puede acceder a todas las API REST. En otras palabras, esta clave se puede usar como clave maestra en la cuenta en la que se emiten.

Para las aplicaciones expuestas públicamente, nuestra recomendación es usar las aplicaciones cliente confidenciales enfoque acceder a las API REST de Azure Maps para que la clave se pueda almacenar de forma segura.

Tipo: apiKey
En: query

SAS Token

Se crea un token de firma de acceso compartido a partir de la operación List SAS en el recurso de Azure Maps a través del plano de administración de Azure a través de Azure Portal, PowerShell, CLI, SDK de Azure o API REST.

Con este token, cualquier aplicación tiene autorización para acceder a los controles de acceso basados en rol de Azure y el control específico a la expiración, la tasa y las regiones de uso para el token determinado. Es decir, el token de SAS se puede usar para permitir que las aplicaciones controle el acceso de forma más segura que la clave compartida.

En el caso de las aplicaciones expuestas públicamente, nuestra recomendación es configurar una lista específica de orígenes permitidos en el recurso de cuenta de mapa de limitar el abuso de representación y renovar periódicamente el token de SAS.

Tipo: apiKey
En: header

Ejemplos

Successfully retrieve detailed current weather conditions for a given coordinate location

Solicitud de ejemplo

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

Respuesta de muestra

{
  "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 muestra el iconPhrasearchivo . Consulte Servicios meteorológicos en Azure Maps para obtener más información.

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

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

WeatherDataUnit

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

WeatherUnit

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

WindDetails

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

WindDirection

Dirección del viento

CurrentConditions

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)

La fecha y la hora de la observación actual se muestran 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

Indica la presencia o ausencia de precipitaciones. Verdadero indica la presencia de precipitación, falso indica la ausencia de precipitación.

iconCode

IconCode (int32)

Valor numérico que representa una imagen que muestra el iconPhrasearchivo . Consulte Servicios meteorológicos en Azure Maps para obtener más información.

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 la frase 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 siendo devuelta.

realFeelTemperatureShade

WeatherUnit

RealFeel™ Temperature siendo devuelta. 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 uvIndexarchivo .

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

Nombre Tipo Description
results

CurrentConditions[]

Detalle de las condiciones meteorológicas actuales.

ErrorAdditionalInfo

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

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

IconCode

Valor numérico que representa una imagen que muestra el iconPhrasearchivo . Consulte Servicios meteorológicos en Azure Maps para obtener más información.

Valor Description
1

Soleado

10
11

Niebla

12

Chubascos

13

Principalmente nublado con chubascos

14

Parcialmente soleado con chubascos

15

Tormentas

16

Principalmente nublado con tormenta

17

Parcialmente soleado con tormenta

18

Lluvia

19

Nevisca

2

Principalmente soleado

20

Principalmente nublado con nevisca

21

Principalmente soleado con nevisca

22

Nieve

23

Principalmente nublado con nieve

24

Hielo

25

Aguanieve

26

Lluvia helada

27
28
29

Lluvia y nieve

3

Parcialmente soleado

30

Caliente

31

Frío

32

Viento

33

Claro

34

Principalmente despejado

35

Parcialmente nublado

36

Nubes intermitentes (noche)

37

Calima

38

Mayormente nublado (noche)

39

Parcialmente nublado con chubascos

4

Nubes intermitentes

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)

5

Calima

6

Principalmente nublado

7

Turbio

8

Cubierto

9

JsonFormat

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

Valor Description
json

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

PastHoursTemperature

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

Nombre Tipo Description
maximum

WeatherUnit

Máximo

minimum

WeatherUnit

mínimo

PrecipitationSummary

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

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

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

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

Valor Description
0

pies

1

Pulgadas

10

metrospor segundo

11

hectoPascales

12

pulgadasOfMercurio

13

kiloPascales

14

Milibares

15

milímetrosDeMercurio

16

librasPorPulgada Cuadrada

17

grados centígrados

18

grados Fahrenheit

19

grados Kelvin

2

millas

20

por ciento

21

flotante

22

entero

3

Milímetro

31

MicrogramosPerCubicMeterOfAir

4

centímetro

5

Metro

6

kilómetro

7

kilómetrosPor hora

8

Nudos

9

millasPor hora

WeatherDataUnit

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

Valor Description
imperial

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

metric

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

WeatherUnit

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

Nombre Tipo Description
unit

string

Tipo de unidad para el valor devuelto.

unitType

UnitType (int32)

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

value

number (float)

Valor redondeado.

WindDetails

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

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.