Package google.maps.weather.v1

Índice

Clima

Es la definición del servicio de la API de Weather.

LookupCurrentConditions

rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)

Devuelve las condiciones climáticas actuales en una ubicación determinada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
LookupForecastDays

rpc LookupForecastDays(LookupForecastDaysRequest) returns (LookupForecastDaysResponse)

Devuelve hasta 10 días de pronósticos diarios en una ubicación determinada, a partir del día actual.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
LookupForecastHours

rpc LookupForecastHours(LookupForecastHoursRequest) returns (LookupForecastHoursResponse)

Devuelve hasta 240 horas de pronósticos por hora en una ubicación determinada, a partir de la hora actual.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
LookupHistoryHours

rpc LookupHistoryHours(LookupHistoryHoursRequest) returns (LookupHistoryHoursResponse)

Devuelve hasta 24 horas de datos históricos del clima por hora en una ubicación determinada, a partir de la última hora.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
LookupPublicAlerts

rpc LookupPublicAlerts(LookupPublicAlertsRequest) returns (LookupPublicAlertsResponse)

Devuelve las alertas meteorológicas públicas para una ubicación determinada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

AirPressure

Representa las condiciones de presión atmosférica.

Campos
mean_sea_level_millibars

float

Es la presión atmosférica media a nivel del mar en milibares.

CardinalDirection

Representa una dirección cardinal (incluidas las direcciones ordinales).

Enums
CARDINAL_DIRECTION_UNSPECIFIED No se especifica la dirección cardinal.
NORTH Es la dirección cardinal norte.
NORTH_NORTHEAST Es la dirección secundaria intercardinal norte-noreste.
NORTHEAST Es la dirección intercardinal noreste.
EAST_NORTHEAST Es la dirección secundaria intercardinal este-noreste.
EAST Es la dirección cardinal este.
EAST_SOUTHEAST Es la dirección secundaria intercardinal este-sureste.
SOUTHEAST Es la dirección intercardinal sudeste.
SOUTH_SOUTHEAST Es la dirección secundaria intercardinal sur-sureste.
SOUTH Es la dirección cardinal sur.
SOUTH_SOUTHWEST Es la dirección secundaria intercardinal sur-sudoeste.
SOUTHWEST Es la dirección intercardinal sudoeste.
WEST_SOUTHWEST Es la dirección secundaria intercardinal oeste-sudoeste.
WEST Es la dirección cardinal oeste.
WEST_NORTHWEST Es la dirección secundaria intercardinal oeste-noroeste.
NORTHWEST Es la dirección intercardinal noroeste.
NORTH_NORTHWEST Es la dirección secundaria intercardinal norte-noroeste.

Certeza

Es el código que denota la certeza del evento sujeto del mensaje de alerta.

Enums
CERTAINTY_UNKNOWN No se conoce la certeza.
OBSERVED Se determinó que ocurrió o que está en curso.
VERY_LIKELY Es muy probable.
LIKELY Es probable (p > ~50%).
POSSIBLE Es posible, pero no probable (p <= ~50%).
UNLIKELY Improbable (p ~ 0%).

DataSource

Representa un vínculo a una fuente de datos.

Campos
publisher

Publisher

Es el publicador de la alerta.
name

string

Nombre oficial del publicador. Ten en cuenta que, si bien este campo debe estar localizado, no se garantiza que lo esté.
authority_uri

string

Es la URL del sitio web de la autoridad.

ForecastDay

Representa un registro de previsión diaria en una ubicación determinada.

Campos
interval

Interval

Es el intervalo de tiempo en UTC en el que comienza (inclusive) y termina (exclusive) este día previsto. Nota: Un día comienza a las 7 a.m. y termina a las 7 a.m. del día siguiente, hora local. Por ejemplo, si la zona horaria local es UTC-7, el intervalo comenzará a la hora 14:00:00.000Z y finalizará a la misma hora del día siguiente.
display_date

Date

Fecha local en la zona horaria de la ubicación (hora civil) para la que se calcula este pronóstico diario. Este campo se puede usar para mostrar información en el cliente.
daytime_forecast

ForecastDayPart

Son las condiciones climáticas pronosticadas para la parte diurna del día (de 7 a.m. a 7 p.m., hora local).
nighttime_forecast

ForecastDayPart

Condiciones climáticas pronosticadas para la parte nocturna del día (de 7 p.m. a 7 a.m. del día siguiente, hora local).
max_temperature

Temperature

La temperatura máxima (alta) durante el día.
min_temperature

Temperature

Es la temperatura mínima (baja) durante el día.
feels_like_max_temperature

Temperature

La sensación térmica máxima (alta) durante el día.
feels_like_min_temperature

Temperature

Es la sensación térmica mínima (baja) durante el día.
max_heat_index

Temperature

Es la temperatura máxima del índice de calor durante el día.
sun_events

SunEvents

Son los eventos relacionados con el sol (p.ej., amanecer, atardecer).
moon_events

MoonEvents

Son los eventos relacionados con la Luna (p.ej., salida y puesta de la Luna).

