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.

!pip install dataretrieval

Requirement already satisfied: dataretrieval in /opt/hostedtoolcache/Python/3.13.17/x64/lib/python3.13/site-packages (0.1.dev1+g2846fff54)
Requirement already satisfied: httpx in /opt/hostedtoolcache/Python/3.13.17/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.17/x64/lib/python3.13/site-packages (from dataretrieval) (3.1.0)
Requirement already satisfied: anyio>=4.0 in /opt/hostedtoolcache/Python/3.13.17/x64/lib/python3.13/site-packages (from dataretrieval) (4.15.1)
Requirement already satisfied: numpy>=2.0.2 in /opt/hostedtoolcache/Python/3.13.17/x64/lib/python3.13/site-packages (from pandas<4.0.0,>=2.0.0->dataretrieval) (2.5.4)
Requirement already satisfied: python-dateutil>=2.9.0 in /opt/hostedtoolcache/Python/3.13.17/x64/lib/python3.13/site-packages (from pandas<4.0.0,>=2.0.0->dataretrieval) (3.0.0)
Requirement already satisfied: idna>=2.8 in /opt/hostedtoolcache/Python/3.13.17/x64/lib/python3.13/site-packages (from anyio>=4.0->dataretrieval) (3.20)
Requirement already satisfied: typing_extensions>=4.16.0 in /opt/hostedtoolcache/Python/3.13.17/x64/lib/python3.13/site-packages (from anyio>=4.0->dataretrieval) (4.16.0)
Requirement already satisfied: six>=1.6 in /opt/hostedtoolcache/Python/3.13.17/x64/lib/python3.13/site-packages (from python-dateutil>=2.9.0->pandas<4.0.0,>=2.0.0->dataretrieval) (1.17.0)
Requirement already satisfied: tzdata in /opt/hostedtoolcache/Python/3.13.17/x64/lib/python3.13/site-packages (from python-dateutil>=2.9.0->pandas<4.0.0,>=2.0.0->dataretrieval) (2026.6)
Requirement already satisfied: certifi in /opt/hostedtoolcache/Python/3.13.17/x64/lib/python3.13/site-packages (from httpx->dataretrieval) (2026.10.23)
Requirement already satisfied: httpcore==1.* in /opt/hostedtoolcache/Python/3.13.17/x64/lib/python3.13/site-packages (from httpx->dataretrieval) (1.0.9)
Requirement already satisfied: h11>=0.16 in /opt/hostedtoolcache/Python/3.13.17/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.

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

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

Retrieving: field-measurements · 1 page · 2,122 rows

