V1

[ldecicco-USGS]

Let's get v1 ready to roll as soon as the announcement comes out.

[ldecicco-USGS]

So if needed, it reverts to v0, and then on.exit goes back to v1.

And in this screenshot, a user can specify v0 if they need to:

[ehinman]

I will review by the end of the week, thanks!

[ehinman]

Move these to the bottom, just above the dot dot dots?

[ehinman]

I need help understanding something. Are begin and end automatically converted to UTC?

I decided to try using an offset to pull data:

cont <- read_waterdata_continuous(monitoring_location_id = "USGS-07227500", time = "2026-09-04T13:00:00-05:00/..")

This pulled several records with the time column being in UTC (so time values ranging from 18:00 to 19:45 as of this writing, which makes sense)

I then tried this same offset in ts_meta and nothing came back:

ts <- read_waterdata_ts_meta(monitoring_location_id = "USGS-07227500", end = "2026-09-04T13:00:00-05:00/..")

Am I misunderstanding something? Related: I did a quick search for an example using a time offset and didn't see one for the water data APIs. I think this would be helpful.

[ehinman]

Maybe @mikemahoney218-usgs has more details on this ^^ or where I'm going wrong.

[mikemahoney218-usgs]

The time series metadata endpoint only updates once per day, so it generally won't have the most up-to-date information on when the most recent record is from

[ehinman]

Is there a planned date for when they'll be removed entirely? If we have a date, might be handy to put here.

[mikemahoney218-usgs]

~June, but I'm trying to thread the needle of not freaking people out about V0 (which is mostly a non-event) before WaterServices is decommissioned (which is a much bigger event) -- so we haven't announced more specifics than that yet. (I also haven't thought about it a ton yet, either)

[ehinman]

These changes look good @ldecicco-USGS. I ran some tests on them and the warnings popped up as expected with helpful information. My only optional suggestion is to move the state_name, begin_utc and end_utc inputs to the bottom of the list, so that they're less obvious.