ForecastDayPart

Representa un registro de previsión para una parte del día.

Campos
interval

Interval

Fecha y hora en UTC en que comienza (inclusive) y finaliza (exclusive) esta parte del día. Nota: Una parte del día comienza a las 7 a.m. y termina a las 7 p.m. del mismo día, hora local. Por ejemplo, si la zona horaria local es UTC-7, el intervalo diurno comenzará a la hora 14:00:00.000Z y finalizará a las 02:00:00.000Z del día siguiente, y el intervalo nocturno comenzará a las 02:00:00.000Z del día siguiente y finalizará a las 14:00:00.000Z de ese mismo día.
weather_condition

WeatherCondition

Condición climática pronosticada.
precipitation

Precipitation

Es la precipitación pronosticada.
wind

Wind

La dirección promedio del viento y la velocidad máxima y las ráfagas
ice_thickness

IceThickness

Es la cantidad acumulada de hielo para la parte del día.
relative_humidity

int32

Porcentaje previsto de humedad relativa (valores del 0 al 100).
uv_index

int32

Es el índice ultravioleta (UV) previsto más alto.
thunderstorm_probability

int32

Es la probabilidad promedio de tormenta eléctrica.
cloud_cover

int32

Porcentaje promedio de cobertura de nubes.

ForecastHour

Representa un registro de previsión por hora en una ubicación determinada.

Campos
interval

Interval

Es el intervalo de una hora (en hora UTC) para el que son válidos estos datos de previsión (las marcas de tiempo se redondean a la hora más cercana).
display_date_time

DateTime

Fecha y hora locales en la zona horaria de la ubicación (hora civil) para la que se calcula este pronóstico por hora. Este campo se puede usar para mostrar información en el cliente. Nota: Esta fecha constará del año, el mes, el día, la hora y el desplazamiento desde UTC.
weather_condition

WeatherCondition

Es la condición climática pronosticada.
temperature

Temperature

Es la temperatura pronosticada.
feels_like_temperature

Temperature

Es la medida de cómo se sentirá la temperatura en la ubicación solicitada.
dew_point

Temperature

Es la temperatura del punto de condensación pronosticada.
heat_index

Temperature

Es la temperatura de sensación térmica prevista.
wind_chill

Temperature

Es la sensación térmica pronosticada, es decir, la temperatura del aire a la que se expone la piel.
wet_bulb_temperature

Temperature

Es la temperatura de la bombilla húmeda prevista, la temperatura más baja que se puede alcanzar evaporando agua.
precipitation

Precipitation

La probabilidad de precipitación prevista y la cantidad de precipitación acumulada durante la última hora.
air_pressure

AirPressure

Son las condiciones de presión atmosférica pronosticadas.
wind

Wind

Son las condiciones de viento pronosticadas.
visibility

Visibility

Es la visibilidad prevista.
ice_thickness

IceThickness

Es el grosor del hielo previsto.
is_daytime

bool

Es verdadero si esta hora se encuentra entre las horas locales del amanecer (inclusive) y el atardecer (exclusive). De lo contrario, es de noche (entre la puesta del sol y el siguiente amanecer). Nota: Esta hora se considerará diurna o nocturna si el intervalo se cruza con las horas locales del amanecer y el atardecer, respectivamente (p. ej., si el intervalo es de 5 a.m. a 6 a.m. y el amanecer es a las 5:59 a.m., entonces is_daytime será verdadero).
relative_humidity

int32

Porcentaje previsto de humedad relativa (valores del 0 al 100).
uv_index

int32

Es el índice de radiación ultravioleta (UV) previsto.
thunderstorm_probability

int32

Es la probabilidad pronosticada de tormenta eléctrica (valores de 0 a 100).
cloud_cover

int32

Es el porcentaje previsto del cielo cubierto por nubes (valores de 0 a 100).

HistoryHour

Representa un registro histórico por hora en una ubicación determinada.

Campos
interval

Interval

Es el intervalo de una hora (en hora UTC) para el que son válidos estos datos históricos (las marcas de tiempo se redondean a la hora más cercana).
display_date_time

DateTime

Fecha y hora locales en la zona horaria de la ubicación (hora civil) para la que se calcula este registro por hora. Este campo se puede usar para mostrar información en el cliente. Nota: Esta fecha constará del año, el mes, el día, la hora y el desplazamiento desde UTC.
weather_condition

WeatherCondition

Es la condición climática histórica.
temperature

Temperature

La temperatura histórica
feels_like_temperature

Temperature

Es la medida de cómo se sintió la temperatura en la ubicación solicitada.
dew_point

Temperature

Es el historial de la temperatura del punto de condensación.
heat_index

Temperature

Es la temperatura histórica de la sensación térmica.
wind_chill

Temperature

Sensación térmica histórica, temperatura del aire expuesta en la piel.
wet_bulb_temperature

Temperature

Es la temperatura histórica de la bombilla húmeda, la temperatura más baja que se puede alcanzar evaporando agua.
precipitation

Precipitation

