Storm Reports¶

Overview¶

Request Types¶

This portion of the API concerns storm reports, which are point data affecting a geographic region (defined by an extent) or proximity around a location (defined by a point and radius). For convenience, the most frequent report types are grouped into categories and may be requested as such. A request listing the categories is also available.

Request Parameters¶

Storm report requests allow for additional parameters beyond those specified by the Request Format.

OPTIONAL: A boolean indicator (comments) that storm report comments should be included in the response. Comments provide additional information about the storm report if reported to the National Weather Service at the time the report was made, typically involving details about the location and/or duration of the event. Comments are omitted unless this parameter is present and set to either true or 1.
OPTIONAL (proximity requests only): A radius in statute miles or kilometers (radius) around the given location defining a search area for storm reports included in the response. If unspecified, radius defaults to 1. The maximum allowed radius is 20 statute miles.
OPTIONAL (proximity requests only): A unit designator (units) for interpretation of the radius as well as the distance included in the response. Accepted values are miles or km. If unspecified, units defaults to statute miles.

Response Content¶

The following fields are included in each representation of a storm report:

id (string)
report date (RFC 3339 string)
event date (RFC 3339 string)
type (string): “avalanche”, “blizzard”, “coastal flood”, “debris flow”, “dense fog”, “downburst”, “drought”, “dust storm”, “excessive heat”, “extr wind chill”, “extreme cold”, “flash flood”, “flood”, “freeze”, “freezing rain”, “funnel cloud”, “hail”, “heavy rain”, “heavy snow”, “high astr tides”, “high sust winds”, “hurricane”, “ice storm”, “lakeshore flood”, “lightning”, “marine hail”, “marine tstm wind”, “non-tstm wnd dmg”, “non-tstm wnd gst”, “rain”, “rip currents”, “seiche”, “sleet”, “sneaker wave”, “snow”, “storm surge”, “tornado”, “tropical storm”, “tstm wnd dmg”, “tstm wnd gst”, “tsunami”, “volcanic ashfall” “water spout”, “wildfire”, “wind”, etc.
location
- description (string)
- county (string)
- state (string)
- lat/lon (ISO 6709 string)
magnitude
- unit (string): “F” or “EF” (tornado scale), “inches”, “mph”, or “ft”
- value (decimal)
method (string): “measured”, “estimated”, or “unknown”
comments (string): additional information about the report, provided only if the comments keyword is present and set to true or 1 in the parameters
source (string): “911 center”, “airplane pilot”, “amateur radio”, “asos”, “awos”, “broadcast media”, “coast guard”, “cocorahs”, “co-op observer”, “county official”, “dept of highways”, “emergency mngr”, “fire dept/rescue”, “insurance co”, “law enforcement”, “mesonet”, “newspaper”, “nws employee”, “nws storm survey”, “official nws obs”, “ok highway ptrl”, “other federal”, “park/forest srvc”, “post office”, “public”, “ship”, “skywarn spotter”, “state police”, “storm chaser”, “trained spotter”, “unknown”, “utility company”, etc.
site (string): forecast office issuing the report

Reports By Proximity¶

This request returns the storm reports impacting the proximity around a specific location within a date range (the last 24 hours by default). Results are returned as GeoJSON, KML, or XML. No transitions are available from the response. An empty list (feature collection) is returned if there are no reports.

URI Examples¶

forensic.api.wdtinc.com/v2/stormreports/+DD.ddd-DDD.ddd?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/+DD.ddd-DDD.ddd.kml?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/+DD.ddd-DDD.ddd.xml?radius=&units=&begin=&end=&u=&t=

See prior sections for a description of the Request Format and Request Parameters.

GeoJSON Response¶

The GeoJSON representation of the resource is structured as follows. The comments property is omitted unless the keyword comments=true or comments=1 is provided in the request parameters.