Retrieved 2122 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

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	...	measuring_agency	last_modified	control_condition	measurement_rated	year	month	day	time_of_day	sublocation_identifier	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Excellent	1951	9	6	16:40:00+00:00	None	c9a12e12-017e-4476-9494-5cb214a40190
1	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Excellent	1951	9	6	16:40:00+00:00	None	ef371f5e-95c4-43a7-892d-0f0405eb2a43
2	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	4cd21977-d55d-efa9-e053-0100007fcc60	00065	USGS-10109000	Z	None	0.88	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Unspecified	1951	12	13	19:10:00+00:00	None	266a42f6-6334-4185-a12d-faec34d7bd61
3	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	4cd21977-d55d-efa9-e053-0100007fcc60	00060	USGS-10109000	Z	Unspecified	12.50	ft^3/s	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Unspecified	1951	12	13	19:10:00+00:00	None	70c1b382-275e-4b1a-a156-07c6e072bbe6
4	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	4cd21ba9-8645-ebfc-e053-0100007fd6db	00060	USGS-10109000	Z	Unspecified	203.00	ft^3/s	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Good	1952	4	23	17:25:00+00:00	None	da8b9669-19bf-44bf-bd4b-e6e0c49bbbbc
...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...
2117	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	81ec542f-e280-4f87-b882-b9e2ddaa44ab	00065	USGS-10109000	Z	Gage height, electric tape	2.60	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2026	10	14	21:15:00+00:00	None	032fc9af-5345-4a0f-bb99-5e25d38f8057
2118	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	81ec542f-e280-4f87-b882-b9e2ddaa44ab	00065	USGS-10109000	Z	Gage height, electric tape	2.60	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2026	10	14	22:15:00+00:00	None	179961e5-87c6-43ff-8f51-c3c1ee8d8d41
2119	POINT (-111.78398 41.74355)	7d5b4004-ca7e-46c5-9bde-25d5dde481c8	Discharge	81ec542f-e280-4f87-b882-b9e2ddaa44ab	00060	USGS-10109000	Z	Acoustic Doppler Current Profiler	97.00	ft^3/s	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Fair	2026	10	14	21:49:11+00:00	None	5d715cbc-3b15-47a0-bf22-12eae3cd8d49
2120	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	81ec542f-e280-4f87-b882-b9e2ddaa44ab	00065	USGS-10109000	Z	None	2.60	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Fair	2026	10	14	21:49:11+00:00	None	80390714-9770-4228-831a-1e17e9e82a76
2121	POINT (-111.78398 41.74355)	4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7	ReferencePrimary	81ec542f-e280-4f87-b882-b9e2ddaa44ab	00065	USGS-10109000	Z	Gage height, staff gage	2.60	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2026	10	14	21:15:00+00:00	None	df87a8da-fbd9-4d14-a810-75e4d9ba6650

