Skip to content

Commit 87f1cab

Browse files
committed
add news details and make small edits to README
1 parent a554f3d commit 87f1cab

2 files changed

Lines changed: 6 additions & 4 deletions

File tree

NEWS.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
**12/04/2025:** The `get_continuous()` function was added to the `waterdata` module, which provides access to measurements collected via automated sensors at a high frequency (often 15 minute intervals) at a monitoring location. This is an early version of the continuous endpoint and should be used with caution as the API team improves its performance. In the future, we anticipate the addition of an endpoint(s) specifically for handling large data requests, so it may make sense for power users to hold off on heavy development using the new continuous endpoint.
2+
13
**11/24/2025:** `dataretrieval` is pleased to offer a new module, `waterdata`, which gives users access USGS's modernized [Water Data APIs](https://api.waterdata.usgs.gov/). The Water Data API endpoints include daily values, instantaneous values, field measurements (modernized groundwater levels service), time series metadata, and discrete water quality data from the Samples database. Though there will be a period of overlap, the functions within `waterdata` will eventually replace the `nwis` module, which currently provides access to the legacy [NWIS Water Services](https://waterservices.usgs.gov/). More example workflows and functions coming soon. Check `help(waterdata)` for more information.
24

35
**09/03/2024:** The groundwater levels service has switched endpoints, and `dataretrieval` was updated accordingly in [`v1.0.10`](https://github.com/DOI-USGS/dataretrieval-python/releases/tag/v1.0.10). Older versions using the discontinued endpoint will return 503 errors for `nwis.get_gwlevels` or the `service='gwlevels'` argument. Visit [Water Data For the Nation](https://waterdata.usgs.gov/blog/wdfn-waterservices-2024/) for more information.

README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,16 @@
66

77
## Latest Announcements
88

9-
:mega: **12/03/2025:** `dataretrieval` now features the new `waterdata` module,
9+
:mega: **12/04/2025:** `dataretrieval` now features the new `waterdata` module,
1010
which provides access to USGS's modernized [Water Data
1111
APIs](https://api.waterdata.usgs.gov/). The Water Data API endpoints include
12-
daily values, instantaneous values, field measurements, time series metadata,
12+
daily values, **instantaneous values**, field measurements, time series metadata,
1313
and discrete water quality data from the Samples database. This new module will
1414
eventually replace the `nwis` module, which provides access to the legacy [NWIS
1515
Water Services](https://waterservices.usgs.gov/).
1616

17+
Check out the [NEWS](NEWS.md) file for all updates and announcements.
18+
1719
**Important:** Users of the Water Data APIs are strongly encouraged to obtain an
1820
API key for higher rate limits and greater access to USGS data. [Register for
1921
an API key](https://api.waterdata.usgs.gov/signup/) and set it as an
@@ -24,8 +26,6 @@ import os
2426
os.environ["API_USGS_PAT"] = "your_api_key_here"
2527
```
2628

27-
Check out the [NEWS](NEWS.md) file for all updates and announcements.
28-
2929
## What is dataretrieval?
3030

3131
`dataretrieval` simplifies the process of loading hydrologic data into Python.

0 commit comments

Comments
 (0)