USGS dataretrieval Python Package Surface-Water `get_field_measurements()` Examples

This notebook provides examples of using the Python dataretrieval package to retrieve surface water field measurement data for a United States Geological Survey (USGS) monitoring location. The dataretrieval package provides a collection of functions to get data from the USGS Water Data API and other online sources of hydrology and water quality data.

Install the Package

Use the following code to install the package if it doesn’t exist already within your Jupyter Python environment.

[1]:

!pip install dataretrieval

Requirement already satisfied: dataretrieval in /opt/hostedtoolcache/Python/3.13.14/x64/lib/python3.13/site-packages (0.1.dev1+gd2920217d)
Requirement already satisfied: httpx in /opt/hostedtoolcache/Python/3.13.14/x64/lib/python3.13/site-packages (from dataretrieval) (0.28.1)
Requirement already satisfied: pandas<4.0.0,>=2.0.0 in /opt/hostedtoolcache/Python/3.13.14/x64/lib/python3.13/site-packages (from dataretrieval) (3.0.5)
Requirement already satisfied: anyio>=4.0 in /opt/hostedtoolcache/Python/3.13.14/x64/lib/python3.13/site-packages (from dataretrieval) (4.14.2)
Requirement already satisfied: numpy>=1.26.0 in /opt/hostedtoolcache/Python/3.13.14/x64/lib/python3.13/site-packages (from pandas<4.0.0,>=2.0.0->dataretrieval) (2.5.1)
Requirement already satisfied: python-dateutil>=2.8.2 in /opt/hostedtoolcache/Python/3.13.14/x64/lib/python3.13/site-packages (from pandas<4.0.0,>=2.0.0->dataretrieval) (2.9.0.post0)
Requirement already satisfied: idna>=2.8 in /opt/hostedtoolcache/Python/3.13.14/x64/lib/python3.13/site-packages (from anyio>=4.0->dataretrieval) (3.18)
Requirement already satisfied: six>=1.5 in /opt/hostedtoolcache/Python/3.13.14/x64/lib/python3.13/site-packages (from python-dateutil>=2.8.2->pandas<4.0.0,>=2.0.0->dataretrieval) (1.17.0)
Requirement already satisfied: certifi in /opt/hostedtoolcache/Python/3.13.14/x64/lib/python3.13/site-packages (from httpx->dataretrieval) (2026.7.22)
Requirement already satisfied: httpcore==1.* in /opt/hostedtoolcache/Python/3.13.14/x64/lib/python3.13/site-packages (from httpx->dataretrieval) (1.0.9)
Requirement already satisfied: h11>=0.16 in /opt/hostedtoolcache/Python/3.13.14/x64/lib/python3.13/site-packages (from httpcore==1.*->httpx->dataretrieval) (0.16.0)

Load the package so you can use it along with other packages used in this notebook.

[2]:

from IPython.display import display

import dataretrieval.waterdata as waterdata

Basic Usage

The dataretrieval package has several functions that allow you to retrieve data from the USGS Water Data API. This example uses the get_field_measurements() function to retrieve surface water field measurements for a USGS monitoring location. Field measurements are physically measured values (such as gage height and discharge) collected during a visit to a monitoring location, and are primarily used as calibration readings for the automated sensors collecting continuous data. The function accepts the following arguments (all optional):

monitoring_location_id (string or list of strings): A unique identifier representing a single monitoring location, formed by combining the responsible agency code with the location ID number, separated by a hyphen (e.g. USGS-10109000). A list may be supplied to query multiple locations.
parameter_code (string or list of strings): One or more 5-digit parameter codes identifying the constituent measured and its units of measure.
time (string): The date an observation represents. Accepts an RFC 3339 date-time, a bounded or half-bounded interval (e.g. 2019-01-01/2019-12-31 or 2019-01-01/..), or an ISO 8601 duration (e.g. P20Y for the past 20 years).
skip_geometry (boolean): If True, response geometries are omitted and a plain (non-spatial) data frame is returned.

Additional query parameters such as approval_status, qualifier, bbox, and limit are also supported; see the get_field_measurements() docstring for the full list.

Example 1: Get all of the field measurements for a single monitoring location

[3]:

