# Cyclone Alerts

This page provides information about how to set up Public Alerts for cyclones.

## Special recommendations to support Tropical Storm Forecast geometry

In the Public Alerts Tropical Storm Forecast, tropical storms are visualized as
follows:

![A series of connected circles show the path of a tropical storm across a
map](https://developers.google.com/static/public-alerts/images/tropical-storm-forecast.png)

To enable this type of visualization, Google requires a Common Alerting Protocol
(CAP) feed that contains the alert information and contains a new feed that
specifies the storm's geometry.

### Details on the feed that contains the Tropical Storm Forecast geometry

In the feed, make sure to include the following information:

- A feed file that contains information about different tropical storms and
  contains the URLs for the data files that include the forecast geometry data
  files. The following sample, taken from an [NOAA
  feed](https://www.nhc.noaa.gov/gis-cp.xml), provides an example
  of an XML feed file's content:

      <item>
        <title>
          Advisory #024 Forecast [shp] - Tropical Storm Walaka (CP1/CP012018)
        </title>
        <description>
          Forecast Track, Cone of Uncertainty, Watches/Warnings. Shapefile last updated 05 Oct 2018 14:52:04 GMT.
        </description>
        <link>http://www.prh.noaa.gov/cphc/tc_graphics/2018/gis/cp012018_5day_024.zip
        </link>
      </item>

- In the `<link>` section shown in the previous sample, include a ZIP file
  that contains files that represent the forecast geometry of the mentioned
  tropical storm. The ZIP file needs to include the following files:

  1. A file that contains the storm center forecast points.
  2. A file that contains the center forecast track line.
  3. A file that contains the forecast cone polygon.

  Each of these files must have a different file name suffix to differentiate
  them while processing.

  > [!NOTE]
  > **Note:** One of the files needs to contain a field that identifies the unique ID for this storm. We recommend that you use the storm center forecast points file to include this ID. The publisher needs to use this same storm ID when they publish the tropical storm public alerts through the CAP feed. For more detailed information on how to use the storm ID, see [Additional
  > parameters in CAP feeds](https://developers.google.com/public-alerts/samples/cyclone-alerts#additional-parameters).

We recommend that the forecast contain the time when the forecast starts and
when it expires. For some sample data, see the [NHC forecast
archives](https://www.nhc.noaa.gov/gis/archive_forecast_results.php?year=2021&id=al01).

For example, the NHC forecast file
[`al012021_5day_001.zip`](https://www.nhc.noaa.gov/gis/forecast/archive/al012021_5day_001.zip)
contains the following files:

- `al012021-001_5day_lin.shp`
- `al012021-001_5day_pgn.shp`
- `al012021-001_5day_pts.shp`
- `al012021-001_ww_wwlin.shp`

The attribute table for `al012021-001_ww_wwlin.shp` contains a column named
**STORMNUM** , whose value is used as `StormID` in the feed.

![Spreadsheet where the STORMNUM column has a value of 1 in the first
row](https://developers.google.com/static/public-alerts/images/stormid.png)

The attribute table for `al012021-001_5day_pts.shp` uses the columns **LAT** and
**LON** to denote the latitude and longitude information, respectively.

![Spreadsheet with numerical values in the LAT and LON
columns](https://developers.google.com/static/public-alerts/images/lat-lon.png)

### Additional parameters in CAP feeds

When the publisher sends the alerts for Tropical Storm, Typhoon, or Cyclone
events types, they need to mention the *unique storm ID* . One approach is to use the
`<info>` and `<parameter>` elements from the CAP format section [3.2.2 "info"
Element and Sub-elements](https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.html#_Toc97699542):

    <parameter>
      <valueName>StormId</valueName>
      <value>UniqueStormID</value>
    </parameter>

In the [previous NHC example](https://developers.google.com/public-alerts/samples/cyclone-alerts#nhc-example), the storm ID that's stored in the
shape file is `1`. The CAP feed must include a parameter element to tell Public
Alerts which storm the Forecast Geometry feed is for:

    <parameter>
      <valueName>StormId</valueName>
      <value>1</value>
    </parameter>

> [!IMPORTANT]
> **Important:** When you send the `StormId` as part of the public alert, make sure it matches with one of the active storm IDs that's sent as part of your forecast feed.

## Important points on data quality

- The `StormID` must be unique for the same active storm.
- Use the same `StormID` for the `<identifier>` field when you want to publish this storm into your CAP alerts later. You can raise multiple alerts with different details for various regions for the same storm, as long as the same `StormID` is used as `<identifier>` in your CAP alerts.
- For more info on a sample feed, see the [NHC forecast
  archives](https://www.nhc.noaa.gov/gis/archive_forecast_results.php?year=2021&id=al01).

## Checklist to submit your feed to Google

When you share the Tropical Storm Forecast feed with Google, be sure to include
the following:

- Feed URL
- Explanation of the structure of the ZIP file that contains your forecast geometry:
  - Which file specifies the storm center forecast points
  - Which file specifies the center forecast track line
  - Which file specifies the forecast cone polygon
  - Which column names denote the Storm ID, latitude, and longitude