- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- CurrentConditionsHistory
Muestra las condiciones climáticas actuales en una ubicación determinada.
Solicitud HTTP
GET https://weather.googleapis.com/v1/currentConditions:lookup
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
Parámetros | |
---|---|
location |
Obligatorio. La ubicación de la que se quieren obtener las condiciones climáticas actuales. |
units |
Opcional. Es el sistema de unidades que se usará para las condiciones climáticas que se muestran. Si no se proporciona, las condiciones climáticas que se devuelvan estarán en el sistema métrico (predeterminado = METRIC). |
language |
Opcional. Permite que el cliente elija el idioma de la respuesta. Si no se pueden proporcionar datos para ese idioma, la API usará la coincidencia más cercana. Los valores permitidos se basan en el estándar BCP-47 del IETF. El valor predeterminado es "es-419". |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Es la respuesta de la RPC currentConditions.lookup, que representa las condiciones climáticas actuales en la ubicación solicitada.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "currentTime": string, "timeZone": { object ( |
Campos | |
---|---|
current |
Es la hora actual (UTC) asociada con los datos que se muestran. Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
time |
La zona horaria de la ubicación solicitada. |
weather |
Las condiciones climáticas actuales |
temperature |
La temperatura actual |
feels |
Es la medida de cómo se siente la temperatura actualmente en la ubicación solicitada. |
dew |
Es la temperatura del punto de rocío actual. |
heat |
La temperatura actual del índice de calor |
wind |
El enfriamiento por viento actual, la temperatura del aire expuesta a la piel. |
precipitation |
La probabilidad de precipitación actual y la cantidad de precipitación acumulada durante la última hora. |
air |
Las condiciones actuales de la presión del aire |
wind |
Las condiciones actuales del viento |
visibility |
La visibilidad actual. |
current |
Los cambios en las condiciones actuales durante las últimas 24 horas. |
is |
Es verdadero si la hora actual en la ubicación solicitada está entre el amanecer (inclusive) y el atardecer (exclusivo) locales. De lo contrario, es de noche (entre el atardecer y el próximo amanecer). |
relative |
Es el porcentaje actual de humedad relativa (valores de 0 a 100). |
uv |
El índice ultravioleta (UV) actual. |
thunderstorm |
La probabilidad actual de tormentas eléctricas (valores de 0 a 100). |
cloud |
Es el porcentaje actual del cielo cubierto de nubes (valores de 0 a 100). |
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/cloud-platform
CurrentConditionsHistory
Representa un conjunto de cambios en las condiciones actuales durante las últimas 24 horas.
Representación JSON |
---|
{ "temperatureChange": { object ( |
Campos | |
---|---|
temperature |
Es la temperatura actual menos la temperatura de hace 24 horas. |
max |
Es la temperatura máxima (alta) de las últimas 24 horas. |
min |
Es la temperatura mínima (baja) de las últimas 24 horas. |
qpf |
Es la cantidad de precipitación (lluvia o nieve), medida como equivalente de agua líquida, que se acumuló en las últimas 24 horas. Nota: QPF es la sigla en inglés de pronóstico cuantitativo de precipitaciones (consulta la definición de QuantitativePrecipitationForecast para obtener más detalles). |