{
    "apiVersion": "2.5.8",
    "stormReports": {
        "dateRange": {
            "begin": "YYYY-MM-DDThh:mm:ssZ",
            "end": "YYYY-MM-DDThh:mm:ssZ"
        },
        "features": [
            {
                "geometry": {
                    "coordinates": [
                        -84.930000000000007,
                        38.079999999999998
                    ],
                    "type": "Point"
                },
                "properties": {
                    "comments": "",
                    "eventDate": "YYYY-MM-DDThh:mm:ssZ",
                    "id": "",
                    "location": {
                        "county": "",
                        "description": "",
                        "latLon": "+DD.ddd-DDD.ddd",
                        "state": ""
                    },
                    "magnitude": {
                        "unit": "",
                        "value": DD.dd
                    },
                    "method": "",
                    "proximity": {
                        "bearing": {
                            "unit": "degrees from north",
                            "value": DD.dd
                        },
                        "distance": {
                            "unit": "",
                            "value": DD.dd
                        }
                    },
                    "reportDate": "YYYY-MM-DDThh:mm:ssZ",
                    "site": "",
                    "source": "",
                    "type": ""
                },
                "type": "Feature"
            },
            {
                "geometry": {
                    "coordinates": [
                        -84.930000000000007,
                        38.079999999999998
                    ],
                    "type": "Point"
                },
                "properties": {
                    "comments": "",
                    "eventDate": "YYYY-MM-DDThh:mm:ssZ",
                    "id": "",
                    "location": {
                        "county": "",
                        "description": "",
                        "latLon": "+DD.ddd-DDD.ddd",
                        "state": ""
                    },
                    "magnitude": {
                        "unit": "",
                        "value": DD.dd
                    },
                    "method": "",
                    "proximity": {
                        "bearing": {
                            "unit": "degrees from north",
                            "value": DD.dd
                        },
                        "distance": {
                            "unit": "",
                            "value": DD.dd
                        }
                    },
                    "reportDate": "YYYY-MM-DDThh:mm:ssZ",
                    "site": "",
                    "source": "",
                    "type": ""
                },
                "type": "Feature"
            },
            :
            :
        ],
        "location": "+DD.ddd-DDD.ddd",
        "radius": {
            "unit": "miles",
            "value": DD.dd
        },
        "selfLink": "/v2/stormreports/categories/hail/+DD.ddd-DDD.ddd?radius=&units=&begin=&end=&u=&t=",
        "type": "FeatureCollection"
    }
}

KML Response¶

The KML representation of the resource is structured as follows. The comments property is omitted unless the keyword comments=true or comments=1 is provided in the request parameters.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
    <Document>
        <name>Storm Reports</name>
        <ExtendedData>
            <Data name="selfLink">
                <value>/v2/stormreports/+DD.ddd-DDD.ddd?radius=&amp;units=&amp;begin=&amp;end=&amp;u=&amp;t=</value>
            </Data>
            <Data name="beginDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
            <Data name="endDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
            <Data name="location"><value>+DD.ddd-DDD.ddd</value></Data>
            <Data name="radius"><value>DD.ddd</value></Data>
            <Data name="radius-unit"><value>miles</value></Data>
        </ExtendedData>
        <Placemark>
            <name>id</name>
            <ExtendedData>
                <Data name="reportDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="eventDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="type"><value></value></Data>
                <Data name="location"><value></value></Data>
                <Data name="county"><value></value></Data>
                <Data name="state"><value></value></Data>
                <Data name="latLon"><value></value></Data>
                <Data name="distance"><value></value></Data>
                <Data name="distance-unit"><value></value></Data>
                <Data name="bearing"><value></value></Data>
                <Data name="bearing-unit"><value>degrees from north</value></Data>
                <Data name="magnitude"><value></value></Data>
                <Data name="magnitude-unit"><value></value></Data>
                <Data name="method"><value></value></Data>
                <Data name="comments"><value></value></Data>
                <Data name="source"><value></value></Data>
                <Data name="site"><value></value></Data>
            </ExtendedData>
            <Point>
                <coordinates>-91.95,39.5024</coordinates>
            </Point>
        </Placemark>
        <Placemark>
            <name>id</name>
            <ExtendedData>
                <Data name="reportDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="eventDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="type"><value></value></Data>
                <Data name="location"><value></value></Data>
                <Data name="county"><value></value></Data>
                <Data name="state"><value></value></Data>
                <Data name="latLon"><value></value></Data>
                <Data name="distance"><value></value></Data>
                <Data name="distance-unit"><value></value></Data>
                <Data name="bearing"><value></value></Data>
                <Data name="bearing-unit"><value>degrees from north</value></Data>
                <Data name="magnitude"><value></value></Data>
                <Data name="magnitude-unit"><value></value></Data>
                <Data name="method"><value></value></Data>
                <Data name="comments"><value></value></Data>
                <Data name="source"><value></value></Data>
                <Data name="site"><value></value></Data>
            </ExtendedData>
            <Point>
                <coordinates>-91.95,39.5024</coordinates>
            </Point>
        </Placemark>
            :
            :
    </Document>
