Return to API Services
Documentation for /json/sbw_by_point.py
Returns NWS Storm Based Warnings for a provided latitude and longitude point.
Changelog
- 2026-02-26: Renamed top level metadata generation_time to generated_at for better IEM app consistency.
- 2024-10-16: Added buffer parameter to expand the search area around the provided point. The units are in decimal degrees with a range limited between 0 and 1.
- 2024-07-23: Initial documentation update and migration to pydantic.
Examples
Return all storm based warnings that were active at a given time for a given latitude and longitude point.
Return all storm based warnings for a given latitude and longitude point valid during 2023 in Excel format.
Same request, but in CSV format.
Provide all storm based warnings for a point in Iowa and buffer this point by 0.5 degrees.
https://mesonet.agron.iastate.edu/json/sbw_by_point.py?lat=41.99&lon=-92.0&buffer=0.5
CGI Arguments
The following table lists the CGI arguments that are accepted by this service. A HTTP GET request is required. Fields of type Multi-Params or CSV value can accept either a comma separated list or multiple parameter and value combinations. For example, ?foo=1&foo=2 is equivalent to ?foo=1,2.
| Field | Type | Description |
|---|---|---|
| callback | string or null | Legacy JSON-P style callback. It is likely best to not depend on this usage. The IEM website has a permissive CORS. |
| buffer | number | Buffer in decimal degrees around point |
| fmt | string | The format of the response |
| lat | number | Latitude (decimal degrees) of point of interest |
| lon | number | Longitude (decimal degrees) of point of interest |
| sdate | string | Start Date |
| edate | string | End Date |
| valid | string | If provided, only provide results valid at this time. |