El extremo publicAlerts proporciona detalles sobre alertas de eventos climáticos específicos emitidas por agencias nacionales e internacionales autorizadas. Estas alertas proporcionan información crucial
que puede salvar vidas.
El extremo devuelve las alertas meteorológicas que se producen en tiempo real para una latitud y longitud determinadas. Entre los eventos meteorológicos admitidos, se incluyen los siguientes:
- Precipitación: Lluvia, nieve, granizo, sequías y mucho más
- Temperaturas extremas: Frío, calor, congelamiento, escarcha, sensación térmica y humedad
- Eventos de viento y tormenta: Ventiscas, huracanes, tornados, tormentas tropicales, tormentas eléctricas y mucho más
- Problemas de visibilidad: Niebla, tormentas de y ventiscas de nieve
- Peligros relacionados con el agua: Inundaciones, tsunamis, marejadas ciclónicas, peligros costeros y mucho más
- Eventos geofísicos y geológicos: Terremotos, deslizamientos de tierra y actividad volcánica
- Incidentes de incendios: Incendios forestales, condiciones meteorológicas propicias para incendios y mucho más
Para obtener una lista completa de los eventos meteorológicos compatibles, consulta Tipos de eventos meteorológicos.
Las alertas pueden contener o no descripciones localizadas, según lo que esté disponible en la fuente de datos. Debido a las restricciones de la fuente de datos, la información se entrega tal como está (contenido sin procesar). Para obtener más información sobre las fuentes de alertas meteorológicas, consulta Fuentes de datos.
La API devuelve la siguiente información para una alerta meteorológica determinada:
- El tipo de evento meteorológico asociado con la alerta
- Una lista de las áreas afectadas junto con las coordenadas que definen los límites geográficos de esas áreas
- Un resumen de una oración del evento climático
- Niveles de gravedad, certeza y urgencia
- Una descripción de las instrucciones de acción recomendadas para el público objetivo
- Recomendaciones de seguridad
- Horas de inicio y finalización de la alerta
- El nombre y el sitio web de la autoridad de publicación
El Explorador de APIs te permite realizar solicitudes en tiempo real para que puedas familiarizarte con la API y sus opciones:
Acerca de las solicitudes de alertas meteorológicas
Para solicitar información sobre alertas meteorológicas, envía una solicitud GET de HTTP a la siguiente dirección:
https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE
Incluye las coordenadas de latitud y longitud de la ubicación en los parámetros de URL de tu solicitud.
Acerca de las respuestas a las alertas meteorológicas
La API de Weather devuelve los siguientes campos en el cuerpo de la respuesta:
| Campo | Tipo | Descripción | Obligatorio u opcional |
|---|---|---|---|
alertId |
String | Es el ID de la alerta. También puedes encontrar esta información en el sitio web del proveedor de datos. | Obligatorio |
alertTitle |
String | Es el título de la alerta, que describe el evento meteorológico. Nota: Esta es la única cadena que se traduce cuando se incluye un parámetro de código de idioma en la solicitud. |
Obligatorio |
eventType |
Enum | Es el tipo de evento meteorológico asociado con la alerta. Para obtener una lista completa de los eventos meteorológicos admitidos, consulta Tipos de eventos meteorológicos. |
Obligatorio |
areaName |
String | Es el nombre del área geográfica afectada por la alerta, que incluye la ubicación solicitada. | Obligatorio |
polygon |
String | Son las coordenadas que definen un área dimensional cerrada de la alerta. | Opcional |
description |
String | Es una frase breve que resume la descripción del evento en el idioma especificado (por ejemplo, "Alerta de tornado"). | Opcional |
severity |
Enum | El nivel de gravedad de la alerta:
|
Opcional |
certainty |
Enum | El nivel de certeza de la alerta:
|
Opcional |
urgency |
Enum | El nivel de urgencia de la alerta:
|
Opcional |
instruction |
String | Descripción de las instrucciones de acción responsiva para el público objetivo. | Opcional |
safetyRecommendations |
String | Recomendaciones de seguridad basadas en los códigos de las autoridades públicas Incluye directivas de nivel superior y subtexto con información adicional. | Opcional |
timezoneOffset |
String | Es la diferencia de zona horaria del evento, en formato +/-HH:MM. | Obligatorio |
startTime |
Fecha y hora | La fecha y hora de época vigentes (hora UTC) de la información del mensaje de alerta. | Opcional |
expirationTime |
Fecha y hora | La fecha y hora de Epoch (hora UTC) en que se espera que finalice una alerta. Puede ser nulo para eventos de duración indefinida, en cuyo caso el titular indicará que el evento está "en curso". | Opcional |
dataSource |
Enum | Detalles de la autoridad, incluidos el publicador, el nombre y la URL. | Obligatorio |
regionCode |
Enum | Es el código de región de la ubicación que se solicitó. | Opcional |
Fuentes de datos
El extremo de alertas meteorológicas devuelve los datos que publican los proveedores que se indican en la siguiente tabla. Según las coordenadas de latitud y longitud proporcionadas en la solicitud, el cuerpo de la respuesta muestra datos de la autoridad local correspondiente.
Los proveedores incluidos en el feed siguen los lineamientos de las Alertas públicas de Google. Google puede actualizar la lista de proveedores en cualquier momento.
Atribución
En todas las pantallas en las que se presenten los datos, la aplicación del cliente debe
incluir una atribución a la fuente original con el campo dataSource:
"dataSource": {
"publisher": "NOAA",
"name": "National Weather Service",
"authorityUri": "https://www.weather.gov/"
}
La atribución debe incluir el nombre completo de la fuente de datos (como se proporciona en
el campo name) y un hipervínculo a la fuente de datos con la URL proporcionada en el
campo authorityUri (por ejemplo, "Servicio Meteorológico
Nacional").
Tipos de eventos meteorológicos
Se admiten los siguientes tipos de eventos meteorológicos:
| Tipos de eventos meteorológicos | |
|---|---|
ACID_RAINAVALANCHEBLIZZARDBLOWING_SNOWCOASTAL_FLOODCOASTAL_HAZARDCOLDCYCLONEDROUGHTEXTRATROPICAL_CYCLONEFIRE_WEATHERFLASH_FLOODFLOODFOGFREEZINGFREEZING_AIR_TEMPERATUREFREEZING_DRIZZLEFREEZING_RAINFROSTGALEGLAZEHAILHAZARDOUS_SEASHEATHUMIDITYHURRICANEICE_STORMLAKE_EFFECT_SNOWMONSOONMUDDY_FLOODOUTFLOWRAIN
|
RIVER_FLOODINGSEVERE_THUNDERSTORM_WARNINGSNOWSNOWSQUALLSTORMSTORM_SURGETHUNDERTHUNDERSTORMTORNADOTORNADO_WARNINGTROPICAL_CYCLONETROPICAL_CYCLONE_WARNINGS_AND_WATCHESTROPICAL_DISTURBANCETROPICAL_STORMTYPHOONWINDWIND_CHILLWIND_WAVEWINTER_STORMWILDFIREBUSHFIREFIRELANDSLIDEEARTHQUAKEDUST_STORMAFTERSHOCKTSUNAMIVOLCANIC_ASHVOLCANIC_ERUPTIONRADIATION |
Comportamiento de la traducción de respuestas
Google proporciona traducciones solo para el campo alertTitle. Otros campos, como eventType, areaName, instruction y safetyRecommendations, también se pueden traducir, según la compatibilidad de idiomas de la fuente de datos original. Sin embargo, Google no puede proporcionar traducciones independientes para estos campos.
Según el parámetro languageCode incluido en la solicitud, se esperan los siguientes
comportamientos para el campo alertTitle:
languageCodeadmitido: Si ellanguageCodesolicitado se proporciona y se admite, la respuesta se devuelve en el idioma solicitado.languageCodeno admitido: En los casos en que no se admita ellanguageCodesolicitado y no se pueda encontrar una alternativa cercana, el extremo devuelve la respuesta en inglés de forma predeterminada.- No se proporcionó ningún
languageCode: El extremo devuelve la respuesta en inglés de forma predeterminada.
Ejemplo de solicitud de alerta meteorológica
En el siguiente ejemplo, se solicita información sobre alertas meteorológicas para una ciudad de Carolina del Norte:
curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635 &location.longitude=-78.3168047 &languageCode=en"
El cuerpo de la respuesta es el siguiente:
{ "weatherAlerts": [ { "alertId": "urn:oid:2.49.0.1.840.0.2416b1b5a6f51d29ef4b94948328dca303fbbb5c.001.1", "alertTitle": { "text": "Flash Flood Warning", "languageCode": "en" }, "eventType": "FLASH_FLOOD", "areaName": "Franklin, NC; Johnston, NC; Nash, NC; Wake, NC", "polygon": "{\"type\":\"Polygon\",\"coordinates\":[[[-78.450000,35.820000],[-78.410000,35.730000],[-78.280000,35.660000],[-78.180000,35.740000],[-77.840000,36.150000],[-77.890000,36.140000],[-77.900000,36.160000],[-77.920000,36.170000], [-77.930000,36.190000], [-77.940000,36.190000],[-77.950000,36.180000],[-77.970000,36.190000],[-77.970000,36.180000], [-77.980000,36.180000],[-78.010000,36.210000],[-78.040000,36.210000],[-78.110000,36.210000],[-78.130000,36.230000], [-78.350000,35.940000],[-78.450000,35.820000]]]}", "description": "FFWRAH\n\nThe National Weather Service in Raleigh has issued a\n\n* Flash Flood Warning for... \nEastern Franklin County in central North Carolina...\nNorth Central Johnston County in central North Carolina... \nWestern Nash County in central North Carolina...\nEast Central Wake County in central North Carolina... \n\n* Until 530 PM EDT.\n\n* At 224 PM EDT, local law enforcement reported flash flooding in\nSpring Hope. Between 3 and 5 inches of rain have fallen. \nAdditional rainfall amounts of 1 to 3 inches are possible in the\nwarned area.\n\nHAZARD...Life threatening flash flooding. Heavy rain producing\nflash flooding.\n\nSOURCE...Law enforcement reported.\n\nIMPACT...Life threatening flash flooding of creeks and streams,\nurban areas, highways, streets and underpasses.\n\n* Some locations that will experience flash flooding include... \nZebulon, Bunn, Wendell, Spring Hope, Middlesex, Castalia,\nCenterville, Pilot, Emit and Aventon.", "severity": "SEVERE", "certainty": "LIKELY", "urgency": "IMMEDIATE", "instruction": [ "Turn around, don't drown when encountering flooded roads. Most flood\ndeaths occur in vehicles." ], "safetyRecommendations": [ { "directive": "Build an emergency kit and make a family communications plan.", "subtext": "Follow the instructions at http://www.ready.gov/build-a-kit for building an emergency kit and http://www.ready.gov/make-a-plan for a family communications plan." }, { "directive": "Be aware that flash flooding can occur. ", "subtext": "If there is any possibility of a flash flood, move immediately to higher ground. Do not wait for instructions to move." }, ... ], "timezoneOffset": "-14400s", "startTime": "2025-08-06T18:24:00Z", "expirationTime": "2025-08-06T21:30:00Z", "dataSource": { "publisher": "NOAA", "name": "National Weather Service", "authorityUri": "https://www.weather.gov/" } } ], "regionCode": "US" }
Pruébalo
El Explorador de APIs te permite realizar solicitudes de ejemplo para que puedas familiarizarte con la API y sus opciones.
Selecciona el ícono de API api en el lado derecho de la página.
De manera opcional, edita los parámetros de la solicitud.
Selecciona el botón Ejecutar. En el cuadro de diálogo, elige la cuenta que quieras usar para realizar la solicitud.
En el panel del Explorador de APIs, selecciona el ícono de pantalla completa fullscreen para expandir la ventana del Explorador de APIs.