</kml>

XML Response¶

The XML representation of the resource is structured as follows (based on Google’s XML style guide). The comments property is omitted unless the keyword comments=true or comments=1 is provided in the request parameters.

<?xml version="1.0" encoding="UTF-8"?>
<stormReports xmlns="http://forensic.api.wdtinc.com/stormreports"
              xmlns:xlink="http://www.w3.org/1999/xlink"
              xlink:href="/v2/stormreports/+DD.ddd-DDD.ddd.xml?radius=&amp;units=&amp;begin=&amp;end=&amp;u=&amp;t=">
    <dateRange begin="YYYY-MM-DDThh:mm:ssZ" end="YYYY-MM-DDThh:mm:ssZ" />
    <location format="iso6709">+DD.ddd-DDD.ddd</location>
    <radius unit="miles">DD.ddd</radius>
    <report id="">
        <reportDate>YYYY-MM-DDThh:mm:ssZ</reportDate>
        <eventDate>YYYY-MM-DDThh:mm:ssZ</eventDate>
        <type></type>
        <location>
            <description></description>
            <county></county>
            <state></state>
            <latLon format="iso6709">+DD.ddd-DDD.ddd</latLon>
        </location>
        <proximity>
            <distance unit="">DD.dd</distance>
            <bearing unit="degrees from north">DD.dd</bearing>
        </proximity>
        <magnitude unit="">DD.dd</magnitude>
        <method></method>
        <comments></comments>
        <source></source>
        <site></site>
    </report>
    <report id="">
        <reportDate>YYYY-MM-DDThh:mm:ssZ</reportDate>
        <eventDate>YYYY-MM-DDThh:mm:ssZ</eventDate>
        <type></type>
        <location>
            <description></description>
            <county></county>
            <state></state>
            <latLon format="iso6709">+DD.ddd-DDD.ddd</latLon>
        </location>
        <proximity>
            <distance unit="">DD.dd</distance>
            <bearing unit="degrees from north">DD.dd</bearing>
        </proximity>
        <magnitude unit="">DD.dd</magnitude>
        <method></method>
        <comments></comments>
        <source></source>
        <site></site>
    </report>
        :
        :
</stormReports>

Reports By Region¶

This request returns the storm reports impacting a given region within a date range (the last 24 hours by default). Results are returned as GeoJSON, KML, or XML. No transitions are available from the response. An empty list (feature collection) is returned if there are no reports.

URI Examples¶

forensic.api.wdtinc.com/v2/stormreports/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.kml?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.xml?begin=&end=&u=&t=

See prior sections for a description of the Request Format and Request Parameters.

GeoJSON Response¶

The GeoJSON representation of the resource is structured as follows. The comments property is omitted unless the keyword comments=true or comments=1 is provided in the request parameters.

{
    "apiVersion": "2.5.8",
    "stormReports": {
        "dateRange": {
            "begin": "YYYY-MM-DDThh:mm:ssZ",
            "end": "YYYY-MM-DDThh:mm:ssZ"
        },
        "features": [
            {
                "geometry": {
                    "coordinates": [
                        -84.930000000000007,
                        38.079999999999998
                    ],
                    "type": "Point"
                },
                "properties": {
                    "comments": "",
                    "eventDate": "YYYY-MM-DDThh:mm:ssZ",
                    "id": "",
                    "location": {
                        "county": "",
                        "description": "",
                        "latLon": "+DD.ddd-DDD.ddd",
                        "state": ""
                    },
                    "magnitude": {
                        "unit": "",
                        "value": DD.dd
                    },
                    "method": "",
                    "reportDate": "YYYY-MM-DDThh:mm:ssZ",
                    "site": "",
                    "source": "",
                    "type": ""
                },
                "type": "Feature"
            },
            {
                "geometry": {
                    "coordinates": [
                        -84.930000000000007,
                        38.079999999999998
                    ],
                    "type": "Point"
                },
                "properties": {
                    "comments": "",
                    "eventDate": "YYYY-MM-DDThh:mm:ssZ",
                    "id": "",
                    "location": {
                        "county": "",
                        "description": "",
                        "latLon": "+DD.ddd-DDD.ddd",
                        "state": ""
                    },
                    "magnitude": {
                        "unit": "",
                        "value": DD.dd
                    },
                    "method": "",
                    "reportDate": "YYYY-MM-DDThh:mm:ssZ",
                    "site": "",
                    "source": "",
                    "type": ""
                },
                "type": "Feature"
            },
            :
            :
        ],
        "region": "+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd",
        "selfLink": "/v2/stormreports/categories/hail/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd?begin=&end=&u=&t=",
        "type": "FeatureCollection"
    }
}

