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.json?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});
These services are generally legacy with more modern services being provided in our API.
Okay, so you are all set for documentation on what services are available!
URI Pattern:
https://mesonet.agron.iastate.edu/geojson/usdm.py?date={date}&callback=gotData
Description: The US Drought Monitor valid for the given date. You do not need to specify the exact date on which the Drought Monitor was issued. The service will compute the date on which the Drought Monitor was issued given the provided date. Not specifying a date will provide the current Drought Monitor. Archive begins on Jan 2000.
Method GET Parameters:
date | Date (optional) |
---|
URI Pattern:
https://mesonet.agron.iastate.edu/json/current.py?station={station}&network={network}&callback=gotData
Description: The most recent observation for an IEM tracked site.
Method GET Parameters:
station | Station Identifier |
---|---|
network | Network Identifier |
URI Pattern:
https://mesonet.agron.iastate.edu/json/stage4/{lon}/{lat}/{utc_date}?callback=gotData
Description: This service provides a grid point sampling of the NCEP Stage IV product. The date provided the service is a UTC date. Note that the hourly stage IV data does not receive the level of QC that the 6, 12, and 24 hour summaries do.
Method GET Parameters:
lat | Latitude (deg N) |
---|---|
lon | Longitude (deg E) |
utc_date | YYYY-mm-dd |
URI Pattern:
https://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, Tornado, Marine, and Flash Flood Warnings warnings by NWS Forecast Office and Year.
Method GET Parameters:
wfo | 3 character NWS Office |
---|---|
year | Year of interest |
URI Pattern:
https://mesonet.agron.iastate.edu/geojson/winter_roads.geojson?callback=gotData
Description: This service provides the most recent Iowa Winter Road Conditions.
Method GET Parameters:
URI Pattern:
https://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 | Inclusive start year of the period of interest |
eyear | Exclusive end year of the period of interest |
URI Pattern:
https://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 | Inclusive start year of the period of interest |
eyear | Exclusive end year of the period of interest |
URI Pattern:
https://mesonet.agron.iastate.edu/json/vtec_max_etn.py?year={year}&callback=gotData
Description: Produces a listing of the maximum eventid used for each NWS Forecast Office, VTEC Phenomena and VTEC Significance.
Method GET Parameters:
year | YYYY year |
---|
URI Pattern:
https://mesonet.agron.iastate.edu/geojson/vtec_event.py?wfo={wfo}&year={year}&phenomena={phenomena}&etn={etn}&significance={significance}&callback=gotData
Description: Produces GeoJSON for a given VTEC Event.
Method GET Parameters:
wfo | 3 or 4 character WFO identifier |
---|---|
year | YYYY year |
etn | VTEC Event ID |
phenomena | 2 Character VTEC Phenomena Code |
significance | 1 Character VTEC Significance Code |
sbw | 1 or 0, flag to return Storm Based Polygon(1) or Counties |
lsrs | 1 or 0, flag to return local storm reports |
URI Pattern:
https://mesonet.agron.iastate.edu/json/vtec_event.py?wfo={wfo}&year={year}&phenomena={phenomena}&etn={etn}&significance={significance}&callback=gotData
Description: Produces metadata on a given VTEC Event.
Method GET Parameters:
wfo | 3 or 4 character WFO identifier |
---|---|
year | YYYY year |
etn | VTEC Event ID |
phenomena | 2 Character VTEC Phenomena Code |
significance | 1 Character VTEC Significance Code |
URI Pattern:
https://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. You can optionally pass a
phenomena=XX
and
significance=X
to the service to only return that VTEC event
type for the given WFO and year. Additionally, there is a one-off feature
flag of combo=1
, which has the service return and Tornado,
Severe Thunderstorm, and Flash Flood Watches/Warnings in chronological order.Method GET Parameters:
wfo | 3 character WFO identifier |
---|---|
year | YYYY year |
URI Pattern:
https://mesonet.agron.iastate.edu/json/vtec_events_bystate.py?state={state}&year={year}&callback=gotData
Description: Produces a listing of VTEC Events (watch, warning, advisories) by year by state.
Method GET Parameters:
state | 2 character State identifier |
---|---|
year | YYYY year |
URI Pattern:
https://mesonet.agron.iastate.edu/json/vtec_events_bywfo.py?wfo={wfo}&start={start}&end={end}&callback=gotData
Description: Produces a listing of VTEC Events (watch, warning, advisories) by wfo with UGC information enumerated.
Method GET Parameters:
wfo | 3 character WFO identifier |
---|---|
start | ISO Start Datetime UTC (YYYY-MM-DDTHH:MM) |
end | ISO End Datetime UTC (YYYY-MM-DDTHH:MM) |
URI Pattern:
https://mesonet.agron.iastate.edu/json/cli.py?station={station}&year={year}&fmt={fmt}&callback=gotData
Description: Provides a JSON response summarizing all of the atomic processed data from the NWS issued CLI reports for a single station and given year. You can optionally set
fmt=csv
to get a CSV
response.Method GET Parameters:
year | YYYY desired |
---|---|
station | ICAO 4-character station identifier |
fmt | Return format (optional) json (default) or csv |
URI Pattern:
https://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:
URI Pattern:
https://mesonet.agron.iastate.edu/geojson/sbw.geojson?ts={ts}&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. You can provide a timestamp to provide archived warnings back to 2002 or so. The polygons returned are the actualy ones valid at the given timestamp or realtime, so any polygon updates done with warning event are included here. There should only be one polygon per warning event. You can optionally pass a
wfo=WFO3Char
to
limit the polygons to a single office.Method GET Parameters:
ts | ISO-8601 Timestamp YYYY-mm-ddTHH:MI:SSZ (optional) |
---|
URI Pattern:
https://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) |
fmt | (optional) Format to download as: json (default) or xlsx |
URI Pattern:
https://mesonet.agron.iastate.edu/json/vtec_events_byugc.py?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) |
fmt | (optional) Format to download as: json (default) or xlsx |
URI Pattern:
https://mesonet.agron.iastate.edu/geojson/network.py?network={network}&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 |
---|
URI Pattern:
https://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 |
URI Pattern:
https://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. |
---|
That is all for now. Enjoy!