IEM Provided JSON-P Webservices
This page is an attempt to document the various JSON-P web services the
IEM uses to drive its various applications. These services are provided without
warranty and may be disabled without warning if "bad things happen". We do
try our best to keep them running, so please Contact Us
if you have difficulties.
These services support JSONP,
which is a technique that allows the deliver of data from a cross-domain origin.
The technique involves placing or injecting <script> tags into your webpage
and specifying a javascript function to callback. For example,
<script type="text/javascript">
function gotData(data){
console.log(data);
}
</script>
<script type="text/javascript"
src="https://mesonet.agron.iastate.edu/json/example.php?callback=gotData">
This <script> tag above that requests data from this server will return
javascript that looks like:
gotData({"Name": "daryl", "Profession": "nerd", "Age": 99});
Okay, so you are all set for documentation on what services are available!
Oregon State PRISM Grid Cell Daily Sample
URI: http://mesonet.agron.iastate.edu/json/prism/{lon}/{lat}/{date_or_daterange}?callback=gotData
Description: Produces a daily time series for a grid cell that covers the specified latitude and longitude (negative E values). Credit:
PRISM Climate Group, Oregon State University, created 4 Feb 2004.
Method GET Parameters:
lat | Latitude (deg N) |
---|
lon | Longitude (deg E) |
---|
date_or_daterange | YYYYmmdd or YYYYmmdd-YYYYmmdd (inclusive) |
---|
Example JSON
Example JSONP
Local Storm Reports for One Storm Based Warning
URI: http://mesonet.agron.iastate.edu/geojson/lsr.php?year={year}&wfo={wfo}&eventid={eventid}&phenomena={phenomena}&significance={significance}&callback=gotData
Description: Produces the storm reports that spatially and temporally
coincide with a given Storm Based Warning. This only works for
warnings that had polygons associated with them and not other VTEC
products.
Method GET Parameters:
wfo | 3 character NWS Office |
---|
year | Year of VTEC Issuance |
---|
phenomena | 2 character VTEC Phenomena Code |
---|
significance | 1 character VTEC Significance Code |
---|
eventid | VTEC Event ID |
---|
Example JSON
Example JSONP
Local Storm Reports for a given period
URI: http://mesonet.agron.iastate.edu/geojson/lsr.php?sts={sts}&ets={ets}&wfos={wfos}&callback=gotData
Description: Produces the storm reports for a given office or offices
valid for a specified period (inclusive).
Method GET Parameters:
wfo | 3 character NWS Office (comma seperated for multiple, leave blank for all) |
---|
sts | UTC Start Timestamp YYYYmmddHHMM |
---|
ets | UTC End Timestamp YYYYmmddHHMM |
---|
Example JSON
Example JSONP
Archived NEXRAD Storm Attribute Table
URI: http://mesonet.agron.iastate.edu/geojson/nexrad_attr.geojson?valid={valid}&callback=gotData
Description: A GeoJSON summary of archived NEXRAD Storm Attributes. For the supplied UTC timestamp, the closest scan time within a 20 minute window is found for each RADAR. That scan time is returned.
Method GET Parameters:
valid | ISO-8601 timestamp YYYY-mm-ddTHH:MM:SSZ |
---|
Example JSON
Example JSONP
NWS Impact Based Warnings Tags
URI: http://mesonet.agron.iastate.edu/json/ibw_tags.py?year={year}&wfo={wfo}&callback=gotData
Description: Produces a listing of Impact Warning Tags used in Severe
Thunderstorm and Tornado warnings by NWS Forecast Office and Year.
Method GET Parameters:
wfo | 3 character NWS Office |
---|
year | Year of interest |
---|
Example JSON
Example JSONP
NWS COOP Station Climatology
URI: http://mesonet.agron.iastate.edu/json/climodat_stclimo.py?station={station}&syear={syear}&eyear={eyear}&callback=gotData
Description: Produces a listing of daily climatology for an IEM tracked
long term climodat site in the midwestern US.
Method GET Parameters:
station | 6 character station identifier |
---|
syear | Exclusive end year of the period of interest |
---|
Example JSON
Example JSONP
NWS COOP Network Climatology for one day
URI: http://mesonet.agron.iastate.edu/geojson/climodat_dayclimo.py?network={network}&day={day}&month={month}&syear={syear}&eyear={eyear}&callback=gotData
Description: Produces a listing of climatology for a single state
for a single day.
Method GET Parameters:
network | state network identifier |
---|
month | Numeric month of interest (1-12) |
---|
day | Numeric day of interest (1-31) |
---|
syear | Exclusive end year of the period of interest |
---|
Example JSON
Example JSONP
NWS VTEC Event Listing by WFO by Year
URI: http://mesonet.agron.iastate.edu/json/vtec_events.py?wfo={wfo}&year={year}&callback=gotData
Description: Produces a listing of VTEC Events (watch, warning,
advisories) by year by weather forecast office.
Method GET Parameters:
wfo | 3 character WFO identifier |
---|
year | YYYY year |
---|
Example JSON
Example JSONP
NWS Text Products by AWIPS ID and Time Period
URI: http://mesonet.agron.iastate.edu/json/nwstext_search.py?sts={sts}&ets={ets}&awipsid={awipsid}&callback=gotData
Description: Search of NWS Issued Text Products by a time period (in
UTC) and an AWIPS ID (sometime called AFOS PIL).
Method GET Parameters:
sts | YYYY-mm-ddTHH:MMZ Inclusive start period (UTC) |
---|
ets | YYYY-mm-ddTHH:MMZ end time period (UTC) |
---|
awipsid | 6 character or less AWIPS ID / AFOS PIL. |
---|
Example JSON
Example JSONP
Daily NWS Climate (CLI Product) Summaries
URI: http://mesonet.agron.iastate.edu/geojson/cli.py?dt={dt}&fmt={fmt}&callback=gotData
Description: Provides a GeoJSON response summarizing all of the atomic
processed data from the NWS issued CLI reports. These reports contain
daily temperature, precipitation, and snow data from the primary
climate sites.
Method GET Parameters:
dt | YYYY-mm-dd Date you want data for (optional) |
---|
fmt | Return format (optional) geojson (default) or csv |
---|
Example JSON
Example JSONP
IEM Tile Map Service Metadata
URI: http://mesonet.agron.iastate.edu/json/tms.json?callback=gotData
Description: Provides metadata about the currently available Tile Map
Services provided by the IEM. This is useful to determine how to
call back to the Tile Map Services.
Method GET Parameters:
Example JSON
Example JSONP
Current Storm Based Warnings
URI: http://mesonet.agron.iastate.edu/geojson/sbw.geojson?callback=gotData
Description: Provides a geojson format of current National Weather Service
storm based warnings. There is a 15 second caching done by the server
to ease load. The generation_time attribute is set on the output
to diagnose when the file is valid.
Method GET Parameters:
Example JSON
Example JSONP
Search for Storm Based Warnings by Lat/Lon Point
URI: http://mesonet.agron.iastate.edu/json/sbw_by_point.py?lon={longitude}&lat={latitude}&callback=gotData
Description: Provides a listing of storm based (polygon) warnings
based on the provided latitutde and longitude pair for warnings
dating back to 1 Jan 2005.
Method GET Parameters:
lat | Latitude in degrees |
---|
lon | Longitude in (degrees east) |
---|
Example JSON
Example JSONP
Search for VTEC Events by Lat/Lon Point
URI: http://mesonet.agron.iastate.edu/json/vtec_events_bypoint.py?lon={longitude}&lat={latitude}&sdate={sdate}&edate={edate}&callback=gotData
Description: Provides a listing of VTEC events that were valid for
a given latitude and longitude point.
Method GET Parameters:
lat | Latitude in degrees |
---|
lon | Longitude in (degrees east) |
---|
sdate | YYYY-mm-dd Start Date (UTC) |
---|
edate | YYYY-mm-dd End Date (UTC) |
---|
Example JSON
Example JSONP
Search for Warnings by UGC Code and Date Interval
URI: http://mesonet.agron.iastate.edu/json/vtec_events_byugc.php?ugc={ugc}&edate={edate}&sdate={sdate}&callback=gotData
Description: Provides a json response of archived warnings valid for the
given UGC code and date interval (UTC time, end date exclusive). The date
of product issuance is used for the date filtering.
Method GET Parameters:
ugc | Five character UGC identifier used by the NWS |
---|
sdate | YYYY-mm-dd Start Date (UTC) |
---|
edate | YYYY-mm-dd End Date (UTC) |
---|
Example JSON
Example JSONP
Storm Prediction Center Watches
URI: http://mesonet.agron.iastate.edu/json/spcwatch.py?ts={timestamp}&callback=gotData
Description: Provides a geojson format of SPC watches valid at given time
or current time if no time specified.
Method GET Parameters:
timestamp | YYYYMMDDHHMI UTC Timestamp (optional) |
---|
Example JSON
Example JSONP
RAOB Soundings
URI: http://mesonet.agron.iastate.edu/json/raob.py?ts={timestamp}&station={station}&callback=gotData
Description: Provides a single sounding profile for the given station,
either a 3 or 4 character site ID and a UTC timestamp. Realtime data
from this service is typically available within 2 hours of observation
time.
Method GET Parameters:
sid | 3 or 4 character site ID used in North America |
---|
timestamp | YYYYMMDDHHMI UTC Timestamp |
---|
Example JSON
Example JSONP
SHEF Station Variables
URI: http://mesonet.agron.iastate.edu/json/dcp_vars.php?station={station}&callback=gotData
Description: Provides SHEF variables provided by this station.
Method GET Parameters:
station | National Weather Service Location Identifier (nwsli) |
---|
Example JSON
Example JSONP
Data Collection Network Details
URI: http://mesonet.agron.iastate.edu/json/network/{network}.geojson?callback=gotData
Description: The IEM bunches observation stations into networks. This
service provides metadata for sites within a network. A listing of networks
can be found on
this page.
Method GET Parameters:
network | IEM Network Identifier |
---|
Example JSON
Example JSONP
IEM Archived Data Products
URI: http://mesonet.agron.iastate.edu/json/products.php?callback=gotData
Description: The IEM generates and archives a large number of products.
This service provides some metadata details necessary to build programic URIs
against this archive of data. This service drives the
Timemachine
application.
Method GET Parameters:
Example JSON
Example JSONP
GOES East/West Available Scans
URI: http://mesonet.agron.iastate.edu/json/goes.py?operation=list&start={start}&end={end}&bird={bird}&product={product}&callback=gotData
Description: This service returns a listing of available GOES scan
times for a period of time. This service will default to the past
four hours worth of data when start and end times are not specified.
Method GET Parameters:
operation | Currently always 'list' |
---|
start | ISO-8601 UTC Timestamp (optional) |
---|
end | ISO-8601 UTC Timestamp (optional) |
---|
bird | GOES EAST or GOES WEST |
---|
product | GOES Channel IR, VIS, or WV |
---|
Example JSON
Example JSONP
RIDGE Single Site Available NEXRADs
URI: http://mesonet.agron.iastate.edu/json/radar?operation=available&lat={lat}&lon={lon}&start={start}&callback=gotData
Description: This service returns an estimate of which NEXRAD RADARs have
imagery available for the timestamp and latitude / longitude location you specify.
Method GET Parameters:
lat | Point location latitude (degrees north) |
---|
lon | Point location longitude (degrees east) |
---|
start | ISO-8601 UTC Timestamp |
---|
Example JSON
Example JSONP
RIDGE Current Metadata by Product
URI: http://mesonet.agron.iastate.edu/json/ridge_current.py?product={product}&callback=gotData
Description: This service returns a listing of the most recent image for
a given product from all collected RADAR sites.
Method GET Parameters:
product | Level III Product {N0Q, N0S, N0U, N0Z, NET} |
---|
Example JSON
Example JSONP
RIDGE Single Site Available Volume Scan Times
URI: http://mesonet.agron.iastate.edu/json/radar?operation=list&radar={radar}&product={product}&start={start}&end={end}&callback=gotData
Description: This service returns NEXRAD volume scan times for a given
RADAR, level 3 product, and start/end timestamp.
Method GET Parameters:
radar | NEXRAD 3 character identifier |
---|
product | Three character level 3 NEXRAD product identifier. |
---|
start | ISO-8601 UTC Timestamp |
---|
end | ISO-8601 UTC Timestamp |
---|
Example JSON
Example JSONP
NWS State UGC Codes
URI: http://mesonet.agron.iastate.edu/json/state_ugc.php?state={state}&callback=gotData
Description: This service returns metadata for UGC codes used by the
National Weather Service to issue warnings for in a given state.
Method GET Parameters:
state | Two character state identifier |
---|
Example JSON
Example JSONP
NWS Text Product
URI: http://mesonet.agron.iastate.edu/json/nwstext.py?product_id={product_id}&callback=gotData
Description: This service returns the raw text of a NWS Text Product.
Method GET Parameters:
product_id | String that uniquely (not fully) indentifies a text product. |
---|
Example JSON
Example JSONP
IEM Tracked Station Metadata Changes
URI: http://mesonet.agron.iastate.edu/json/stations.php?date={date}&callback=gotData
Description: This service returns metadata for any IEM tracked
station locations with changed metadata since the given date. This provides
a programic mechanism to keep up with metadata updates done on a daily basis.
Method GET Parameters:
date | Request changes since this date |
---|
Example JSON
Example JSONP
IEM Webcam Availability
URI: http://mesonet.agron.iastate.edu/json/webcams.php?network={network}&ts={ts}&callback=gotData
Description: This service returns metadata on available webcam imagery
for a given network that collects webcams and a UTC timestamp.
Method GET Parameters:
network | IEM Webcam network (KCCI, KELO, KCRG, IDOT) |
---|
ts | UTC Timestamp that you want images for |
---|
Example JSON
Example JSONP
That is all for now. Enjoy!