KML Response¶

The KML representation of the resource is structured as follows. The comments property is omitted unless the keyword comments=true or comments=1 is provided in the request parameters.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
    <Document>
        <name>Storm Reports</name>
        <ExtendedData>
            <Data name="selfLink">
                <value>/v2/stormreports/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd?begin=&amp;end=&amp;u=&amp;t=</value>
            </Data>
            <Data name="beginDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
            <Data name="endDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
            <Data name="region"><value>+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd</value></Data>
        </ExtendedData>
        <Placemark>
            <name>id</name>
            <ExtendedData>
                <Data name="reportDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="eventDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="type"><value></value></Data>
                <Data name="location"><value></value></Data>
                <Data name="county"><value></value></Data>
                <Data name="state"><value></value></Data>
                <Data name="latLon"><value></value></Data>
                <Data name="magnitude"><value></value></Data>
                <Data name="magnitude-unit"><value></value></Data>
                <Data name="method"><value></value></Data>
                <Data name="comments"><value></value></Data>
                <Data name="source"><value></value></Data>
                <Data name="site"><value></value></Data>
            </ExtendedData>
            <Point>
                <coordinates>-91.95,39.5024</coordinates>
            </Point>
        </Placemark>
        <Placemark>
            <name>id</name>
            <ExtendedData>
                <Data name="reportDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="eventDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="type"><value></value></Data>
                <Data name="location"><value></value></Data>
                <Data name="county"><value></value></Data>
                <Data name="state"><value></value></Data>
                <Data name="latLon"><value></value></Data>
                <Data name="magnitude"><value></value></Data>
                <Data name="magnitude-unit"><value></value></Data>
                <Data name="method"><value></value></Data>
                <Data name="comments"><value></value></Data>
                <Data name="source"><value></value></Data>
                <Data name="site"><value></value></Data>
            </ExtendedData>
            <Point>
                <coordinates>-91.95,39.5024</coordinates>
            </Point>
        </Placemark>
            :
            :
    </Document>
</kml>

XML Response¶

The XML representation of the resource is structured as follows (based on Google’s XML style guide). The comments property is omitted unless the keyword comments=true or comments=1 is provided in the request parameters.

<?xml version="1.0" encoding="UTF-8"?>
<stormReports xmlns="http://forensic.api.wdtinc.com/stormreports"
              xmlns:xlink="http://www.w3.org/1999/xlink"
              xlink:href="/v2/stormreports/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.xml?begin=&amp;end=&amp;u=&amp;t=">
    <dateRange begin="YYYY-MM-DDThh:mm:ssZ" end="YYYY-MM-DDThh:mm:ssZ" />
    <region format="iso6709">+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd</region>
    <report id="">
        <reportDate>YYYY-MM-DDThh:mm:ssZ</reportDate>
        <eventDate>YYYY-MM-DDThh:mm:ssZ</eventDate>
        <type></type>
        <location>
            <description></description>
            <county></county>
            <state></state>
            <latLon format="iso6709">+DD.ddd-DDD.ddd</latLon>
        </location>
        <magnitude unit="">DD.dd</magnitude>
        <method></method>
        <comments></comments>
        <source></source>
        <site></site>
    </report>
    <report id="">
        <reportDate>YYYY-MM-DDThh:mm:ssZ</reportDate>
        <eventDate>YYYY-MM-DDThh:mm:ssZ</eventDate>
        <type></type>
        <location>
            <description></description>
            <county></county>
            <state></state>
            <latLon format="iso6709">+DD.ddd-DDD.ddd</latLon>
        </location>
        <magnitude unit="">DD.dd</magnitude>
        <method></method>
        <comments></comments>
        <source></source>
        <site></site>
    </report>
        :
        :
</stormReports>

Report Categories¶

This request returns a list of available storm report categories and the specific types occurring in each category. Results are returned as JSON or XML. No transitions are available from the response.

URI Examples¶

forensic.api.wdtinc.com/v2/stormreports/categories?u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories.xml?u=&t=

