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 podría salvar vidas.
El extremo devuelve alertas meteorológicas que ocurren en tiempo real para una latitud y longitud determinadas. Entre los eventos climáticos admitidos, se incluyen los siguientes:
- Precipitación: Lluvia, nieve, granizo, sequías y mucho más
- Temperaturas extremas: Frío, calor, congelación, heladas, sensación térmica y humedad
- Eventos de viento y tormentas: Tormentas de nieve, 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, clima de incendios y más
Para obtener una lista completa de los eventos climáticos compatibles, consulta Tipos de eventos climáticos.
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 publica 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:
- Tipo de evento meteorológico asociado con la alerta
- Es 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 sobre el evento climático
- Niveles de gravedad, certeza y urgencia
- Una descripción de las instrucciones de recomendación de acción 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 vivo para que te familiarices 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 HTTP GET a la siguiente URL:
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 la 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 | Description | Obligatorio u opcional |
|---|---|---|---|
alertId |
String | Es el ID de la alerta. También puedes encontrarlo 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 compatibles, 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 | Nivel de gravedad de la alerta:
|
Opcional |
certainty |
Enum | Nivel de certeza de la alerta:
|
Opcional |
urgency |
Enum | Nivel de urgencia de la alerta:
|
Opcional |
instruction |
String | Es la descripción de las instrucciones de acción adaptables para el público objetivo. | Opcional |
safetyRecommendations |
String | Recomendaciones de seguridad basadas en códigos de autoridades públicas. Incluye directivas de nivel superior y texto secundario con información adicional. | Opcional |
timezoneOffset |
String | Es el desplazamiento de zona horaria del evento, en formato +/-HH:MM. | Obligatorio |
startTime |
Fecha y hora | Fecha y hora de época efectivas (hora UTC) de la información del mensaje de alerta. | Opcional |
expirationTime |
Fecha y hora | Fecha y hora de época (hora UTC) en la que se espera que finalice una alerta. Puede ser nulo para eventos de duración indefinida, en cuyo caso el título indicará que el evento está "en vigencia". | Opcional |
dataSource |
Enum | Detalles de la autoridad, incluidos el publicador, el nombre y la URL | Obligatorio |
regionCode |
Enum | Es el código de la región de la ubicación que se solicitó. | Opcional |
Fuentes de datos
El extremo de alertas meteorológicas devuelve datos publicados por 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 deben seguir los lineamientos de 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 climáticos
Se admiten los siguientes tipos de eventos climáticos:
| Tipos de eventos climáticos | |
|---|---|
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 solo proporciona traducciones 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 se proporciona y admite ellanguageCodesolicitado, la respuesta se devuelve en el idioma solicitado.languageCodeno compatible: En los casos en que ellanguageCodesolicitado no sea compatible y no se pueda encontrar una alternativa cercana, el extremo devolverá la respuesta en inglés de forma predeterminada.- No se proporcionó
languageCode: De forma predeterminada, el extremo devuelve la respuesta en inglés.
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 te familiarices con la API y sus opciones.
Selecciona el ícono de la 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 deseas 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.