get_readings
Fetch current readings from one source, each with value, unit, a one-line summary, place and provenance (source, URL, fetch time, licence). Sources this server will not republish (non-commercial, restricted or unreviewed licence) answer with an error naming the licence.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Ad-hoc point latitude (with lng). For weather and WSI. | |
| lng | No | Ad-hoc point longitude (with lat). | |
| min | No | usgs-earthquakes only: all | 1.0 | 2.5 | 4.5 | significant. | |
| tag | No | Catalogue places with this tag, e.g. waterfowl, ice-fishing. | |
| bbox | No | noaa-nwps only: xmin,ymin,xmax,ymax in degrees (≤400 sq deg); default the Great Lakes basin. | |
| usgs | No | USGS monitoring location id(s), e.g. USGS-04193500. | |
| coops | No | NOAA CO-OPS station id(s), comma-separated, e.g. 9063085. | |
| ebird | No | eBird region code(s), e.g. US-OH-095. | |
| limit | No | 1-1000, default 100. | |
| place | No | Comma-separated catalogue place ids (see list_places). | |
| since | No | ISO date or datetime; only readings at or after it. | |
| state | No | epa-echo only: two-letter US state, default OH. | |
| metric | No | Only readings of this metric. | |
| source | Yes | A source id with a fetcher (search_sources with fetchable=true). | |
| window | No | usgs-earthquakes only: hour | day | week. | |
| elevated | No | usgs-volcanoes only: true keeps volcanoes above normal. | |
| forecast | No | false drops modelled future values. |