See prior sections for a description of the Request Format and Request Parameters.

Category Summary¶

The following table summarizes the result of the categories request:

Storm Report Category	Storm Report Types
flood	flood, flash flood, coastal flood, lakeshore flood
hail	hail, marine hail
tornado	tornado, funnel cloud, water spout
tropical	hurricane, tropical storm, storm surge
wind	wind, high sust winds, tstm wnd dmg, tstm wnd gust, non-tstm wnd gust, non-tstm wnd dmg, marine tstm wind, downburst
winter	snow, heavy snow, blizzard, freezing rain, sleet, ice storm

Categorical Reports By Proximity¶

This request returns the storm reports in a specific category impacting the proximity around a specific location within a date range (the last 24 hours by default). Results are returned as GeoJSON, KML, or XML. No transitions are available from the response. An empty list (feature collection) is returned if there are no reports.

URI Examples¶

forensic.api.wdtinc.com/v2/stormreports/categories/flood/+DD.ddd-DDD.ddd?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/flood/+DD.ddd-DDD.ddd.kml?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/flood/+DD.ddd-DDD.ddd.xml?radius=&units=&begin=&end=&u=&t=

forensic.api.wdtinc.com/v2/stormreports/categories/hail/+DD.ddd-DDD.ddd?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/hail/+DD.ddd-DDD.ddd.kml?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/hail/+DD.ddd-DDD.ddd.xml?radius=&units=&begin=&end=&u=&t=

forensic.api.wdtinc.com/v2/stormreports/categories/tornado/+DD.ddd-DDD.ddd?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/tornado/+DD.ddd-DDD.ddd.kml?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/tornado/+DD.ddd-DDD.ddd.xml?radius=&units=&begin=&end=&u=&t=

forensic.api.wdtinc.com/v2/stormreports/categories/tropical/+DD.ddd-DDD.ddd?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/tropical/+DD.ddd-DDD.ddd.kml?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/tropical/+DD.ddd-DDD.ddd.xml?radius=&units=&begin=&end=&u=&t=

forensic.api.wdtinc.com/v2/stormreports/categories/wind/+DD.ddd-DDD.ddd?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/wind/+DD.ddd-DDD.ddd.kml?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/wind/+DD.ddd-DDD.ddd.xml?radius=&units=&begin=&end=&u=&t=

forensic.api.wdtinc.com/v2/stormreports/categories/winter/+DD.ddd-DDD.ddd?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/winter/+DD.ddd-DDD.ddd.kml?radius=&units=&begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/winter/+DD.ddd-DDD.ddd.xml?radius=&units=&begin=&end=&u=&t=

See prior sections for a description of the Request Format and Request Parameters.

GeoJSON Response¶

The GeoJSON representation of the resource is structured as follows. The comments property is omitted unless the keyword comments=true or comments=1 is provided in the request parameters.

{
    "apiVersion": "2.5.8",
    "stormReports": {
        "dateRange": {
            "begin": "YYYY-MM-DDThh:mm:ssZ",
            "end": "YYYY-MM-DDThh:mm:ssZ"
        },
        "features": [
            {
                "geometry": {
                    "coordinates": [
                        -84.930000000000007,
                        38.079999999999998
                    ],
                    "type": "Point"
                },
                "properties": {
                    "comments": "",
                    "eventDate": "YYYY-MM-DDThh:mm:ssZ",
                    "id": "",
                    "location": {
                        "county": "",
                        "description": "",
                        "latLon": "+DD.ddd-DDD.ddd",
                        "state": ""
                    },
                    "magnitude": {
                        "unit": "",
                        "value": DD.dd
                    },
                    "method": "",
                    "proximity": {
                        "bearing": {
                            "unit": "degrees from north",
                            "value": DD.dd
                        },
                        "distance": {
                            "unit": "",
                            "value": DD.dd
                        }
                    },
                    "reportDate": "YYYY-MM-DDThh:mm:ssZ",
                    "site": "",
                    "source": "",
                    "type": ""
                },
                "type": "Feature"
            },
            {
                "geometry": {
                    "coordinates": [
                        -84.930000000000007,
                        38.079999999999998
                    ],
                    "type": "Point"
                },
                "properties": {
                    "comments": "",
                    "eventDate": "YYYY-MM-DDThh:mm:ssZ",
                    "id": "",
                    "location": {
                        "county": "",
                        "description": "",
                        "latLon": "+DD.ddd-DDD.ddd",
                        "state": ""
                    },
                    "magnitude": {
                        "unit": "",
                        "value": DD.dd
                    },
                    "method": "",
                    "proximity": {
                        "bearing": {
                            "unit": "degrees from north",
                            "value": DD.dd
                        },
                        "distance": {
                            "unit": "",
                            "value": DD.dd
                        }
                    },
                    "reportDate": "YYYY-MM-DDThh:mm:ssZ",
                    "site": "",
                    "source": "",
                    "type": ""
                },
                "type": "Feature"
            },
            :
            :
        ],
        "location": "+DD.ddd-DDD.ddd",
        "radius": {
            "unit": "miles",
            "value": DD.dd
        },
        "selfLink": "/v2/stormreports/categories/hail/+DD.ddd-DDD.ddd?radius=&units=&begin=&end=&u=&t=",
        "type": "FeatureCollection"
    }
}

