Weather Central DataCloud API

Alerts Format

Alerts
This format will provide a simplified XML response that provides the summary of the current National Weather Service Warning information for the latitude and longitude you are requesting.

Usage:

format=alerts
datatype=alerts
var=summary

Example Alerts format data request:

http://datacloud.wxc.com/?datatype=alerts&vs=0.9&passkey=123456789&type=point&var=summary&lat=37.2&lon=-94.89&format=alerts&time=now

Note: Alerts requests must use only one latitude and longitude, and time=now.

Example Alerts format data response



Example Currents format data response:

ALERTS FORMAT RETURN VALUES

alerts
This is an element that contains information on all of the available National Weather Service alerting information for the point you have requested. 

alert
This is an element that contains the unique data associated with a particular alert event.
key
This is an attribute of the alert element that defines the latitude and longitude requested in the query.

Zones: http://www.nws.noaa.gov/mirs/public/prods/maps/pfzones_list.htm
Counties: http://www.nws.noaa.gov/mirs/public/prods/maps/cnty_fips_list.htm

Example:

fips=PAZ066

zone
This is an attribute of the alert element that gives a human text description of the zone where the alert has been issued.

Example:

zone=Lancaster

state
This is an attribute of the alert element that gives the state postal code where the alert has been issued

Example:

state=PA

name
This is an attribute of the alert element that gives a human text description of the type of alert(s) that has been issued.

Example:

name=Flood Watch

type
This is an attribute of the alert element that defines the severity of the alert.

  1. Warning – This is issued for weather conditions that are occurring or about to occur.
  2. Watch – This is issued for events that are possible within the next 0-2 days but not occurring right now
  3. Advisory – This is issued when an event is occurring now but at a lower severity level than a warning
  4. Statement – These are mainly used for informational statement for lower level events.

Example:

type=02

level
This is an attribute of the alert element that defines the category or weather type of the event.

  1. None
  2. Air Quality
  3. Avalanche
  4. Cold
  5. Fire
  6. Flood
  7. Heat
  8. Ice
  9. Marine
  10. Rain
  11. Severe
  12. Snow
  13. Visibility
  14. Volcano
  15. Wind
  16. Civil

Example:

level=05

textid
This is an attribute of the alert element that uniquely identifies the text message of the warning.  It is mainly used to match the text element discussed below with the alert element.

Example:

textid=18044801


issue-utc
This is an attribute of the alert element that defines the issue time of the bulletin in GMT.  The format is YYYY-MM-DDTHH:MMZ
Example:

issue-utc=2011-05-17T15:13Z


start-utc
This is an attribute of the alert element that defines the start time of the event in GMT.  For example the Weather Service may issue a Winter Storm Warning at 4PM that doesn’t go into effect until 10PM.  The format is YYYY-MM-DDTHH:MMZ

Example:

start-utc=2011-05-17T22:00Z


expire-utc
This is an attribute of the alert element that defines the ending time of the bulletin in GMT.  The format is YYYY-MM-DDTHH:MMZ

Example:

expire-utc=2011-05-19T04:00Z

poly
For Tornado Warnings, Flash Flood Warnings, and Severe Thunderstorm Warnings the National Weather Service will further define the region that is impacted by a polygon.  If this is present it should override the zone attribute.  The format is a list of latitude and longitude points

Example:

poly=37.68,-95.09,37.67,-94.62,36.98,-94.62,36.99,-94.99,37,-95.08

texts
This is an element within the alerts element that contains the actual National Weather Service Bulletin for any alerts.
text
This is an element within the texts element that contains a specific bulletin.
id
This is an attribute of the text element that has the unique bulletin id.  It is mainly used to match the text element to the alert element.

Example:

id=18044801

!CDATA[ ]
This section contains the actual bulletin text.