- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- CurrentConditionsHistory
Devuelve 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. Es la ubicación para la que se obtendrán las condiciones climáticas actuales. |
unitsSystem |
Opcional. Es el sistema de unidades que se usará para las condiciones climáticas devueltas. Si no se proporciona, las condiciones climáticas devueltas estarán en el sistema métrico (predeterminado = METRIC). |
languageCode |
Opcional. Permite que el cliente elija el idioma de la respuesta. Si no se pueden proporcionar datos para ese idioma, la API usa la coincidencia más cercana. Los valores permitidos se basan en el estándar BCP-47 del IETF. El valor predeterminado es "en". |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Es la respuesta para el RPC de 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 | |
|---|---|
currentTime |
Hora actual (UTC) asociada a los datos devueltos. Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
timeZone |
Zona horaria en la ubicación solicitada. |
weatherCondition |
Es la condición climática actual. |
temperature |
La temperatura actual |
feelsLikeTemperature |
Es la medida de cómo se siente la temperatura actualmente en la ubicación solicitada. |
dewPoint |
Es la temperatura actual del punto de rocío. |
heatIndex |
La temperatura actual de la sensación térmica. |
windChill |
La sensación térmica actual, la temperatura del aire a la que está expuesta la piel. |
precipitation |
La probabilidad de precipitación actual y la cantidad de precipitación acumulada durante la última hora. |
airPressure |
Las condiciones de presión de aire actuales. |
wind |
Las condiciones actuales del viento. |
visibility |
Es la visibilidad actual. |
currentConditionsHistory |
Son los cambios en las condiciones actuales durante las últimas 24 horas. |
isDaytime |
Es verdadero si la hora actual en la ubicación solicitada se encuentra entre la hora local del amanecer (inclusive) y la hora del atardecer (exclusive). De lo contrario, es de noche (entre la puesta del sol y el siguiente amanecer). |
relativeHumidity |
Es el porcentaje actual de humedad relativa (valores de 0 a 100). |
uvIndex |
Es el índice ultravioleta (UV) actual. |
thunderstormProbability |
Es la probabilidad actual de tormenta eléctrica (valores de 0 a 100). |
cloudCover |
Porcentaje actual del cielo cubierto por 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 | |
|---|---|
temperatureChange |
Es la temperatura actual menos la temperatura de hace 24 horas. |
maxTemperature |
La temperatura máxima (alta) en las últimas 24 horas. |
minTemperature |
La temperatura mínima (baja) en las últimas 24 horas. |
snowQpf |
Cantidad de nieve, medida como equivalente de agua líquida, que se acumuló en las últimas 24 horas. Nota: QPF es la abreviatura de pronóstico cuantitativo de precipitaciones (consulta la definición de QuantitativePrecipitationForecast para obtener más detalles). |
qpf |
Es la cantidad de lluvia acumulada en las últimas 24 horas, medida como equivalente de agua líquida. Nota: QPF es la abreviatura de pronóstico cuantitativo de precipitaciones (consulta la definición de QuantitativePrecipitationForecast para obtener más detalles). |