KML Response¶

The KML representation of the resource is structured as follows. The comments property is omitted unless the keyword comments=true or comments=1 is provided in the request parameters.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
    <Document>
        <name>Storm Reports</name>
        <ExtendedData>
            <Data name="selfLink">
                <value>/v2/stormreports/categories/category/+DD.ddd-DDD.ddd?radius=&amp;units=&amp;begin=&amp;end=&amp;u=&amp;t=</value>
            </Data>
            <Data name="beginDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
            <Data name="endDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
            <Data name="region"><value>+DD.ddd-DDD.ddd</value></Data>
            <Data name="radius"><value>DD.ddd</value></Data>
            <Data name="radius-unit"><value>miles</value></Data>
        </ExtendedData>
        <Placemark>
            <name>id</name>
            <ExtendedData>
                <Data name="reportDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="eventDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="type"><value></value></Data>
                <Data name="location"><value></value></Data>
                <Data name="county"><value></value></Data>
                <Data name="state"><value></value></Data>
                <Data name="latLon"><value></value></Data>
                <Data name="distance"><value></value></Data>
                <Data name="distance-unit"><value></value></Data>
                <Data name="bearing"><value></value></Data>
                <Data name="bearing-unit"><value>degrees from north</value></Data>
                <Data name="magnitude"><value></value></Data>
                <Data name="magnitude-unit"><value></value></Data>
                <Data name="method"><value></value></Data>
                <Data name="comments"><value></value></Data>
                <Data name="source"><value></value></Data>
                <Data name="site"><value></value></Data>
            </ExtendedData>
            <Point>
                <coordinates>-91.95,39.5024</coordinates>
            </Point>
        </Placemark>
        <Placemark>
            <name>id</name>
            <ExtendedData>
                <Data name="reportDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="eventDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="type"><value></value></Data>
                <Data name="location"><value></value></Data>
                <Data name="county"><value></value></Data>
                <Data name="state"><value></value></Data>
                <Data name="latLon"><value></value></Data>
                <Data name="distance"><value></value></Data>
                <Data name="distance-unit"><value></value></Data>
                <Data name="bearing"><value></value></Data>
                <Data name="bearing-unit"><value>degrees from north</value></Data>
                <Data name="magnitude"><value></value></Data>
                <Data name="magnitude-unit"><value></value></Data>
                <Data name="method"><value></value></Data>
                <Data name="comments"><value></value></Data>
                <Data name="source"><value></value></Data>
                <Data name="site"><value></value></Data>
            </ExtendedData>
            <Point>
                <coordinates>-91.95,39.5024</coordinates>
            </Point>
        </Placemark>
            :
            :
    </Document>
</kml>

XML Response¶

The XML representation of the resource is structured as follows (based on Google’s XML style guide). The comments property is omitted unless the keyword comments=true or comments=1 is provided in the request parameters.