2122 rows × 24 columns

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

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]
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
sublocation_identifier                       object
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.

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/v1/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

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	...	measuring_agency	last_modified	control_condition	measurement_rated	year	month	day	time_of_day	sublocation_identifier	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.45	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	1	29	20:25:00+00:00	None	15b56635-ab85-4d43-b955-36c2c3d292ff
1	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	1	29	19:24:00+00:00	None	497308e2-9d46-454c-8399-0866df154200
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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Good	2019	1	29	19:57:30+00:00	None	c2c299cc-cd3c-4e7f-8d2c-1b7b24e68d74
3	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Good	2019	1	29	19:57:30+00:00	None	e2ec769d-7ccf-473a-8af6-1cdf252d24cf
4	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	83ebd5c5-373c-5a52-e053-0100007f5e38	00065	USGS-10109000	Z	None	2.46	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Good	2019	3	11	19:29:30+00:00	None	190089f5-905c-44e8-88a1-3ccf776fef77
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.43	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	3	11	19:57:00+00:00	None	4b2a38c5-cf0a-47f3-9e52-43537f7d17ef
6	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	3	11	18:53:00+00:00	None	74d9a360-8b1d-4cd0-8ed0-5198d27dea1f
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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Good	2019	3	11	19:29:30+00:00	None	b88680a4-f015-4527-80d6-003d6c6ab780
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.48	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	3	11	18:14:00+00:00	None	beec85ed-2f82-462b-bac2-83add979a868
9	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	873f3a85-f698-41b8-e053-0100007fc351	00065	USGS-10109000	Z	None	3.29	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Good	2019	4	23	21:39:16+00:00	None	466e05f5-2793-4b6d-8904-9d5be1779b5a
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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Good	2019	4	23	21:39:16+00:00	None	767943c8-3c9c-44e5-8e04-38c368a355f4
11	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	4	23	20:55:00+00:00	None	d2e2cc46-f9f1-458f-85f9-9f2ce7fd0f47
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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	4	23	22:03:00+00:00	None	dfccd819-8c48-494c-b2b8-e296f3aa61c3
13	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	8b3913bf-9253-4f4f-e053-0100007f3ec4	00065	USGS-10109000	Z	None	4.09	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Good	2019	6	12	14:02:56+00:00	None	1d14c08a-4ede-4c35-92c6-f10e642e4b83
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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Good	2019	6	12	14:02:56+00:00	None	69b65c4e-0f5e-4360-9f8d-6bc343bae0ed
15	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	6	12	14:53:00+00:00	None	91611035-7905-415d-87aa-3a086b7c847b
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.10	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	6	12	12:28:00+00:00	None	e771d06e-5d2e-4939-a947-b69a990235df
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	...	USGS	2026-10-25 02:37:42.465113+00:00	Vegetation - Light	NaN	2019	7	30	18:30:00+00:00	None	2748d847-3ba4-4dad-b63c-adbaaf5c3761
18	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	8ef1af85-190d-3d4c-e053-0100007f711a	00065	USGS-10109000	Z	None	2.84	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Vegetation - Light	Good	2019	7	30	17:57:17+00:00	None	2b5aae4d-a3a0-4c5a-afb2-bc4e298396d5
19	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Vegetation - Light	Good	2019	7	30	17:57:17+00:00	None	33033917-6f90-4f3e-a71d-dda0e4b7efa1
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	...	USGS	2026-10-25 02:37:42.465113+00:00	Vegetation - Light	Good	2019	7	30	18:06:00+00:00	None	d1600405-b68c-4d17-94c5-efdbd79132a6
21	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Vegetation - Light	NaN	2019	7	30	17:16:00+00:00	None	d52a8128-e2d2-42a5-9b38-3d64ee3b0432
22	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	8ef1af85-190d-3d4c-e053-0100007f711a	00065	USGS-10109000	Z	None	2.84	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Vegetation - Light	Good	2019	7	30	18:06:00+00:00	None	d5c43e81-78b4-4a28-ab11-1c1fcb49f639
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.67	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Vegetation - Light	NaN	2019	9	16	17:33:00+00:00	None	1fb3468f-d325-4c3e-99f7-e80600940bc5
24	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Vegetation - Light	NaN	2019	9	16	16:04:00+00:00	None	69cdee6f-aa10-44d1-a1cb-95cdd5e80bbc
25	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	92d627a0-a0f4-3689-e053-0100007f10f2	00065	USGS-10109000	Z	None	2.64	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Vegetation - Light	Good	2019	9	16	16:59:19+00:00	None	a10c300a-d759-45a3-abcb-c55034af3db6
26	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Vegetation - Light	Good	2019	9	16	16:59:19+00:00	None	ab04f9d4-64ad-47e3-be47-43559af8647a
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.66	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	10	28	18:50:00+00:00	None	5bcff1dc-110a-46cc-8a53-384637f9e575
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.64	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	10	28	18:46:00+00:00	None	70a407e3-e2af-4f7d-8557-8f18bb982c28
29	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	10	28	21:15:00+00:00	None	713678b4-7fcf-467c-99bb-c62fff4b97e3
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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Good	2019	10	28	19:06:42+00:00	None	7c459adb-f5a9-4d8e-b7a2-a427fe7f388e
31	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	9603d708-a28c-04b1-e053-0100007f2a41	00065	USGS-10109000	Z	None	2.64	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Good	2019	10	28	19:06:42+00:00	None	9cf0670f-93b7-4f3e-b155-b06c048c4d05
32	POINT (-111.78398 41.74355)	442c040d-8a0f-43e8-b4c7-840b2a60a89a	MeanGageHeight	92b3d616-e8fb-4f7f-862d-632f6ad1c26b	00065	USGS-10109000	Z	None	2.60	ft	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Good	2019	12	3	20:53:15+00:00	None	1d4a1c8b-d712-488c-9f04-37813fe5fa62
33	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	12	3	21:17:00+00:00	None	9638c46d-1d31-438e-94b8-258eca22c82c
34	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	NaN	2019	12	3	20:07:00+00:00	None	c45b67b0-1149-4952-bd9b-24174e035cbc
35	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	...	USGS	2026-10-25 02:37:42.465113+00:00	Clear	Good	2019	12	3	20:53:15+00:00	None	d390f1b7-decd-4f91-89e2-e447a8598266

36 rows × 24 columns

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

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,016 rows
No API key detected — register for higher rate limits at https://api.waterdata.usgs.gov/signup/

