Return to API Services
Documentation for /cgi-bin/request/hourlyprecip.py
This service emits hourly precipitation data based on processed METAR observations by the IEM.
Changelog
- 2024-09-04: Initial update and examples
Example Usage
Return the hourly precip for Ames, IA for the month of January 2024 with the station's state and lat/lon included:
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 |
|---|---|---|
| ets | string | The end of the requested interval. |
| lalo | boolean | Include the lat/lon in the output. |
| network | string | IEM network identifier. Typically a combination of a US state abbreviation and a network classification, ie IA_ASOS. |
| st | boolean | Include the state in the output. |
| station | Multi-Params or CSV value | The station(s) to request data for. |
| sts | string | The start of the requested interval. |
| tz | string | A time zone string specified by IANA. Common examples include 'America/Chicago', 'UTC', and 'Etc/UTC'. The code implementation passes this provided string to the python ZoneInfo library. |
| year1 | integer | The start year, when sts is unset. |
| month1 | integer | The start month, when sts is unset. |
| day1 | integer | The start day, when sts is unset. |
| year2 | integer | The end year, when ets is unset. |
| month2 | integer | The end month, when ets is unset. |
| day2 | integer | The end day, when ets is unset. |