<?xml version="1.0" encoding="UTF-8"?>
<stormReports xmlns="http://forensic.api.wdtinc.com/stormreports"
              xmlns:xlink="http://www.w3.org/1999/xlink"
              xlink:href="/v2/stormreports/categories/category/+DD.ddd-DDD.ddd.xml?radius=&amp;units=&amp;begin=&amp;end=&amp;u=&amp;t=">
    <dateRange begin="YYYY-MM-DDThh:mm:ssZ" end="YYYY-MM-DDThh:mm:ssZ" />
    <region format="iso6709">+DD.ddd-DDD.ddd</region>
    <radius unit="miles">DD.ddd</radius>
    <report id="">
        <reportDate>YYYY-MM-DDThh:mm:ssZ</reportDate>
        <eventDate>YYYY-MM-DDThh:mm:ssZ</eventDate>
        <type></type>
        <location>
            <description></description>
            <county></county>
            <state></state>
            <latLon format="iso6709">+DD.ddd-DDD.ddd</latLon>
        </location>
        <proximity>
            <distance unit="">DD.dd</distance>
            <bearing unit="degrees from north">DD.dd</bearing>
        </proximity>
        <magnitude unit="">DD.dd</magnitude>
        <method></method>
        <comments></comments>
        <source></source>
        <site></site>
    </report>
    <report id="">
        <reportDate>YYYY-MM-DDThh:mm:ssZ</reportDate>
        <eventDate>YYYY-MM-DDThh:mm:ssZ</eventDate>
        <type></type>
        <location>
            <description></description>
            <county></county>
            <state></state>
            <latLon format="iso6709">+DD.ddd-DDD.ddd</latLon>
        </location>
        <proximity>
            <distance unit="">DD.dd</distance>
            <bearing unit="degrees from north">DD.dd</bearing>
        </proximity>
        <magnitude unit="">DD.dd</magnitude>
        <method></method>
        <comments></comments>
        <source></source>
        <site></site>
    </report>
        :
        :
</stormReports>

Categorical Reports By Region¶

This request returns the storm reports in a specific category impacting a given region within a date range (the last 24 hours by default). Results are returned as GeoJSON, KML, or XML. No transitions are available from the response. An empty list (feature collection) is returned if there are no reports.

URI Examples¶

forensic.api.wdtinc.com/v2/stormreports/categories/flood/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/flood/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.kml?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/flood/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.xml?begin=&end=&u=&t=

forensic.api.wdtinc.com/v2/stormreports/categories/hail/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/hail/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.kml?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/hail/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.xml?begin=&end=&u=&t=

forensic.api.wdtinc.com/v2/stormreports/categories/tornado/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/tornado/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.kml?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/tornado/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.xml?begin=&end=&u=&t=

forensic.api.wdtinc.com/v2/stormreports/categories/tropical/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/tropical/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.kml?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/tropical/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.xml?begin=&end=&u=&t=

forensic.api.wdtinc.com/v2/stormreports/categories/wind/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/wind/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.kml?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/wind/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.xml?begin=&end=&u=&t=

forensic.api.wdtinc.com/v2/stormreports/categories/winter/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/winter/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.kml?begin=&end=&u=&t=
forensic.api.wdtinc.com/v2/stormreports/categories/winter/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.xml?begin=&end=&u=&t=

See prior sections for a description of the Request Format and Request Parameters.

GeoJSON Response¶

The GeoJSON representation of the resource is structured as follows. The comments property is omitted unless the keyword comments=true or comments=1 is provided in the request parameters.

{
    "apiVersion": "2.5.8",
    "stormReports": {
        "dateRange": {
            "begin": "YYYY-MM-DDThh:mm:ssZ",
            "end": "YYYY-MM-DDThh:mm:ssZ"
        },
        "features": [
            {
                "geometry": {
                    "coordinates": [
                        -84.930000000000007,
                        38.079999999999998
                    ],
                    "type": "Point"
                },
                "properties": {
                    "comments": "",
                    "eventDate": "YYYY-MM-DDThh:mm:ssZ",
                    "id": "",
                    "location": {
                        "county": "",
                        "description": "",
                        "latLon": "+DD.ddd-DDD.ddd",
                        "state": ""
                    },
                    "magnitude": {
                        "unit": "",
                        "value": DD.dd
                    },
                    "method": "",
                    "reportDate": "YYYY-MM-DDThh:mm:ssZ",
                    "site": "",
                    "source": "",
                    "type": ""
                },
                "type": "Feature"
            },
            {
                "geometry": {
                    "coordinates": [
                        -84.930000000000007,
                        38.079999999999998
                    ],
                    "type": "Point"
                },
                "properties": {
                    "comments": "",
                    "eventDate": "YYYY-MM-DDThh:mm:ssZ",
                    "id": "",
                    "location": {
                        "county": "",
                        "description": "",
                        "latLon": "+DD.ddd-DDD.ddd",
                        "state": ""
                    },
                    "magnitude": {
                        "unit": "",
                        "value": DD.dd
                    },
                    "method": "",
                    "reportDate": "YYYY-MM-DDThh:mm:ssZ",
                    "site": "",
                    "source": "",
                    "type": ""
                },
                "type": "Feature"
            },
            :
            :
        ],
        "region": "+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd",
        "selfLink": "/v2/stormreports/categories/hail/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd?begin=&end=&u=&t=",
        "type": "FeatureCollection"
    }
}