Retrieved 1016 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	...	measuring_agency	last_modified	control_condition	measurement_rated	year	month	day	time_of_day	sublocation_identifier	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	...	USGS	2026-10-17 02:44:54.980894+00:00	Clear	Good	1955	4	7	19:05:00+00:00	None	3b9f60fb-7576-4b1d-8d18-d7e99f96ec4d
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	...	USGS	2026-10-17 02:44:54.980894+00:00	Clear	Good	1955	4	7	19:05:00+00:00	None	e3b96c67-7a53-4d02-b150-67f7458a996e
2	POINT (-76.69369 38.95592)	10f75368-e5d4-4b6a-a4a7-ec3f00f906b7	MeanGageHeight	53fb2518-fafa-3f15-e053-0100007fbbce	00065	USGS-01594440	Z	None	2.76	ft	...	USGS	2026-10-17 02:44:54.980894+00:00	Clear	Fair	1955	5	4	21:05:00+00:00	None	c72283c5-fb5f-4762-b3b1-794a81607d47
3	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	...	USGS	2026-10-17 02:44:54.980894+00:00	Clear	Fair	1955	5	4	21:05:00+00:00	None	f7bc2ce9-4ef3-4b27-9173-ab2c9f2aa84f
4	POINT (-76.69369 38.95592)	af34921e-31ca-46f0-afad-731e7ab10cae	Discharge	53fb2a2a-6d26-3f11-e053-0100007f0ef5	00060	USGS-01594440	Z	Unspecified	310.00	ft^3/s	...	USGS	2026-10-17 02:44:54.980894+00:00	Clear	Good	1955	6	10	13:35:00+00:00	None	45400c99-cd9c-43cf-803c-664257031551
...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...
1011	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	...	USGS	2026-10-17 02:44:54.980894+00:00	Clear	NaN	2026	6	29	14:23:00+00:00	None	dd4fdbdf-5797-4a4c-8ce2-890b99853e6b
1012	POINT (-76.69369 38.95592)	af34921e-31ca-46f0-afad-731e7ab10cae	Discharge	e7e66c91-9a4f-49db-8ad2-1182467dd22f	00060	USGS-01594440	Z	Acoustic Doppler Current Profiler	82.50	ft^3/s	...	USGS	2026-10-17 02:44:54.980894+00:00	Clear	Fair	2026	9	17	14:12:01+00:00	None	0da3b279-e785-463d-88ba-415a320d5667
1013	POINT (-76.69369 38.95592)	10f75368-e5d4-4b6a-a4a7-ec3f00f906b7	MeanGageHeight	e7e66c91-9a4f-49db-8ad2-1182467dd22f	00065	USGS-01594440	Z	None	3.95	ft	...	USGS	2026-10-17 02:44:54.980894+00:00	Clear	Fair	2026	9	17	14:12:01+00:00	None	391cccf2-e396-4055-a3af-473d2df28ca8
1014	POINT (-76.69369 38.95592)	a44e8e21-143d-4afc-853a-f06c59e6e06a	ReferencePrimary	e7e66c91-9a4f-49db-8ad2-1182467dd22f	00065	USGS-01594440	Z	Gage height, wire weight gage	3.96	ft	...	USGS	2026-10-17 02:44:54.980894+00:00	Clear	NaN	2026	9	17	13:22:00+00:00	None	428e1684-7906-4d4f-ab8c-9c717f8b9736
1015	POINT (-76.69369 38.95592)	a44e8e21-143d-4afc-853a-f06c59e6e06a	ReferencePrimary	e7e66c91-9a4f-49db-8ad2-1182467dd22f	00065	USGS-01594440	Z	Gage height, wire weight gage	3.95	ft	...	USGS	2026-10-17 02:44:54.980894+00:00	Clear	NaN	2026	9	17	14:38:00+00:00	None	bd2aa5f8-7a73-4978-9fac-f03a9c7fd22f

1016 rows × 24 columns