measurements1 = waterdata.get_field_measurements(monitoring_location_id="USGS-10109000")
print("Retrieved " + str(len(measurements1[0])) + " data values.")

Retrieving: field-measurements · 1 page · 3,113 rows
No API key detected — register for higher rate limits at https://api.waterdata.usgs.gov/signup/

Retrieved 3113 data values.

Interpreting the Result

The get_field_measurements() function returns a tuple of two objects: a pandas data frame and an associated metadata object. The data frame is flat, uses a default integer index, and contains a time column holding the date of each measurement (along with columns such as monitoring_location_id, parameter_code, value, and unit_of_measure).

Once you’ve got the data frame, there are several useful things you can do to explore the data.

Display the data frame as a table

[4]:

display(measurements1[0])

	geometry	field_measurements_series_id	reading_type	field_visit_id	parameter_code	monitoring_location_id	observing_procedure_code	observing_procedure	value	unit_of_measure	...	approval_status	measuring_agency	last_modified	control_condition	measurement_rated	year	month	day	time_of_day	field_measurement_id
0	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	4cd21ba9-8644-ebfc-e053-0100007fd6db	00065	USGS-10109000	Z	None	0.94	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Excellent	1951	9	6	16:40:00+00:00	5cf271ea-cb01-49fc-b1a1-f485f5758bea
1	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	4cd21ba9-8644-ebfc-e053-0100007fd6db	00065	USGS-10109000	Z	Inside Legacy	0.94	ft	...	Provisional	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	1951	9	6	16:40:00+00:00	d72e4128-b007-44fb-9e62-f28a7b225aec
2	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	4cd21ba9-8644-ebfc-e053-0100007fd6db	00060	USGS-10109000	Z	Unspecified	17.00	ft^3/s	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Excellent	1951	9	6	16:40:00+00:00	ff504107-2468-4de0-8608-3ea14825d356
3	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	4cd21977-d55d-efa9-e053-0100007fcc60	00065	USGS-10109000	Z	None	0.88	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Unspecified	1951	12	13	19:10:00+00:00	103451ea-bf44-4d0f-b2cc-d67271c19924
4	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	4cd21977-d55d-efa9-e053-0100007fcc60	00065	USGS-10109000	Z	Inside Legacy	0.88	ft	...	Provisional	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	1951	12	13	19:10:00+00:00	17a6d438-9988-45ab-beba-8007822cb0d0
...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...
3108	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	20adb970-eb0a-4892-b5f2-92e7d1678b73	00065	USGS-10109000	Z	Gage height, electric tape	3.30	ft	...	Provisional	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2026	5	27	00:01:00+00:00	822916bd-1394-47a7-84ec-834b2e01472e
3109	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	cc75d459-38f9-4cf7-a9e7-df1df8e4cd8f	00065	USGS-10109000	Z	Gage height, electric tape	2.62	ft	...	Provisional	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2026	7	8	16:11:00+00:00	9938784f-a132-4824-a62e-d17a096e4dd0
3110	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	cc75d459-38f9-4cf7-a9e7-df1df8e4cd8f	00060	USGS-10109000	Z	Mid-section	105.00	ft^3/s	...	Provisional	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Fair	2026	7	8	17:16:42+00:00	d13b6f2e-882d-4489-91e8-f0229240fa05
3111	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	cc75d459-38f9-4cf7-a9e7-df1df8e4cd8f	00065	USGS-10109000	Z	None	2.60	ft	...	Provisional	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Fair	2026	7	8	17:16:42+00:00	f71fec14-a799-42e2-92f8-2c91d014e30b
3112	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	cc75d459-38f9-4cf7-a9e7-df1df8e4cd8f	00065	USGS-10109000	Z	Gage height, electric tape	2.58	ft	...	Provisional	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2026	7	8	17:50:00+00:00	ca796ce4-bb6c-4b7c-9c37-77e58284cbc5

3113 rows × 23 columns

Show the data types of the columns in the resulting data frame.

[5]:

print(measurements1[0].dtypes)

geometry                                   geometry
field_measurements_series_id                    str
reading_type                                    str
field_visit_id                                  str
parameter_code                                  str
monitoring_location_id                          str
observing_procedure_code                        str
observing_procedure                             str
value                                       float64
unit_of_measure                                 str
time                            datetime64[us, UTC]
qualifier                                    object
vertical_datum                                  str
approval_status                                 str
measuring_agency                                str
last_modified                   datetime64[us, UTC]
control_condition                               str
measurement_rated                               str
year                                          int64
month                                         int64
day                                           int64
time_of_day                                     str
field_measurement_id                            str
dtype: object