KML Response¶

The KML representation of the resource is structured as follows. The comments property is omitted unless the keyword comments=true or comments=1 is provided in the request parameters.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
    <Document>
        <name>Storm Reports</name>
        <ExtendedData>
            <Data name="selfLink">
                <value>/v2/stormreports/categories/category/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd?begin=&amp;end=&amp;u=&amp;t=</value>
            </Data>
            <Data name="beginDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
            <Data name="endDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
            <Data name="region"><value>+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd</value></Data>
        </ExtendedData>
        <Placemark>
            <name>id</name>
            <ExtendedData>
                <Data name="reportDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="eventDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="type"><value></value></Data>
                <Data name="location"><value></value></Data>
                <Data name="county"><value></value></Data>
                <Data name="state"><value></value></Data>
                <Data name="latLon"><value></value></Data>
                <Data name="magnitude"><value></value></Data>
                <Data name="magnitude-unit"><value></value></Data>
                <Data name="method"><value></value></Data>
                <Data name="comments"><value></value></Data>
                <Data name="source"><value></value></Data>
                <Data name="site"><value></value></Data>
            </ExtendedData>
            <Point>
                <coordinates>-91.95,39.5024</coordinates>
            </Point>
        </Placemark>
        <Placemark>
            <name>id</name>
            <ExtendedData>
                <Data name="reportDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="eventDate"><value>YYYY-MM-DDThh:mm:ssZ</value></Data>
                <Data name="type"><value></value></Data>
                <Data name="location"><value></value></Data>
                <Data name="county"><value></value></Data>
                <Data name="state"><value></value></Data>
                <Data name="latLon"><value></value></Data>
                <Data name="magnitude"><value></value></Data>
                <Data name="magnitude-unit"><value></value></Data>
                <Data name="method"><value></value></Data>
                <Data name="comments"><value></value></Data>
                <Data name="source"><value></value></Data>
                <Data name="site"><value></value></Data>
            </ExtendedData>
            <Point>
                <coordinates>-91.95,39.5024</coordinates>
            </Point>
        </Placemark>
            :
            :
    </Document>
</kml>

XML Response¶

The XML representation of the resource is structured as follows (based on Google’s XML style guide). The comments property is omitted unless the keyword comments=true or comments=1 is provided in the request parameters.

<?xml version="1.0" encoding="UTF-8"?>
<stormReports xmlns="http://forensic.api.wdtinc.com/stormreports"
              xmlns:xlink="http://www.w3.org/1999/xlink"
              xlink:href="/v2/stormreports/categories/category/+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd.xml?begin=&amp;end=&amp;u=&amp;t=">
    <dateRange begin="YYYY-MM-DDThh:mm:ssZ" end="YYYY-MM-DDThh:mm:ssZ" />
    <region format="iso6709">+DD.ddd-DDD.ddd+DD.ddd-DDD.ddd</region>
    <report id="">
        <reportDate>YYYY-MM-DDThh:mm:ssZ</reportDate>
        <eventDate>YYYY-MM-DDThh:mm:ssZ</eventDate>
        <type></type>
        <location>
            <description></description>
            <county></county>
            <state></state>
            <latLon format="iso6709">+DD.ddd-DDD.ddd</latLon>
        </location>
        <magnitude unit="">DD.dd</magnitude>
        <method></method>
        <comments></comments>
        <source></source>
        <site></site>
    </report>
    <report id="">
        <reportDate>YYYY-MM-DDThh:mm:ssZ</reportDate>
        <eventDate>YYYY-MM-DDThh:mm:ssZ</eventDate>
        <type></type>
        <location>
            <description></description>
            <county></county>
            <state></state>
            <latLon format="iso6709">+DD.ddd-DDD.ddd</latLon>
        </location>
        <magnitude unit="">DD.dd</magnitude>
        <method></method>
        <comments></comments>
        <source></source>
        <site></site>
    </report>
        :
        :
</stormReports>