The
[`publicAlerts`](https://developers.google.com/maps/documentation/weather/reference/rest/v1/publicAlerts/lookup.md.txt)
endpoint provides details for specific weather event alerts issued by
authoritative national and international agencies. These alerts deliver crucial,
potentially life-saving information.

The endpoint returns weather alerts occurring in real time for a given latitude
and longitude. Supported weather events include the following:

- **Precipitation:** Rain, snow, hail, droughts, and more
- **Extreme temperatures:** Cold, heat, freeze, frost, wind chill, and humidity
- **Wind and storm events:** Blizzards, hurricanes, tornados, tropical storms, thunderstorms, and more
- **Visibility impairments:** Fog, dust storms, and blowing snow
- **Water-related hazards:** Floods, tsunamis, storm surges, coastal hazards, and more
- **Geophysical and geological events:** Earthquakes, landslides, and volcanic activity
- **Fire incidents:** Wildfire, fire weather, and more

For a complete list of supported weather events, see [Weather event
types](https://developers.google.com/maps/documentation/weather/weather-alerts#weather_event_types).

> [!CAUTION]
> **Caution:** Weather alerts can be complex and may not always adhere to consistent standards, formats, or rules across different sources. While Google strives to ensure data consistency and timely availability, the content, quality and update frequency are subject to the authoritative source and may change whenever an update is issued from that source; Google does not guarantee that weather alerts will be updated or that any issues related to data at the provider will be resolved within a specific timeframe.

Alerts may or may not contain localized descriptions, depending on what is
available from the [data source](https://developers.google.com/maps/documentation/weather/weather-alerts.md.txt#data_sources). Due to data source
restrictions, the information is served as-is (raw content). For more
information about weather alert sources, see [Data sources](https://developers.google.com/maps/documentation/weather/weather-alerts.md.txt#data_sources).

The API returns the following information for a given weather alert:

- The type of weather event associated with the alert
- A list of affected areas along with coordinates defining the geographical boundaries of those areas
- A one-sentence summary of the weather event
- Severity, certainty, and urgency levels
- A description of action-recommend instructions for the target audience
- Safety recommendations
- Start and end times for the alert
- The name and website of the publishing authority

The APIs Explorer lets you make live requests so that you can get familiar with
the API and the API options:
[Try it!](https://developers.google.com/maps/documentation/weather/weather-alerts.md.txt#try_it)

## About weather alert requests

To request weather alert information, send an HTTP GET request to:

```html
https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE
```

Include the latitude and longitude coordinates of the location in your request
URL parameters.

> [!NOTE]
> **Note:** Including a language code parameter is optional and will translate the alert title only. Because weather alert data is served as-is (raw content) from partner agencies, instructions and safety recommendations are returned in the original language published by the agency. For more information, see [Response
> translation behavior](https://developers.google.com/maps/documentation/weather/weather-alerts#response_translation_behavior).

## About weather alert responses

The Weather API returns the following fields in the response body:

| Field | Type | Description | Required or optional |
|---|---|---|---|
| `alertId` | String | The alert ID. This can also be found on the data provider website. | Required |
| `alertTitle` | String | The title of the alert, which describes the weather event. **Note:** This is the only string that is translated when a language code parameter is included in the request. | Required |
| `eventType` | Enum | The type of weather event associated with the alert. For a full list of supported weather events, see [Weather event types](https://developers.google.com/maps/documentation/weather/weather-alerts.md.txt#weather_event_types). | Required |
| `areaName` | String | The name of the geographic area affected by the alert, which includes the requested location. | Required |
| `polygon` | String | Coordinates defining a closed dimensional area of the alert. | Optional |
| `description` | String | A short phrase that summarizes the event description in the specified language (for example, "Tornado warning"). | Optional |
| `severity` | Enum | The level of severity for the alert: - **Extreme:** Extraordinary threat to life or property - **Severe:** Significant threat to life or property - **Moderate:** Possible threat to life or property - **Minor:** Minimal to no known threat to life or property - **Unknown:** Severity unknown | Optional |
| `certainty` | Enum | The level of certainty for the alert: - **Observed:** Determined to have occurred or to be ongoing - **Very Likely:** Very likely to have occurred or to be ongoing - **Likely:** Likely (p \> \~50%) to have occurred or to be ongoing - **Possible:** Possible but not likely to have occurred or to be ongoing (p \<= \~50%) - **Unlikely:** Not expected to occur (p \~ 0) - **Unknown:** Certainty unknown | Optional |
| `urgency` | Enum | The level of urgency for the alert: - **Immediate:** Responsive action SHOULD be taken immediately - **Expected:** Responsive action SHOULD be taken soon (within the next hour) - **Future:** Responsive action SHOULD be taken in the near future - **Past:** Responsive action is no longer required - **Unknown:** Urgency unknown | Optional |
| `instruction` | String | Description of responsive action instructions for the target audience. | Optional |
| `safetyRecommendations` | String | Safety recommendations based on public authority codes. Includes top-level directives and subtext with additional information. | Optional |
| `timezoneOffset` | String | The timezone offset of the event, in +/-HH:MM format. | Required |
| `startTime` | DateTime | The effective Epoch date and time (UTC time) of the information in the alert message. | Optional |
| `expirationTime` | DateTime | The Epoch date and time (UTC time) that an alert is expected to end. It may be null for indefinitely long events, in which case the headline will indicate that the event is "in effect". | Optional |
| `dataSource` | Enum | Authority details including publisher, name, and URL. | Required |
| `regionCode` | Enum | Region code of the location that has been requested. | Optional |

> [!NOTE]
> **Note:** If there is no active alert in the requested location or a required field from the original provider is missing, the response body only includes the `regionCode` field. If an optional field from the original provider is missing, the optional field is omitted from the response body.

### Data sources

The weather alerts endpoint returns data published by the providers listed in
the following table. Based on the latitude and longitude coordinates provided in
the request, the response body surfaces data from the appropriate local
authority.

Providers included in the feed follow [Google's Public Alerts
guidelines](https://developers.google.com/public-alerts/guides/get-started).
Google may update the list of providers at any time.

| Country | Agency | Supported languages |
|---|---|---|
| Australia | [ACT Emergency Services Agency (ACT ESA)](https://esa.act.gov.au/disclaimer) | `en-US` |
| Australia | [New South Wales Rural Fire Service (NSW RFS)](http://www.rfs.nsw.gov.au/news-and-media/stay-up-to-date/feeds) | `en-AU` |
| Australia | [South Australian Country Fire Service (SA CFS)](https://www.cfs.sa.gov.au/home/disclaimer/) | `en-AU` |
| Australia | [Tasmania Fire Service (TFS)](http://www.fire.tas.gov.au/Show?pageId=xmlFeedsHome) | `en-US` |
| Australia | [Queensland Fire and Emergency Services (QFES)](https://www.fire.qld.gov.au/Current-Incidents) | `en-AU` |
| Austria | [GeoSphere Austria](https://www.zamg.ac.at/) through [MeteoAlarm](https://www.meteoalarm.org/) | `de-DE`, `en-GB` |
| Belgium | [Royal Meteorological Institute of Belgium](https://www.meteo.be/en/brussels) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `fr-BE`, `nl-BE` |
| Bosnia and Herzegovina | [Federal Hydro-meteorological Institute (FHMZ)](http://www.fhmzbih.gov.ba/) through [MeteoAlarm](https://www.meteoalarm.org/) | `bs` |
| Bulgaria | [National Institute of Meteorology \& Hydrology](https://meteo.bg/en) through [MeteoAlarm](https://www.meteoalarm.org/) | `bg`, `en-GB` |
| Brazil | [Centro Nacional de Gerenciamento de Riscos e Desastres (CENAD)](https://www.gov.br/mdr/pt-br/assuntos/protecao-e-defesa-civil/informacoes-uteis/centro-nacional-de-gerenciamento-de-riscos-e-desastres-cenad/videocenad) | `pt-BR` |
| Brazil | [Instituto Nacional de Meteorologia (INMET)](http://www.inmet.gov.br/portal/) | `pt-BR` |
| Colombia | [Unidad Nacional para la Gestión del Riesgo de Desastres (UNGRD)](http://gestiondelriesgo.gov.co/) | `es` |
| Côte d'Ivoire | [Société d'Exploitation et de Développement Aéroportuaire, Aéronautique et Météorologique](https://www.sodexam.com/) | `fr` |
| Croatia | [Croatian Meteorological and Hydrological Service](https://meteo.hr/index_en.php) through [MeteoAlarm](https://www.meteoalarm.org/) | `hr-HR`, `en-GB` |
| Cyprus | [Department of Meteorology](https://www.moa.gov.cy/moa/dm/dm.nsf/home_en/home_en?OpenForm) through [MeteoAlarm](https://www.meteoalarm.org/) | `el-GR`, `en-GB` |
| Czechia | [Czech Hydrometeorological Institute](https://www.chmi.cz/?l=en) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `cs` |
| Denmark | [Danish Meteorological Institute](https://www.dmi.dk/) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `da-DK` |
| Ecuador | [Instituto Nacional de Meteorología e Hidrología](https://www.inamhi.gob.ec/) | `es` |
| Estonia | [Ministry of Climate](https://kliimaministeerium.ee/en) through [MeteoAlarm](https://www.meteoalarm.org/) | `et-EE` |
| Finland | [Finnish Meteorological Institute](https://en.ilmatieteenlaitos.fi/warnings) through [MeteoAlarm](https://www.meteoalarm.org/) | `fi-FI`, `sv-SE`, `en-GB` |
| France | [Météo-France](http://www.meteofrance.com/accueil) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `fr-FR` |
| Germany | [DWD - The German Weather Service](https://www.dwd.de/DE/Home/home_node.html) | `de-DE` |
| Ghana | [Agence Nationale de la Météorologie](https://www.meteo.gov.gh/) | `fr` |
| Greece | [Hellenic National Meteorological Service](http://www.hnms.gr/emy/en/) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `el-GR` |
| Hungary | [HungaroMet Nonprofit Zrt](https://www.met.hu/en/idojaras/) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `hu-HU` |
| Iceland | [Icelandic Meteorological Office](https://en.vedur.is/) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `is-IS` |
| Ireland | [Met Eirann](https://www.met.ie/warnings-today.html) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB` |
| Italy | [Italian Meteorological Service](http://www.meteoam.it/) through [MeteoAlarm](https://www.meteoalarm.org/) | `it-IT`, `en-GB` |
| Jamaica | [Meteorological Service of Jamaica](https://metservice.gov.jm/) | `en-JM` |
| Japan | [Japan Meteorological Agency (JMA)](http://www.jma.go.jp/jma/indexe.html) | `ja` |
| Latvia | [Latvian Environment, Geology and Meteorology Centre](https://videscentrs.lvgmc.lv/?valoda=en-GB) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `lv` |
| Lithuania | [Lithuanian Hydrometeorological Service](http://www.meteo.lt/en/) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `lt-LT` |
| Luxembourg | [MeteoLux](https://www.meteolux.lu/?lang=fr) through [MeteoAlarm](https://www.meteoalarm.org/) | `fr-FR`, `de-DE`, `en-GB` |
| Madagascar | [Météo Madagascar](https://www.meteomadagascar.mg/) | `en`, `fr` |
| Mexico | [Centro de Instrumentación y Registro Sísmico A.C. (CIRES)](http://www.cires.org.mx/) | `es-MX` |
| Netherlands | [Royal Netherlands Meteorological Institute](https://www.knmi.nl/over-het-knmi/about) through [MeteoAlarm](https://www.meteoalarm.org/) | `nl-NL`, `en-GB` |
| North Macedonia | [National Hydrometeorological Service](http://meteo.gov.mk/) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB` |
| Norway | [Norwegian Meteorological Institute](https://www.met.no/en) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `no` |
| New Zealand | [GNS Science (GeoNet)](http://www.geonet.org.nz/) | `en-NZ` |
| New Zealand | [MetService](https://www.metservice.com/) | `en-US` |
| Philippines | [Philippine Atmospheric, Geophysical \& Astronomical Services Administration (PAGASA)](http://bagong.pagasa.dost.gov.ph/) | `en-US` |
| Poland | [Institute of Meteorology and Water Management](http://www.imgw.pl/en/) through [MeteoAlarm](https://www.meteoalarm.org/) | `pl-PL`, `en-GB` |
| Portugal | [Portuguese Institute for Sea and Atmosphere](https://www.ipma.pt/pt/index.html) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `pt-PT` |
| Romania | [National Meteorological Administration](https://www.meteoromania.ro/) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `ro-RO` |
| Serbia | [Republic Hydrometeorological Institute of Serbia](https://www.hidmet.gov.rs/index_eng.php) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `sr` |
| Singapore | [Meteorological Service Singapore](https://www.weather.gov.sg/home/) | `en-US` |
| Slovakia | [Slovak Hydrometeorological Institute](http://www.shmu.sk/en/) through [MeteoAlarm](https://www.meteoalarm.org/) | `sk`, `en-GB` |
| Slovenia | [Hydrometeorological Institute of Slovenia](http://www.meteo.si/met/en/) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `sl` |
| Solomon Islands | [Solomon Islands Meteorological Services](https://met.gov.sb/) | `en` |
| South Korea | [Korea Meteorological Administration](https://www.kma.go.kr/neng/index.do) | `en-US`, `ko-KR` |
| Spain | [State Meteorological Agency](http://www.aemet.es/en/portada) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `es-ES` |
| Sweden | [Swedish Meteorological and Hydrological Institute](https://www.smhi.se/en/weather) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB`, `sv-SE` |
| Switzerland | [Federal Office of Meteorology and Climatology MeteoSwiss](https://www.meteoswiss.admin.ch/) through [MeteoAlarm](https://www.meteoalarm.org/) | `en`, `de`, `fr`, `it` |
| Taiwan | [National Science and Technology Center for Disaster Reduction (NCDR)](http://www.ncdr.nat.gov.tw/) | `zh-TW` |
| Thailand | [Thai Meteorological Department](https://www.tmd.go.th/en/) | `th-TH` |
| United Kingdom | [Met Office](https://www.metoffice.gov.uk/) through [MeteoAlarm](https://www.meteoalarm.org/) | `en-GB` |
| United Kingdom | [UK Environment Agency](https://www.gov.uk/government/organisations/environment-agency) |   |
| United States | [National Tsunami Warning Center](http://wcatwc.arh.noaa.gov/) | `en-US` |
| United States | [US National Weather Service](http://weather.gov/) | `en-US` |
| Vietnam | [National Center for Hydrometeorological Forecasting](https://nchmf.gov.vn/KttvsiteE/en-US/2/index.html) | `en-VN`, `vi-VN` |

### Attribution

On all displays where the data is presented, the customer application must
include an attribution to the original source using the `dataSource` field:

```json
"dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }
```

The attribution must include the full name of the data source (as provided in
the `name` field) and hyperlink to the data source using the URL provided in the
`authorityUri` field (for example, "[National Weather
Service](https://www.weather.gov/)").

### Weather event types

The following weather event types are supported:

| Weather event types ||
|---|---|
| `ACID_RAIN` `AVALANCHE` `BLIZZARD` `BLOWING_SNOW` `COASTAL_FLOOD` `COASTAL_HAZARD` `COLD` `CYCLONE` `DROUGHT` `EXTRATROPICAL_CYCLONE` `FIRE_WEATHER` `FLASH_FLOOD` `FLOOD` `FOG` `FREEZING` `FREEZING_AIR_TEMPERATURE` `FREEZING_DRIZZLE` `FREEZING_RAIN` `FROST` `GALE` `GLAZE` `HAIL` `HAZARDOUS_SEAS` `HEAT` `HUMIDITY` `HURRICANE` `ICE_STORM` `LAKE_EFFECT_SNOW` `MONSOON` `MUDDY_FLOOD` `OUTFLOW` `RAIN` | `RIVER_FLOODING` `SEVERE_THUNDERSTORM_WARNING` `SNOW` `SNOWSQUALL` `STORM` `STORM_SURGE` `THUNDER` `THUNDERSTORM` `TORNADO` `TORNADO_WARNING` `TROPICAL_CYCLONE` `TROPICAL_CYCLONE_WARNINGS_AND_WATCHES` `TROPICAL_DISTURBANCE` `TROPICAL_STORM` `TYPHOON` `WIND` `WIND_CHILL` `WIND_WAVE` `WINTER_STORM` `WILDFIRE` `BUSHFIRE` `FIRE` `LANDSLIDE` `EARTHQUAKE` `DUST_STORM` `AFTERSHOCK` `TSUNAMI` `VOLCANIC_ASH` `VOLCANIC_ERUPTION` `RADIATION` |

### Response translation behavior

Google provides translations for the `alertTitle` field only. Other fields such
as `eventType`, `areaName`, `instruction`, and `safetyRecommendations` may also
be translated, depending on the original data source's language support;
however, Google can't provide independent translations for these fields.

Based on the `languageCode` parameter included in the request, the following
behaviors are expected for the `alertTitle` field:

- **Supported `languageCode`:** If the requested `languageCode` is both provided and supported, the response is returned in the requested language.
- **Unsupported `languageCode`:** In cases where the requested `languageCode` is not supported and a close alternative cannot be found, the endpoint returns the response in English by default.
- **No `languageCode` provided:** The endpoint returns the response in English by default.

## Weather alert request example

The following example requests weather alert information for a town in North
Carolina:

```
curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635&location.longitude=-78.3168047&languageCode=en"
```

The response body is as follows:

```json
{
  "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"
}
```

## Try it!

The APIs Explorer lets you make sample requests so
that you can get familiar with the API and the API options.

1. Select the API icon api
   on the right side of the page.

2. Optionally edit the request parameters.

3. Select the **Execute** button. In the dialog, choose the account
   that you want to use to make the request.

4. In the APIs Explorer panel, select the fullscreen icon
   fullscreen to expand the APIs Explorer window.