The other part of the result returned from the get_field_measurements() function is a metadata object that contains information about the query that was executed to return the data. For example, you can access the URL that was assembled to retrieve the requested data from the USGS Water Data API.

[6]:

print("The query URL used to retrieve the data from the Water Data API was: " + measurements1[1].url)

The query URL used to retrieve the data from the Water Data API was: https://api.waterdata.usgs.gov/ogcapi/v0/collections/field-measurements/items?monitoring_location_id=USGS-10109000&limit=50000

Additional Examples

Example 2: Get all of the field measurements between a start and end date

[7]:

measurements2 = waterdata.get_field_measurements(
    monitoring_location_id="USGS-10109000", time="2019-01-01/2019-12-31"
)
print("Retrieved " + str(len(measurements2[0])) + " data values.")
display(measurements2[0])

Retrieving: field-measurements · 1 page · 36 rows

Retrieved 36 data values.

	geometry	field_measurements_series_id	reading_type	field_visit_id	parameter_code	monitoring_location_id	observing_procedure_code	observing_procedure	value	unit_of_measure	...	approval_status	measuring_agency	last_modified	control_condition	measurement_rated	year	month	day	time_of_day	field_measurement_id
0	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	80a47f55-5d75-9c33-e053-0100007fa04d	00065	USGS-10109000	Z	Gage height, electric tape	2.40	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	1	29	19:24:00+00:00	aefdf4f5-514e-40d3-aa2f-2aba05892902
1	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	80a47f55-5d75-9c33-e053-0100007fa04d	00060	USGS-10109000	Z	Mid-section	83.80	ft^3/s	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Good	2019	1	29	19:57:30+00:00	4f69dc2b-db3a-4b55-810c-cbda6bee28f1
2	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	80a47f55-5d75-9c33-e053-0100007fa04d	00065	USGS-10109000	Z	None	2.43	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Good	2019	1	29	19:57:30+00:00	d87c5cbc-4c9f-4b9a-a745-eae9d3856478
3	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	80a47f55-5d75-9c33-e053-0100007fa04d	00065	USGS-10109000	Z	Gage height, electric tape	2.45	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	1	29	20:25:00+00:00	b6c6e320-c0e6-482d-b488-b29d34e53670
4	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	83ebd5c5-373c-5a52-e053-0100007f5e38	00065	USGS-10109000	Z	Gage height, electric tape	2.48	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	3	11	18:14:00+00:00	9ad4a309-ffc4-42b6-bcd8-0c2d7b852dc5
5	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	83ebd5c5-373c-5a52-e053-0100007f5e38	00065	USGS-10109000	Z	Gage height, electric tape	2.45	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	3	11	18:53:00+00:00	9de362eb-27c6-4edf-83e9-6bf85fcc9b1c
6	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	83ebd5c5-373c-5a52-e053-0100007f5e38	00065	USGS-10109000	Z	None	2.46	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Good	2019	3	11	19:29:30+00:00	4696b011-eafa-4ede-8783-b513e8626f9a
7	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	83ebd5c5-373c-5a52-e053-0100007f5e38	00060	USGS-10109000	Z	Mid-section	94.20	ft^3/s	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Good	2019	3	11	19:29:30+00:00	9cbb4662-e011-4267-9e14-d1f32e754b50
8	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	83ebd5c5-373c-5a52-e053-0100007f5e38	00065	USGS-10109000	Z	Gage height, electric tape	2.43	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	3	11	19:57:00+00:00	9e931fe2-5fc0-4e5d-b50d-14eb1f147df3
9	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	873f3a85-f698-41b8-e053-0100007fc351	00065	USGS-10109000	Z	Gage height, electric tape	3.29	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	4	23	20:55:00+00:00	98f96cd1-9aa7-44a9-a2f0-de3b9ccb2a99
10	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	873f3a85-f698-41b8-e053-0100007fc351	00060	USGS-10109000	Z	Acoustic Doppler Current Profiler	337.00	ft^3/s	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Good	2019	4	23	21:39:16+00:00	54b256ce-290b-41f7-81ef-b6655619639d
11	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	873f3a85-f698-41b8-e053-0100007fc351	00065	USGS-10109000	Z	None	3.29	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Good	2019	4	23	21:39:16+00:00	54c75751-cb91-4608-939f-2fbf0d626ae4
12	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	873f3a85-f698-41b8-e053-0100007fc351	00065	USGS-10109000	Z	Gage height, electric tape	3.29	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	4	23	22:03:00+00:00	40efe196-bf4e-456f-9a7b-dc17771945ea
13	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	8b3913bf-9253-4f4f-e053-0100007f3ec4	00065	USGS-10109000	Z	Gage height, electric tape	4.10	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	6	12	12:28:00+00:00	680718dd-684a-4d61-a499-dbc1cae986ec
14	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	8b3913bf-9253-4f4f-e053-0100007f3ec4	00060	USGS-10109000	Z	Mid-section	709.00	ft^3/s	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Good	2019	6	12	14:02:56+00:00	abe52809-14f2-485c-9f6b-4739e7f35510
15	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	8b3913bf-9253-4f4f-e053-0100007f3ec4	00065	USGS-10109000	Z	None	4.09	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Good	2019	6	12	14:02:56+00:00	e3519c82-c388-4cb4-8ce4-1bb33834ffe1
16	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	8b3913bf-9253-4f4f-e053-0100007f3ec4	00065	USGS-10109000	Z	Gage height, electric tape	4.09	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	6	12	14:53:00+00:00	c265af13-5fe5-4f60-926d-ac8446c2b3db
17	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	8ef1af85-190d-3d4c-e053-0100007f711a	00065	USGS-10109000	Z	Gage height, electric tape	2.84	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Vegetation - Light	NaN	2019	7	30	17:16:00+00:00	e7400afa-c7db-4f6f-9ce4-e3e2cf523b42
18	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	8ef1af85-190d-3d4c-e053-0100007f711a	00060	USGS-10109000	Z	Mid-section	167.00	ft^3/s	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Vegetation - Light	Good	2019	7	30	17:57:17+00:00	8a608621-af75-41ec-9512-d8c8fb12dc04
19	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	8ef1af85-190d-3d4c-e053-0100007f711a	00065	USGS-10109000	Z	None	2.84	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Vegetation - Light	Good	2019	7	30	17:57:17+00:00	e8fd6778-c5a3-48ec-93e1-8406bc9b3763
20	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	8ef1af85-190d-3d4c-e053-0100007f711a	00060	USGS-10109000	Z	Mid-section	162.00	ft^3/s	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Vegetation - Light	Good	2019	7	30	18:06:00+00:00	aa218499-94e0-44f1-8f1d-0f19eeb8ca1c
21	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	8ef1af85-190d-3d4c-e053-0100007f711a	00065	USGS-10109000	Z	None	2.84	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Vegetation - Light	Good	2019	7	30	18:06:00+00:00	e97ca8f2-6e43-4963-93bb-87fb021bc0a3
22	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	8ef1af85-190d-3d4c-e053-0100007f711a	00065	USGS-10109000	Z	Gage height, electric tape	2.84	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Vegetation - Light	NaN	2019	7	30	18:30:00+00:00	49e31349-7feb-439d-8925-72ba34a66e9b
23	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	92d627a0-a0f4-3689-e053-0100007f10f2	00065	USGS-10109000	Z	Gage height, electric tape	2.62	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Vegetation - Light	NaN	2019	9	16	16:04:00+00:00	dbb01a01-9af2-436c-b66e-4d57513a1043
24	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	92d627a0-a0f4-3689-e053-0100007f10f2	00065	USGS-10109000	Z	None	2.64	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Vegetation - Light	Good	2019	9	16	16:59:19+00:00	418834de-eaf4-41b6-84c0-4e8ae396caa8
25	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	92d627a0-a0f4-3689-e053-0100007f10f2	00060	USGS-10109000	Z	Mid-section	126.00	ft^3/s	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Vegetation - Light	Good	2019	9	16	16:59:19+00:00	bb7ec85e-1960-47a8-a1b2-6e919b93e7f3
26	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	92d627a0-a0f4-3689-e053-0100007f10f2	00065	USGS-10109000	Z	Gage height, electric tape	2.67	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Vegetation - Light	NaN	2019	9	16	17:33:00+00:00	00f2bf4f-da9b-4086-b1d4-2fdf4655d821
27	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	9603d708-a28c-04b1-e053-0100007f2a41	00065	USGS-10109000	Z	Gage height, electric tape	2.64	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	10	28	18:46:00+00:00	ab9e80e4-a7c6-47f3-bf92-c5f0b5a57258
28	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	9603d708-a28c-04b1-e053-0100007f2a41	00065	USGS-10109000	Z	Gage height, electric tape	2.66	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	10	28	18:50:00+00:00	d003c651-d90f-4851-8503-577160d070f1
29	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	9603d708-a28c-04b1-e053-0100007f2a41	00065	USGS-10109000	Z	None	2.64	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Good	2019	10	28	19:06:42+00:00	2c2c7e19-d26b-4ed5-8a26-d32176d527d5
30	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	9603d708-a28c-04b1-e053-0100007f2a41	00060	USGS-10109000	Z	Mid-section	133.00	ft^3/s	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Good	2019	10	28	19:06:42+00:00	b399c235-b678-48be-9236-846aca38f328
31	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	9603d708-a28c-04b1-e053-0100007f2a41	00065	USGS-10109000	Z	Gage height, electric tape	2.63	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	10	28	21:15:00+00:00	0b4948c2-19e0-4259-9293-416e3647b3a3
32	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	92b3d616-e8fb-4f7f-862d-632f6ad1c26b	00065	USGS-10109000	Z	Gage height, wire weight gage	2.59	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	12	3	20:07:00+00:00	04c2388f-c2c2-44e5-ab7a-e0db9f6e399d
33	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	92b3d616-e8fb-4f7f-862d-632f6ad1c26b	00065	USGS-10109000	Z	None	2.60	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Good	2019	12	3	20:53:15+00:00	5a4ffc89-a99d-470f-89e3-ee232aef88e3
34	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	92b3d616-e8fb-4f7f-862d-632f6ad1c26b	00060	USGS-10109000	Z	Mid-section	122.00	ft^3/s	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	Good	2019	12	3	20:53:15+00:00	a82ce978-9bba-4e8b-81c3-098505bd0a96
35	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	92b3d616-e8fb-4f7f-862d-632f6ad1c26b	00065	USGS-10109000	Z	Gage height, wire weight gage	2.61	ft	...	Approved	USGS	2026-07-09 23:10:27.190233+00:00	Clear	NaN	2019	12	3	21:17:00+00:00	31e23e95-9574-4586-8b54-0e5c3961a8e9

