Local Storm Reports
Overview
- Domain Portfolio: Alerts
- Domain: Alerts
- Usage Classification: Standard
- Geography: U.S. only
- Attribution Required: No
- Attribution Requirements: Suggested to display ‘bulletin_source’ as provided.
Short text reports of observed severe weather such as wind or hail damage, snow depth that is parsed from NWS Local Storm Report (LSR) and Public Information Statement (PNS) bulletins. The reports are ranked and prioritized by TWC upon receipt from the NWS.
HTTP Headers and Data Lifetime - Caching and Expiration
For details on appropriate header values as well as caching and expiration definitions, please see The Weather Company Data | API Common Usage Guide.
URL Construction
| Atomic API URL Examples: | |
|---|---|
| https://api.weather.com/v2/stormreports?format=json&apiKey=yourApiKey | v2stormReports |
|
Request All Storm Reports: Required Parameters: format, next Within the metadata section of the response there is a field named ‘next_batch’; if next_batch equals null the user has received all the data and is done. If next_batch is not null the user will make an additional call - the ‘next’ parameter will be set equal to the value found in ‘next_batch’. Keep calling the API until next_batch equals null. https://api.weather.com/v2/stormreports?format=<json or xml>&next=<next_batch>&apiKey=yourApiKey |
Aggregate Product Name |
| https://api.weather.com/v2/stormreports?format=json&next=1461720061&apiKey=yourApiKey | v2stormReports |
|
Request Storm Reports By County: Required Parameters: geoId, format https://api.weather.com/v2/stormreports?geoId=GAC121&format=<json or xml>&apiKey=yourApiKey |
Aggregate Product Name |
| https://api.weather.com/v2/stormreports?geoId=GAC121&format=json&apiKey=yourApiKey | v2stormReports |
|
Request All Storm Reports: Required Parameters: format https://api.weather.com/v2/stormreports?format=<json or xml>&apiKey=yourApiKey |
Aggregate Product Name |
Data Elements & Definitions
| Field Name | Description | Type | Range | Sample | Nulls Allowed | Usage |
|---|---|---|---|---|---|---|
| key | Unique identifier for a record | string | N/A | 0aca7cb03f192d5efc100fdd7ca9e6b1 | N | display as provided |
| geo_id | County ID or Zone ID | string | Any valid county id or zone id | GAC028 | Y | display as provided |
| geo_type | Geography type | string | C = county, Z = zone | C | N | display as provided |
| state_code | Any Valid State Abbreviation | string | Any valid state code | GA | N | display as provided |
| geo_name | County or Zone Name | string | Any valid county or zone name | Paulding | Y | display as provided |
| location | Place name for the storm report | string | Unlimited | Dallas | N | display as provided |
| region | Region as reported by the NWSev | string | MW, NE, SE, WE, AK, CARIB, HI, PAC, WSTPAC | SE | N | display as provided |
| datetime_local | Date and time of the sensor report | iso | N/A | 2015-09-29T00:00:00 | N | display as provided |
| timezone | Time zone abbreviation for datetime_local | string | Any valid time zone abbreviation | EDT | N | display as provided |
| iana_code | IANA time code | string | America/New_York | N | display as provided | |
| datetime_gmt | Day time string in unix seconds UTC | integer | Unlimited | 1252902300 | N | display as provided |
| latitude | Latitude | decimal | Unlimited | 33.79 | N | display as provided |
| longitude | Longitude | decimal | Unlimited | -84.37 | N | display as provided |
| nws_office | Code for office that generated the report | string | Any valid NWS office code | KATL | N | display as provided |
| magnitude | Magnitude of the event - can be decimal, integer or null | string | Unlimited | 10.2 | Y | display as provided |
| magnitude_desg | Method used to determine magnitude | string |
U = unknown, M = measured, E = estimated, P = up to, null |
M | Y | display as provided |
| magnitude_units | Unit of measure for magnitude | string | inches = inches, MPH = mph, null | INCHES | Y | display as provided |
| event_class |
Class for the event. Class types include: RAINFALL, WINTER, SEVERE, FLOODING, NON THUNDERSTORM WINDS, DROUGHT, DENSE FOG, TROPICAL, OTHER (e.g. unrecognized or misspelled class type). |
string | See Appendix: Event Types | SEVERE | N | display as provided |
| event_class_id | ID of the event class. Unique code for each Event Class. Included to provide flexibility in filtering logistics. | string | See Appendix: Event Types | SVR | N | display as provided |
| event_type | Type for the event. Displayable name for a kind of event. | string | See Appendix: Event Types | HAIL | N | display as provided |
| event_type_id | ID for the event type. Unique code for each Event Type. Included to provide flexibility filtering logistics. | string | See Appendix: Event Types | HAI | N | display as provided |
| bulletin_type | Type of bulletin data was extracted from | string |
LSR = local storm report, PNS = public service notice |
LSR | N | display as provided |
| bulletin_source | Source of the bulletin | string | NWS | NWS | N | display as provided |
| comments | Storm report comments | string | Unlimited | NUMEROUS ROADS IN EASTERN ROCKDALE COUNTY CLOSED DUE TO HIGH WATER. | Y | display as provided |
| severity | Relative severity of the event | integer | 1 = lowest, 10 = highest | 10 | N | display as provided |
| sorted_by_time | Data sorted by time, severity, amt_group_id (excluding 99), dma_rank, and population in ascending order | string | 98543822499920193999009899265330 | N | display as provided | |
| sorted_by_severity | Data sorted by severity, amt_group_id (excluding 99), dma_rank, time, and population in ascending order | string | 92019399900989854382249999265330 | N | display as provided | |
| dma | DMA code for the location | string | 0 to 999 or alpha | 8 | Y | display as provided |
| dma_rank | Rank of the dma | integer | 0 to 999 | 20 | Y | display as provided |
| population | Population for the county | integer | 0 to 99999999 | 155000 | Y | display as provided |
| source | Source of the report | string | Unlimited | SPOTTER | Y | display as provided |
| process_time_gmt | Unix time processed by the Sun | epoch | N/A | 1443554828 | N | display as provided |
| expire_time_gmt | Expiration time | epoch | N/A | 1380170106 | N | display as provided |
| class | Sun class identifier | string | In lowercase | stormreports | N | display as provided |
JSON Sample
{
metadata: {
language: "en-US",
transaction_id: "1461163881870:1585859798",
version: "2",
geoId: null,
expire_time_gmt: 1461185481,
status_code: 200
},
stormreports: [
{
key: "5997edcc8f3a8b4f43e727245a50110f",
geo_id: "COC029",
geo_type: "C",
state_code: "CO",
geo_name: "DELTA COUNTY",
location: "PARK RSVR",
region: "WE",
datetime_local: "2016-03-15T09:00:00",
timezone: "MDT",
iana_code: "America/Denver",
datetime_gmt: 1458054000,
latitude: 39.04667,
longitude: -107.875,
nws_office: "KGJT",
magnitude: "3.0",
magnitude_desg: "M",
magnitude_units: "INCHES",
event_class: "WINTER",
event_class_id: "WIN",
event_type: "24 HOUR SNOWFALL",
event_type_id: "S24",
bulletin_type: "PNS",
bulletin_source: "NWS",
comments: null,
severity: 3,
sorted_by_time: "98541967599960599699001699969665",
sorted_by_severity: "96059969900169854196759999969665",
dma: "751",
dma_rank: 16,
population: 30334,
source: "SPOTTER",
process_time_gmt: 1461092370,
expire_time_gmt: 1461437970
},
] Appendix: Event Types
| EVENT_CLASS | EVENT_TYPE | EVENT_TYPE_ID | EVENT_CLASS_ID |
|---|---|---|---|
| DROUGHT | BLOWING DUST | BDU | DRG |
| DROUGHT | DROUGHT | DRO | DRG |
| DROUGHT | DUST STORM | DUS | DRG |
| DROUGHT | WILDFIRE | WLD | DRG |
| FLOODING | DEBRIS FLOW | DFL | FLD |
| FLOODING | FLASH FLOOD | FLA | FLD |
| FLOODING | FLOOD | FLO | FLD |
| FLOODING | ICE JAM FLOODING | IJF | FLD |
| FLOODING | LANDSLIDE | LAN | FLD |
| NON-THUNDERSTORM WINDS | HIGH SUST WINDS | NWG | NTW |
| NON-THUNDERSTORM WINDS | HIGH SUSTAINED WINDS | HSW | NTW |
| NON-THUNDERSTORM WINDS | NON-THUNDERSTORM WIND DAMAGE | NWD | NTW |
| NON-THUNDERSTORM WINDS | NON-THUNDERSTORM WIND GUST | NWG | NTW |
| NON-THUNDERSTORM WINDS | NON-TSTM WIND DAMAGE | NWD | NTW |
| OTHER | SEICHE | SEI | TRO |
| RAINFALL | 1 HOUR RAINFALL | R01 | RAI |
| RAINFALL | 12 HOUR RAINFALL | R12 | RAI |
| RAINFALL | 24 HOUR RAINFALL | R24 | RAI |
| RAINFALL | 48 HOUR RAINFALL | R48 | RAI |
| RAINFALL | 6 HOUR RAINFALL | R06 | RAI |
| RAINFALL | HEAVY RAIN | HVR | RAI |
| RAINFALL | STORM TOTAL RAINFALL | RTO | RAI |
| SEVERE | DOWNBURST | DWN | SVR |
| SEVERE | FUNNEL CLOUD | FUN | SVR |
| SEVERE | HAIL | HAI | SVR |
| SEVERE | LANDSPOUT | TOR | SVR |
| SEVERE | LIGHTNING | LGT | SVR |
| SEVERE | THUNDERSTORM WIND DAMAGE | TWD | SVR |
| SEVERE | THUNDERSTORM WIND GUST | TWG | SVR |
| SEVERE | TORNADO | TOR | SVR |
| SEVERE | WALL CLOUD | WAL | SVR |
| SEVERE | WATERSPOUT | WAT | SVR |
| TEMPERATURE | EXTREME COLD | EXC | TMP |
| TEMPERATURE | EXTREME HEAT | EXH | TMP |
| TEMPERATURE | WIND CHILL | WCH | TMP |
| TROPICAL | COASTAL FLOOD | CFL | TRO |
| TROPICAL | HIGH SURF | HSF | TRO |
| TROPICAL | LAKESHORE FLOOD | LFL | TRO |
| TROPICAL | MISC MRN/SRF HZ | MIS | TRO |
| TROPICAL | RIP CURRENTS | RCT | TRO |
| TROPICAL | SNEAKER WAVE | SWA | TRO |
| TROPICAL | STORM SURGE | SUR | TRO |
| TROPICAL | TROPICAL CYCLONE | HUR | TRO |
| TROPICAL | TSUNAMI | TSU | TRO |
| VOLCANO | VOG | VOG | VOL |
| VOLCANO | VOLCANIC ASHFALL | VAF | VOL |
| WINTER | 1 HOUR SNOWFALL | S01 | WIN |
| WINTER | 12 HOUR SNOWFALL | S12 | WIN |
| WINTER | 24 HOUR SNOWFALL | S24 | WIN |
| WINTER | 48 HOUR SNOWFALL | S48 | WIN |
| WINTER | 6 HOUR SNOWFALL | S06 | WIN |
| WINTER | AVALANCHE | AVA | WIN |
| WINTER | BLIZZARD | BLZ | WIN |
| WINTER | FREEZING RAIN | FZR | WIN |
| WINTER | HEAVY SNOW | HVS | WIN |
| WINTER | ICE JAM | IJA | WIN |
| WINTER | SLEET | SLE | WIN |
| WINTER | SNOW | SNO | WIN |
| WINTER | SNOW ON GROUND | SNG | WIN |
| WINTER | SNOW SQUALL | SSQ | WIN |
| WINTER | SNOW/ICE DAMAGE | SID | WIN |
| WINTER | STORM TOTAL SNOWFALL | STO | WIN |
| DENSE FOG | DENSE FOG | DFG | DFG |