Skip to content

Commit 66d937d

Browse files
committed
Add CRAN announcment to Status
1 parent 609d0ce commit 66d937d

File tree

1 file changed

+14
-15
lines changed

1 file changed

+14
-15
lines changed

vignettes/Status.Rmd

Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,20 @@ On March 11, 2024, NWIS **discrete water quality** services were "frozen": any p
2525

2626
If you have additional questions about the NWIS qw data service, email [email protected].
2727

28+
## Latest CRAN update
29+
30+
* dataRetrieval now uses `httr2` instead of `httr` under the hood for constructing web service calls. The `httr2` package is considered the modern replacement for `httr`, and has support going forward (unlike `httr`). Depending on how you perform the package updates, you may need to install `httr2`.
31+
32+
* dataRetrieval will give a message with the requested URL each time a web service call is made. These can be hidden by wrapping dataRetrieval calls with `suppressMessages`. That being said, it is very informative to see exactly where the data is coming from.
33+
34+
* The output of the "constructURL..." functions are now `httr2` requests instead of a character string.
35+
36+
* The update to `httr2` will give us more flexibility to set up the eventual replacements to the NWIS web services. Over the next year, expect to see some new and major updates to USGS data access. dataRetrieval WILL stay on the cutting edge for accessing new USGS APIs.
37+
* WQP continues to default to the legacy system (that does not include recent USGS discrete sample data). To access the most recent USGS data from the new "WQX3" services use the function `readWQPqw` and set the argument `legacy=FALSE` or use the function `readWQPdata` and set the argument `service = "ResultWQX3"`. Why aren't the new services set as default? This is because the WQP itself still considers those services "beta", and therefore performance is not guaranteed.
38+
39+
* Finally, saving the best for last! There's a new set of functions that access the new USGS "samples-data" services. This is a USGS-specific service for discrete sample data. If you are only interested in USGS discrete water quality data (as opposed to USGS AND non-USGS discrete water quality data available from Water Quality Portal), you can use the `read_USGS_samples` function.
40+
41+
Read more about it here: <https://doi-usgs.github.io/dataRetrieval/articles/samples_data.html>
2842

2943
## Locating USGS data using the Water Quality Portal
3044

@@ -244,18 +258,3 @@ So for site "05114000", there are 381 NWIS qw parameters that have been measured
244258
New services/functions are being developed to replace the lost functionality so check back here for updated information.
245259

246260

247-
# Known Dependencies
248-
249-
### EGRET
250-
251-
The `readNWISSample` function will be deprecated or updated. Plan to switch to `readWQPSample`.
252-
253-
### HASP
254-
255-
The `data_available` function will need to be updated.
256-
257-
If you know of additional R package dependencies that will be affected by these changes, please email [email protected].
258-
259-
260-
261-

0 commit comments

Comments
 (0)