You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: vignettes/Status.Rmd
+14-15Lines changed: 14 additions & 15 deletions
Original file line number
Diff line number
Diff line change
@@ -25,6 +25,20 @@ On March 11, 2024, NWIS **discrete water quality** services were "frozen": any p
25
25
26
26
If you have additional questions about the NWIS qw data service, email [email protected].
27
27
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>
28
42
29
43
## Locating USGS data using the Water Quality Portal
30
44
@@ -244,18 +258,3 @@ So for site "05114000", there are 381 NWIS qw parameters that have been measured
244
258
New services/functions are being developed to replace the lost functionality so check back here for updated information.
245
259
246
260
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].
0 commit comments