La probabilidad histórica de precipitaciones y la cantidad de precipitaciones acumuladas durante la última hora.
air_pressure

AirPressure

Son las condiciones históricas de presión atmosférica.
wind

Wind

Son las condiciones históricas del viento.
visibility

Visibility

Es la visibilidad histórica.
ice_thickness

IceThickness

Es el grosor histórico del hielo.
is_daytime

bool

Es verdadero si esta hora se encuentra entre las horas locales del amanecer (inclusive) y el atardecer (exclusive). De lo contrario, es de noche (entre la puesta del sol y el siguiente amanecer). Nota: Esta hora se considerará diurna o nocturna si el intervalo se cruza con las horas locales del amanecer y el atardecer, respectivamente (p. ej., si el intervalo es de 5 a.m. a 6 a.m. y el amanecer es a las 5:59 a.m., entonces is_daytime será verdadero).
relative_humidity

int32

Porcentaje histórico de humedad relativa (valores de 0 a 100).
uv_index

int32

Es el índice histórico de radiación ultravioleta (UV).
thunderstorm_probability

int32

Es la probabilidad histórica de tormenta (valores de 0 a 100).
cloud_cover

int32

Porcentaje histórico del cielo cubierto por nubes (valores de 0 a 100).

IceThickness

Representa las condiciones de espesor del hielo.

Campos
unit

Unit

Es el código que representa la unidad que se usa para medir el grosor del hielo.
thickness

float

Es el valor del grosor del hielo.

Unidad

Representa la unidad que se usa para medir el grosor del hielo.

Enums
UNIT_UNSPECIFIED No se especifica la unidad.
MILLIMETERS El grosor se mide en milímetros.
INCHES El grosor se mide en pulgadas.

LookupCurrentConditionsRequest

Es la solicitud para la RPC de LookupCurrentConditions.

Campos
location

LatLng

Obligatorio. Es la ubicación para la que se obtendrán las condiciones climáticas actuales.
units_system

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).
language_code

string

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".

LookupCurrentConditionsResponse

Es la respuesta para la RPC de LookupCurrentConditions, que representa las condiciones climáticas actuales en la ubicación solicitada.

Campos
current_time

Timestamp

Hora actual (UTC) asociada a los datos devueltos.
time_zone

TimeZone

Zona horaria en la ubicación solicitada.
weather_condition

WeatherCondition

Es la condición climática actual.
temperature

Temperature

La temperatura actual
feels_like_temperature

Temperature

Es la medida de cómo se siente la temperatura actualmente en la ubicación solicitada.
dew_point

Temperature

Es la temperatura actual del punto de rocío.
heat_index

Temperature

La temperatura actual de la sensación térmica.
wind_chill

Temperature

La sensación térmica actual, la temperatura del aire a la que está expuesta la piel.
precipitation

Precipitation

La probabilidad de precipitación actual y la cantidad de precipitación acumulada durante la última hora.
air_pressure

AirPressure

Las condiciones de presión de aire actuales.
wind

Wind

Las condiciones actuales del viento.
visibility

Visibility

Es la visibilidad actual.
current_conditions_history

CurrentConditionsHistory

Son los cambios en las condiciones actuales durante las últimas 24 horas.
is_daytime

bool

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).
relative_humidity

int32

Es el porcentaje actual de humedad relativa (valores de 0 a 100).
uv_index

int32

Es el índice ultravioleta (UV) actual.
thunderstorm_probability

int32

Es la probabilidad actual de tormenta eléctrica (valores de 0 a 100).
cloud_cover

int32

Porcentaje actual del cielo cubierto por nubes (valores de 0 a 100).

CurrentConditionsHistory

Representa un conjunto de cambios en las condiciones actuales durante las últimas 24 horas.

Campos
temperature_change

Temperature

Es la temperatura actual menos la temperatura de hace 24 horas.
max_temperature

Temperature

La temperatura máxima (alta) en las últimas 24 horas.
min_temperature

Temperature

La temperatura mínima (baja) en las últimas 24 horas.
snow_qpf

QuantitativePrecipitationForecast

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

QuantitativePrecipitationForecast

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).

LookupForecastDaysRequest

Es la solicitud para la RPC de LookupForecastDays.

Campos
location

LatLng

Obligatorio. Es la ubicación para la que se obtendrá el pronóstico diario.
units_system

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).
page_size

int32

Opcional. Es la cantidad máxima de registros de pronóstico diario que se devolverán por página, con un valor de 1 a 10 (inclusive). El valor predeterminado es 5.
page_token

string

Opcional. Es un token de página que se recibió de una solicitud anterior. Se usa para recuperar la página siguiente.
days

int32

Opcional. Limita la cantidad de días totales que se recuperarán a partir del día actual. El valor debe ser de 1 a 10 (inclusive). El valor predeterminado es el valor máximo permitido de 10.
language_code

string

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".

LookupForecastDaysResponse

Es la respuesta para la RPC de LookupForecastDays.

Campos
forecast_days[]

ForecastDay