36 rows × 23 columns

Example 3: Get all of the field measurements for multiple monitoring locations

[8]:

measurements3 = waterdata.get_field_measurements(monitoring_location_id=["USGS-01594440", "USGS-040851325"])
print("Retrieved " + str(len(measurements3[0])) + " data values.")
display(measurements3[0])

Retrieving: field-measurements · 1 page · 1,553 rows

Retrieved 1553 data values.

	geometry	field_measurements_series_id	reading_type	field_visit_id	parameter_code	monitoring_location_id	observing_procedure_code	observing_procedure	value	unit_of_measure	...	approval_status	measuring_agency	last_modified	control_condition	measurement_rated	year	month	day	time_of_day	field_measurement_id
0	POINT (-76.69369 38.95592)	10f75368-e5d4-4b6a-a4a7-ec3f00f906b7	MeanGageHeight	53fb2a20-7b79-4148-e053-0100007f46df	00065	USGS-01594440	Z	None	3.11	ft	...	Approved	USGS	2026-07-18 02:11:32.811129+00:00	Clear	Good	1955	4	7	19:05:00+00:00	14fdb8ed-911a-4076-a86b-89077e1987da
1	POINT (-76.69369 38.95592)	af34921e-31ca-46f0-afad-731e7ab10cae	Discharge	53fb2a20-7b79-4148-e053-0100007f46df	00060	USGS-01594440	Z	Unspecified	152.00	ft^3/s	...	Approved	USGS	2026-07-18 02:11:32.811129+00:00	Clear	Good	1955	4	7	19:05:00+00:00	53901a2c-e31e-4a59-8103-85cf6199837b
2	POINT (-76.69369 38.95592)	a44e8e21-143d-4afc-853a-f06c59e6e06a	ReferencePrimary	53fb2a20-7b79-4148-e053-0100007f46df	00065	USGS-01594440	Z	Outside Legacy	3.11	ft	...	Provisional	USGS	2026-07-18 02:11:32.811129+00:00	Clear	NaN	1955	4	7	19:05:00+00:00	b08dc86a-bc74-442d-9378-a285aecc638a
3	POINT (-76.69369 38.95592)	a44e8e21-143d-4afc-853a-f06c59e6e06a	ReferencePrimary	53fb2518-fafa-3f15-e053-0100007fbbce	00065	USGS-01594440	Z	Outside Legacy	2.76	ft	...	Provisional	USGS	2026-07-18 02:11:32.811129+00:00	Clear	NaN	1955	5	4	21:05:00+00:00	cec502aa-ec0f-40bb-88d2-3cb4c0031b9f
4	POINT (-76.69369 38.95592)	af34921e-31ca-46f0-afad-731e7ab10cae	Discharge	53fb2518-fafa-3f15-e053-0100007fbbce	00060	USGS-01594440	Z	Unspecified	127.00	ft^3/s	...	Approved	USGS	2026-07-18 02:11:32.811129+00:00	Clear	Fair	1955	5	4	21:05:00+00:00	ee54a804-9f79-43ff-93b1-ab8c53c0d3d8
...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...
1548	POINT (-76.69369 38.95592)	a44e8e21-143d-4afc-853a-f06c59e6e06a	ReferencePrimary	0f32679d-5358-4d28-9ed9-6900c09f1b81	00065	USGS-01594440	Z	Gage height, wire weight gage	4.26	ft	...	Provisional	USGS	2026-07-18 02:11:32.811129+00:00	Clear	NaN	2026	6	10	18:40:00+00:00	1bbfec30-403b-4b10-8f1a-64e1b275afde
1549	POINT (-76.69369 38.95592)	a44e8e21-143d-4afc-853a-f06c59e6e06a	ReferencePrimary	48037f4f-d8c4-4636-a28c-cb7238bccdc3	00065	USGS-01594440	Z	Gage height, wire weight gage	4.60	ft	...	Provisional	USGS	2026-07-18 02:11:32.811129+00:00	Clear	NaN	2026	6	29	12:35:00+00:00	498bafc4-82db-494a-bbe6-70284c3db583
1550	POINT (-76.69369 38.95592)	af34921e-31ca-46f0-afad-731e7ab10cae	Discharge	48037f4f-d8c4-4636-a28c-cb7238bccdc3	00060	USGS-01594440	Z	Acoustic Doppler Current Profiler	169.00	ft^3/s	...	Provisional	USGS	2026-07-18 02:11:32.811129+00:00	Clear	Good	2026	6	29	13:50:34+00:00	1573dc4b-8677-48ae-9ab7-b8e63901ae54
1551	POINT (-76.69369 38.95592)	10f75368-e5d4-4b6a-a4a7-ec3f00f906b7	MeanGageHeight	48037f4f-d8c4-4636-a28c-cb7238bccdc3	00065	USGS-01594440	Z	None	4.57	ft	...	Provisional	USGS	2026-07-18 02:11:32.811129+00:00	Clear	Good	2026	6	29	13:50:34+00:00	63705ffa-9a88-4138-a0de-d0a8cc9d4087
1552	POINT (-76.69369 38.95592)	a44e8e21-143d-4afc-853a-f06c59e6e06a	ReferencePrimary	48037f4f-d8c4-4636-a28c-cb7238bccdc3	00065	USGS-01594440	Z	Gage height, wire weight gage	4.56	ft	...	Provisional	USGS	2026-07-18 02:11:32.811129+00:00	Clear	NaN	2026	6	29	14:23:00+00:00	19014abd-9999-49cb-a544-56f4740db6b8

1553 rows × 23 columns

USGS dataretrieval Python Package Surface-Water get_field_measurements() Examples

Install the Package

Basic Usage

Interpreting the Result

Additional Examples

USGS dataretrieval Python Package Surface-Water `get_field_measurements()` Examples