Method: publicAlerts.lookup

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

Solicitud HTTP

GET https://weather.googleapis.com/v1/publicAlerts:lookup

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
location

object (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.
pageSize

integer

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

string

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

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

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es la respuesta para la RPC de publicAlerts.lookup.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "weatherAlerts": [
    {
      object (PublicAlerts)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
Campos
weatherAlerts[]

object (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.
regionCode

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

string

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

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

PublicAlerts

Representa las alertas meteorológicas públicas.

Representación JSON 
{
  "alertId": string,
  "alertTitle": {
    object (LocalizedText)
  },
  "eventType": enum (WeatherEventType),
  "areaName": string,
  "instruction": [
    string
  ],
  "safetyRecommendations": [
    {
      object (SafetyRecommendation)
    }
  ],
  "timezoneOffset": string,
  "startTime": string,
  "expirationTime": string,
  "dataSource": {
    object (DataSource)
  },
  "polygon": string,
  "description": string,
  "severity": enum (Severity),
  "certainty": enum (Certainty),
  "urgency": enum (Urgency)
}
Campos
alertId

string

Es el identificador único de esta alerta.
alertTitle

object (LocalizedText)

Es el título localizado de la alerta.
eventType

enum (WeatherEventType)

Es el tipo de evento meteorológico.
areaName

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é.
safetyRecommendations[]

object (SafetyRecommendation)

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

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
startTime

string (Timestamp format)

Es la hora de inicio del evento.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
expirationTime

string (Timestamp format)

Es la hora de vencimiento del evento.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
dataSource

object (DataSource)

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

string

Es una representación de 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

enum (Severity)

Es el nivel de gravedad de la alerta.
certainty

enum (Certainty)

Es la certeza de la alerta.
urgency

enum (Urgency)

Es la urgencia de la alerta.

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.

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

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

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.

SafetyRecommendation

Representa una recomendación de seguridad.

Representación JSON 
{
  "directive": string,
  "subtext": string
}
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é.

DataSource

Representa un vínculo a una fuente de datos.

Representación JSON 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
Campos
publisher

enum (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é.
authorityUri

string

Es la URL del sitio web de la autoridad.

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