Son los registros de previsión diaria, según la cantidad de días y el tamaño de la página especificados en la solicitud.
time_zone

TimeZone

Zona horaria en la ubicación solicitada.
next_page_token

string

Es el token para recuperar la página siguiente.

LookupForecastHoursRequest

Es la solicitud para la RPC de LookupForecastHours.

Campos
location

LatLng

Obligatorio. Es la ubicación para la que se obtendrá el pronóstico por hora.
units_system

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).
page_size

int32

Opcional. Es la cantidad máxima de registros de previsión por hora que se devolverán por página, un valor de 1 a 24 (inclusive). El valor predeterminado es el valor máximo permitido de 24.
page_token

string

Opcional. Es un token de página que se recibió de una solicitud anterior. Se usa para recuperar la página siguiente.
hours

int32

Opcional. Limita la cantidad de horas totales que se recuperarán a partir de la hora actual. El valor debe ser de 1 a 240 (inclusive). El valor predeterminado es el valor máximo permitido de 240.
language_code

string

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".

LookupForecastHoursResponse

Es la respuesta para la RPC de LookupForecastHours.

Campos
forecast_hours[]

ForecastHour

Registros de previsión por hora, según la cantidad de horas y el tamaño de la página especificados en la solicitud.
time_zone

TimeZone

Zona horaria en la ubicación solicitada.
next_page_token

string

Es el token para recuperar la página siguiente.

LookupHistoryHoursRequest

Es la solicitud para la RPC de LookupHistoryHours.

Campos
location

LatLng

Obligatorio. Es la ubicación para la que se obtendrán los datos históricos por hora.
units_system

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).
page_size

int32

Opcional. Es la cantidad máxima de registros históricos por hora que se devolverán por página, con un valor de 1 a 24 (inclusive). El valor predeterminado es el valor máximo permitido de 24.
page_token

string

Opcional. Es un token de página que se recibió de una solicitud anterior. Se usa para recuperar la página siguiente.
hours

int32

Opcional. Limita la cantidad de horas totales que se recuperarán a partir de la última hora, de 1 a 24 (inclusive). El valor predeterminado es el valor máximo permitido de 24.
language_code

string

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".

LookupHistoryHoursResponse

Es la respuesta para la RPC de LookupHistoryHours.

Campos
history_hours[]

HistoryHour

Son los registros históricos por hora, según la cantidad de horas y el tamaño de página especificados en la solicitud.
time_zone

TimeZone

Zona horaria en la ubicación solicitada.
next_page_token

string

Es el token para recuperar la página siguiente.

LookupPublicAlertsRequest

Es la solicitud para la RPC de LookupPublicAlerts.

Campos
location

LatLng

Obligatorio. Ubicación para la que se obtendrán alertas meteorológicas públicas. El servicio devolverá alertas cuya área afectada se interseca con esta ubicación.
page_size

int32

Opcional. Es la cantidad máxima de registros de alertas meteorológicas públicas que se devolverán por página.
page_token

string

Opcional. Es un token de página que se recibió de una llamada a LookupPublicAlerts anterior. Proporciona esto para recuperar la página siguiente. Cuando se realiza la paginación, todos los demás parámetros proporcionados a LookupPublicAlerts deben guardar correspondencia con la llamada que proporcionó el token de la página.
language_code

string

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".

LookupPublicAlertsResponse

Es la respuesta para la RPC de LookupPublicAlerts.

Campos
weather_alerts[]

PublicAlerts

Son los registros de alertas meteorológicas públicas, según la cantidad de alertas y el tamaño de página especificados en la solicitud.
region_code

string

Es el código ISO_3166-1 alfa-2 de la región que corresponde a la ubicación proporcionada en la solicitud. La región se indica con ISO_3166-1_alpha-2.
next_page_token

string

Es un token que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

MoonEvents

Representa los eventos relacionados con la Luna (p.ej., salida y puesta de la Luna).

Campos
moonrise_times[]

Timestamp

Es el momento en que el limbo superior de la Luna aparece sobre el horizonte (consulta https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOTA: En la mayoría de los casos, habrá una sola hora de salida de la Luna por día. En otros casos, la lista podría estar vacía (p.ej., cuando la luna sale después de la medianoche del día siguiente). Sin embargo, en casos únicos (p.ej., en regiones polares), la lista puede contener más de un valor. En estos casos, los valores se ordenan de forma ascendente.
moonset_times[]

Timestamp

Es el momento en que el extremo superior de la Luna desaparece tras el horizonte (consulta https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOTA: En la mayoría de los casos, habrá una sola hora de puesta de la Luna por día. En otros casos, la lista podría estar vacía (p.ej., cuando la luna se oculta después de la medianoche del día siguiente). Sin embargo, en casos únicos (p.ej., en regiones polares), la lista puede contener más de un valor. En estos casos, los valores se ordenan de forma ascendente.
moon_phase

MoonPhase

Fase lunar (también conocida como fase de la Luna)

MoonPhase

Marca la fase lunar.

Enums
MOON_PHASE_UNSPECIFIED Fase lunar no especificada.
NEW_MOON La Luna no está iluminada por el Sol.
WAXING_CRESCENT La luna se ilumina entre un 0% y un 50% en su lado derecho en el hemisferio norte 🌒 y en su lado izquierdo en el hemisferio sur 🌘.
FIRST_QUARTER La Luna está iluminada en un 50.1% en su lado derecho en el hemisferio norte 🌓 y en su lado izquierdo en el hemisferio sur 🌗.
WAXING_GIBBOUS La luna se ilumina entre un 50% y un 100% en su lado derecho en el hemisferio norte 🌔 y en su lado izquierdo en el hemisferio sur 🌖.
FULL_MOON La Luna está completamente iluminada.
WANING_GIBBOUS La luna se ilumina entre un 50% y un 100% en su lado izquierdo en el hemisferio norte 🌖 y en su lado derecho en el hemisferio sur 🌔.
LAST_QUARTER La Luna está iluminada en un 50.1% en su lado izquierdo en el hemisferio norte 🌗 y en su lado derecho en el hemisferio sur 🌓.
WANING_CRESCENT La luna se ilumina entre un 0% y un 50% en su lado izquierdo en el hemisferio norte 🌘 y en su lado derecho en el hemisferio sur 🌒.

Precipitaciones

Representa un conjunto de valores de precipitación en una ubicación determinada.

Campos
probability

PrecipitationProbability

Es la probabilidad de precipitaciones (valores de 0 a 100).
snow_qpf

QuantitativePrecipitationForecast

Es la cantidad de nieve, medida como equivalente de agua líquida, que se acumuló durante un período. Nota: QPF es la abreviatura de pronóstico cuantitativo de precipitaciones (consulta la definición de QuantitativePrecipitationForecast para obtener más detalles).
qpf

QuantitativePrecipitationForecast

Es la cantidad de lluvia acumulada durante un período, 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).

PrecipitationProbability

Representa la probabilidad de precipitaciones en una ubicación determinada.

Campos
type

PrecipitationType

Es un código que indica el tipo de precipitación.
percent

int32

Es un porcentaje de 0 a 100 que indica las probabilidades de precipitaciones.

PrecipitationType

Representa el tipo de precipitación en una ubicación determinada.

Enums
PRECIPITATION_TYPE_UNSPECIFIED Tipo de precipitación sin especificar.
NONE No hay precipitaciones.
SNOW Precipitaciones de nieve.
RAIN Precipitación de lluvia.
LIGHT_RAIN Precipitación de lluvia ligera.
HEAVY_RAIN Precipitaciones intensas
RAIN_AND_SNOW Precipitaciones de lluvia y nieve
SLEET Precipitaciones de aguanieve.
FREEZING_RAIN Precipitación de lluvia engelante.

PublicAlerts

Representa las alertas meteorológicas públicas.

Campos
alert_id

string

Es el identificador único de esta alerta.
alert_title

LocalizedText

Es el título localizado de la alerta.
event_type

WeatherEventType

Es el tipo de evento meteorológico.
area_name

string

Es el nombre del área en la que se emite la alerta.
instruction[]

string

Instrucciones recomendadas por el publicador. Ten en cuenta que, si bien este campo debe estar localizado, no se garantiza que lo esté.
safety_recommendations[]

SafetyRecommendation

Directiva de recomendaciones de seguridad para el usuario. El editor o las autoridades pueden proporcionarlas.
timezone_offset

string

Es la diferencia de zona horaria con respecto a la hora UTC para la ubicación de la alerta. El valor tiene el formato de una cadena que termina en “s”, p.ej., "-14400s" para 4 horas detrás de la hora UTC
start_time

Timestamp

Es la hora de inicio del evento.
expiration_time

Timestamp

Es la hora de vencimiento del evento.
data_source

DataSource

Son los detalles del publicador que emitió la alerta.
polygon

string

Es una representación en formato GeoJSON de las áreas en las que se emite la alerta.

Los datos de GeoJSON deben estar en formato RFC 7946 y representar un polígono (para un área contigua única) o un multipolígono (para varias áreas distintas).

Ejemplo:

{ "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }

Una cadena de GeoJSON de MultiPolygon de ejemplo se ve de la siguiente manera:

{ "type": "MultiPolygon", "coordinates": [ [ [0, 0], [-1, 0], [-1, 1], [0, 0] ], [ [0, 0], [-2, 0], [-2, 2], [0, 0] ] ]
description

string

Es el texto más reciente que describe la alerta tal como la emitió la autoridad oficial. Ten en cuenta que, si bien este campo debe estar localizado, no se garantiza que lo esté.
severity

Severity

Es el nivel de gravedad de la alerta.
certainty

Certainty

Es la certeza de la alerta.
urgency

Urgency

Es la urgencia de la alerta.

Editor

Es el publicador de la alerta.

Enums
PUBLISHER_UNSPECIFIED No se especificó el publicador.
AUSTRALIA_ACT_ESA Australia, Territorio de la Capital Australiana
AUSTRALIA_NSW_RFS Nueva Gales del Sur
AUSTRALIA_QLD_QFES Queensland
AUSTRALIA_SA_CFS Australia del Sur
METEO_ALARM_AT Meteoalarm / EUMETNET Austria
METEO_ALARM_BS Bosnia
BRAZIL_CENAD Agencia de Desastres de Brasil
BRAZIL_INMET Agencia Meteorológica de Brasil
UK_ENV_AGENCY Reino Unido
METEO_ALARM_BG Meteoalarm / EUMETNET Bulgaria
METEO_ALARM_CR Croacia
METEO_ALARM_CY Chipre
METEO_ALARM_CS República Checa
METEO_ALARM_DK Dinamarca
EC_INAMHI Ecuador
METEO_ALARM_FI Meteoalarm / EUMETNET Finland
METEO_ALARM_FR Francia
DE_DWD Alemania
METEO_ALARM_GB Meteoalarm / EUMETNET, Gran Bretaña
METEO_ALARM_GR Grecia
METEO_ALARM_HU Hungría
METEO_ALARM_IS Islandia
METEO_ALARM_IE Irlanda
METEO_ALARM_IT Italia
JM_JMS Jamaica
JMA Japón
METEO_ALARM_NL Meteoalarm / EUMETNET Países Bajos
METEO_ALARM_LV Letonia
METEO_ALARM_LT Lituania
METEO_ALARM_LU Luxemburgo
MEXICO_CIRES México, México CIRES
NZ_GEONET Nueva Zelanda: GeoNet de Nueva Zelanda
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET Macedonia del Norte
METEO_ALARM_NO Noruega
PHILIPPINES_PAGASA Filipinas
METEO_ALARM_PL Meteoalarm / EUMETNET Polonia
METEO_ALARM_PT Portugal
METEO_ALARM_RO Rumania
METEO_ALARM_RS Serbia
SG_MSS Singapur
METEO_ALARM_SK Meteoalarm / EUMETNET Slovakia
METEO_ALARM_SI Eslovenia
SB_MET Islas Salomón
METEO_ALARM_ES Meteoalarm / EUMETNET España
METEO_ALARM_SE Suecia
METEO_ALARM_CH Suiza
TAIWAN_NCDR Taiwán
NOAA NOAA de Estados Unidos
WCATWC National Tsunami Warning Center

QuantitativePrecipitationForecast

Representa la cantidad esperada de precipitación derretida acumulada durante un período específico en un área determinada (referencia: https://en.wikipedia.org/wiki/Quantitative_precipitation_forecast). Por lo general, se abrevia como QPF.

Campos
unit

Unit

Es el código de la unidad que se usa para medir la cantidad de precipitación acumulada.
quantity

float

Es la cantidad de precipitación, medida como equivalente de agua líquida, que se acumuló durante un período.

Unidad

Representa la unidad que se usa para medir la cantidad de precipitación acumulada.

Enums
UNIT_UNSPECIFIED Unidad de precipitación no especificada.
MILLIMETERS La cantidad de precipitación se mide en milímetros.
INCHES La cantidad de precipitación se mide en pulgadas.

SafetyRecommendation

Representa una recomendación de seguridad.

Campos
directive

string

Es una directiva para el usuario. Ten en cuenta que, si bien este campo debe estar localizado, no se garantiza que lo esté.
subtext

string

Es un texto secundario opcional para la directiva, que puede contener contexto adicional para el usuario. Ten en cuenta que, si bien este campo debe estar localizado, no se garantiza que lo esté.

Gravedad

Es el código que denota la gravedad del evento principal del mensaje de alerta.

Enums
SEVERITY_UNKNOWN No se conoce la gravedad.
EXTREME Amenaza extraordinaria contra la vida o la propiedad
SEVERE Amenaza significativa para la vida o la propiedad
MODERATE Posible amenaza para la vida o la propiedad.
MINOR Amenaza leve para la vida o la propiedad

SpeedUnit

Representa la unidad que se usa para medir la velocidad.

Enums
SPEED_UNIT_UNSPECIFIED La unidad de velocidad no está especificada.
KILOMETERS_PER_HOUR La velocidad se mide en kilómetros por hora.
MILES_PER_HOUR La velocidad se mide en millas por hora.

SunEvents

Representa los eventos relacionados con el sol (p.ej., amanecer, atardecer).

Campos
sunrise_time

Timestamp

Es la hora en que sale el sol.

NOTA: En algunos casos únicos (p.ej., al norte del círculo polar ártico), es posible que no haya hora de amanecer para un día. En estos casos, este campo no se establecerá.
sunset_time

Timestamp

Es la hora en que se pone el sol.

NOTA: En algunos casos únicos (p.ej., al norte del círculo polar ártico), es posible que no haya hora de puesta del sol en un día. En estos casos, este campo no se establecerá.

Temperatura

Representa un valor de temperatura.

Campos
unit

TemperatureUnit

Es el código de la unidad que se usa para medir el valor de la temperatura.
degrees

float

Es el valor de temperatura (en grados) en la unidad especificada.

TemperatureUnit

Representa una unidad que se usa para medir temperaturas.

Enums
TEMPERATURE_UNIT_UNSPECIFIED La unidad de temperatura no está especificada.
CELSIUS La temperatura se mide en grados Celsius.
FAHRENHEIT La temperatura se mide en grados Fahrenheit.

UnitsSystem

Representa el sistema de unidades que se usa para medir los valores.

Enums
UNITS_SYSTEM_UNSPECIFIED El sistema de unidades no está especificado.
IMPERIAL El sistema de unidades imperiales (p. ej., Fahrenheit, millas, etcétera)
METRIC El sistema de unidades métricas (p.ej., Celsius, kilómetros, etcétera).

Urgencia

Es el código que denota la urgencia del evento principal del mensaje de alerta.

Enums
URGENCY_UNKNOWN No se conoce la urgencia.
IMMEDIATE Se DEBE tomar una medida de respuesta de inmediato.
EXPECTED Se DEBERÍA tomar una acción de respuesta pronto (en la próxima hora).
FUTURE Se DEBE tomar una medida de respuesta en el futuro cercano.
PAST Ya no se requiere una acción de respuesta.

Visibilidad

Representa las condiciones de visibilidad, es decir, la distancia a la que se pueden distinguir los objetos.

Campos
unit

Unit

Es el código que representa la unidad utilizada para medir la distancia.
distance

float

Es la distancia de visibilidad en la unidad especificada.

Unidad

Representa la unidad que se usa para medir la distancia de visibilidad.

Enums
UNIT_UNSPECIFIED La unidad de visibilidad no está especificada.
KILOMETERS La visibilidad se mide en kilómetros.
MILES La visibilidad se mide en millas.

WeatherCondition

Representa una condición climática para una ubicación determinada en un período determinado.

Descargo de responsabilidad: Los íconos del clima y los códigos de condición están sujetos a cambios. Google puede introducir códigos e íconos nuevos, o actualizar los existentes según sea necesario. Te recomendamos que consultes esta documentación periódicamente para obtener la información más actualizada.

Campos
icon_base_uri

string

Es el URI base del ícono sin incluir la extensión del tipo de archivo. Para mostrar el ícono, agrega un tema si lo deseas y la extensión del tipo de archivo (.png o .svg) a este URI. De forma predeterminada, el ícono tiene un tema claro, pero se puede agregar _dark para el modo oscuro. Por ejemplo, "https://maps.gstatic.com/weather/v1/dust.svg" o "https://maps.gstatic.com/weather/v1/dust_dark.svg", donde icon_base_uri es "https://maps.gstatic.com/weather/v1/dust".
description

LocalizedText

Es la descripción textual de esta condición climática (localizada).
type

Type

Es el tipo de condición climática.

Tipo

Marca el tipo de condición climática en el contexto de un elemento de pronóstico.

Enums
TYPE_UNSPECIFIED No se especifica la condición climática.
CLEAR Sin nubes.
MOSTLY_CLEAR Nubes intermitentes
PARTLY_CLOUDY Parcialmente nublado (algunas nubes).
MOSTLY_CLOUDY Mayormente nublado (más nubes que sol)
CLOUDY Nublado (todas las nubes, sin sol).
WINDY Viento fuerte
WIND_AND_RAIN Viento fuerte con precipitaciones.
LIGHT_RAIN_SHOWERS Lluvia ligera intermitente.
CHANCE_OF_SHOWERS Probabilidad de lluvias intermitentes.
SCATTERED_SHOWERS Lluvias intermitentes
RAIN_SHOWERS Las lluvias se consideran precipitaciones que tienen una duración más corta que la lluvia y se caracterizan por su repentinidad en términos de horas de inicio y finalización, y cambios rápidos en la intensidad.
HEAVY_RAIN_SHOWERS Lluvias intensas
LIGHT_TO_MODERATE_RAIN Lluvia (de leve a moderada en cantidad)
MODERATE_TO_HEAVY_RAIN Lluvia (de moderada a intensa en cantidad)
RAIN Lluvias moderadas.
LIGHT_RAIN Lluvia ligera.
HEAVY_RAIN Lluvia intensa.
RAIN_PERIODICALLY_HEAVY Lluvias, por momentos intensas
LIGHT_SNOW_SHOWERS Nevadas leves que caen con intensidades variables durante períodos breves.
CHANCE_OF_SNOW_SHOWERS Probabilidad de nevadas.
SCATTERED_SNOW_SHOWERS Nevadas con intensidades variables durante períodos breves.
SNOW_SHOWERS Chubascos de nieve.
HEAVY_SNOW_SHOWERS Chubascos de nieve intensos.
LIGHT_TO_MODERATE_SNOW Nevadas leves a moderadas
MODERATE_TO_HEAVY_SNOW Nevadas moderadas a intensas
SNOW Nevadas moderadas
LIGHT_SNOW Nevadas ligeras
HEAVY_SNOW Nevadas intensas
SNOWSTORM Nieve con posibles truenos y relámpagos.
SNOW_PERIODICALLY_HEAVY Nevadas, por momentos intensas
HEAVY_SNOW_STORM Nevadas intensas con posibles truenos y relámpagos.
BLOWING_SNOW Nieve con viento intenso.
RAIN_AND_SNOW Mezcla de lluvia y nieve.
HAIL Granizo
HAIL_SHOWERS Granizo que cae con diferentes intensidades durante períodos breves.
THUNDERSTORM Tormenta eléctrica.
THUNDERSHOWER Una lluvia acompañada de truenos y relámpagos.
LIGHT_THUNDERSTORM_RAIN Tormentas eléctricas con lluvia de poca intensidad.
SCATTERED_THUNDERSTORMS Tormentas eléctricas con lluvias de diversas intensidades durante períodos breves.
HEAVY_THUNDERSTORM Tormenta eléctrica intensa.

WeatherEventType

Es el tipo de evento meteorológico.

Enums
WEATHER_EVENT_TYPE_UNSPECIFIED Tipo de evento meteorológico no especificado.
ACID_RAIN Evento de lluvia ácida.
AFTERSHOCK Evento de réplica.
AVALANCHE Evento de avalancha.
BLIZZARD Evento de tormenta de nieve.
BLOWING_SNOW Evento de ventisca de nieve.
BUSHFIRE Evento de incendio forestal.
COASTAL_FLOOD Evento de inundación costera.
COASTAL_HAZARD Evento de peligro costero.
COLD Evento de ruta de acceso fría.
CYCLONE Evento de ciclón.
DROUGHT Evento de sequía.
DUST_STORM Es un evento de tormenta de.
EARTHQUAKE Es un evento de terremoto.
EXTRATROPICAL_CYCLONE Evento de ciclón tropical adicional.
FIRE Es un evento de incendio.
FIRE_WEATHER Evento de clima de incendios.
FLASH_FLOOD Evento de inundación repentina.
FLOOD Evento de inundación.
FOG Evento de niebla.
FREEZING Evento de congelamiento.
FREEZING_AIR_TEMPERATURE Evento de temperatura del aire bajo cero.
FREEZING_DRIZZLE Evento de llovizna helada.
FREEZING_RAIN_EVENT Evento de lluvia engelante.
FROST Evento de helada.
GALE Evento de Gale.
GLAZE Evento de acristalamiento.
HAIL Evento de granizo.
HAZARDOUS_SEAS Evento de mares peligrosos.
HEAT Evento de calor.
HUMIDITY Evento de humedad.
HURRICANE Evento de huracán.
ICE_STORM Evento de tormenta de hielo.
INDUSTRIAL_FIRE Incendio industrial.
LAKE_EFFECT_SNOW Evento de nevadas por efecto lacustre.
LANDSLIDE Evento de deslizamiento de tierra.
MONSOON Evento de monzón.
MUDDY_FLOOD Evento de inundación con lodo.
OUTFLOW Evento de salida.
RADIATION Evento de radiación.
RAIN_EVENT Evento de lluvia.
RIVER_FLOODING Evento de inundación fluvial.
SEVERE_THUNDERSTORM_WARNING Evento de alerta por tormenta eléctrica intensa.
SNOWSQUALL Evento de nevada repentina.
SNOW_EVENT Evento de nieve.
STORM Evento de tormenta.
STORM_SURGE Evento de marejada ciclónica.
THUNDER Evento de rayo.
THUNDERSTORM Evento de tormenta eléctrica.
TORNADO Evento de tornado.
TORNADO_WARNING Evento de alerta por tornado.
TROPICAL_CYCLONE Evento de ciclón tropical.
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES Evento de alertas y avisos de ciclones tropicales.
TROPICAL_DISTURBANCE Evento de tormenta tropical.
TROPICAL_STORM Evento de tormenta tropical.
TSUNAMI Evento de tsunami.
TYPHOON Evento de tifón.
VOLCANIC_ASH Evento de ceniza volcánica.
VOLCANIC_ERUPTION Evento de erupción volcánica.
WILDFIRE Evento de incendio forestal.
WIND Es un evento de viento.
WIND_CHILL Evento de sensación térmica.
WIND_WAVE Evento de olas de viento.
WINTER_STORM Evento de tormenta de invierno.

Wind

Representa un conjunto de propiedades del viento.

Campos
direction

WindDirection

La dirección del viento, el ángulo desde el que llega.
speed

WindSpeed

Es la velocidad del viento.
gust

WindSpeed

La ráfaga de viento (aumento repentino de la velocidad del viento).

WindDirection

Representa la dirección desde la que se origina el viento.

Campos
cardinal

CardinalDirection

Es el código que representa la dirección cardinal desde la que sopla el viento.
degrees

int32

Dirección del viento en grados (valores de 0 a 360).

WindSpeed

Representa la velocidad del viento.

Campos
unit

SpeedUnit

Es el código que representa la unidad que se usa para medir la velocidad del viento.
value

float

Es el valor de la velocidad del viento.