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.18/x64/lib/python3.13/site-packages (0.1.dev1+g55e94617b)
Requirement already satisfied: httpx in /opt/hostedtoolcache/Python/3.13.18/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.18/x64/lib/python3.13/site-packages (from dataretrieval) (3.1.1)
Requirement already satisfied: anyio>=4.0 in /opt/hostedtoolcache/Python/3.13.18/x64/lib/python3.13/site-packages (from dataretrieval) (4.16.0)
Requirement already satisfied: numpy>=2.0.2 in /opt/hostedtoolcache/Python/3.13.18/x64/lib/python3.13/site-packages (from pandas<4.0.0,>=2.0.0->dataretrieval) (2.5.5)
Requirement already satisfied: python-dateutil>=2.9.0 in /opt/hostedtoolcache/Python/3.13.18/x64/lib/python3.13/site-packages (from pandas<4.0.0,>=2.0.0->dataretrieval) (4.0.0)
Requirement already satisfied: idna>=2.8 in /opt/hostedtoolcache/Python/3.13.18/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.18/x64/lib/python3.13/site-packages (from anyio>=4.0->dataretrieval) (4.16.0)
Requirement already satisfied: tzdata in /opt/hostedtoolcache/Python/3.13.18/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.18/x64/lib/python3.13/site-packages (from httpx->dataretrieval) (2026.10.23)
Requirement already satisfied: httpcore==1.* in /opt/hostedtoolcache/Python/3.13.18/x64/lib/python3.13/site-packages (from httpx->dataretrieval) (1.0.9)
Requirement already satisfied: h11>=0.16 in /opt/hostedtoolcache/Python/3.13.18/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 · 2,121 rows
Retrieved 2121 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 ... 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) 7d5b4004-ca7e-46c5-9bde-25d5dde481c8 Discharge 4cd21ba9-8644-ebfc-e053-0100007fd6db 00060 USGS-10109000 Z Unspecified 17.00 ft^3/s ... USGS 2026-10-29 17:20:18.940117+00:00 Clear Excellent 1951 9 6 16:40:00+00:00 None 58fcb758-4232-4869-8071-5628462805a8
1 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-29 17:20:18.940117+00:00 Clear Excellent 1951 9 6 16:40:00+00:00 None e5f0c603-7fc6-4e1a-a076-7f01c3a2c883
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-29 17:20:18.940117+00:00 Clear Unspecified 1951 12 13 19:10:00+00:00 None 8234d5e5-29ae-417a-bc54-45acca5a89bd
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-29 17:20:18.940117+00:00 Clear Unspecified 1951 12 13 19:10:00+00:00 None a03d2c5c-f98a-42ab-b487-b95bfcb36609
4 POINT (-111.78398 41.74355) 442c040d-8a0f-43e8-b4c7-840b2a60a89a MeanGageHeight 4cd21ba9-8645-ebfc-e053-0100007fd6db 00065 USGS-10109000 Z None 1.80 ft ... USGS 2026-10-29 17:20:18.940117+00:00 Clear Good 1952 4 23 17:25:00+00:00 None c022e050-a8b9-48de-b62d-ae0f3d3df130
... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ...
2116 POINT (-111.78398 41.74355) 4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7 ReferencePrimary 6caa9af4-cc49-4968-9f1e-601b1c861fb7 00065 USGS-10109000 Z Gage height, electric tape 2.41 ft ... USGS 2026-10-29 17:20:18.940117+00:00 Clear NaN 2026 9 8 23:05:00+00:00 None c15bb7bf-c931-47b0-81bb-6c290b6e096a
2117 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-29 17:20:18.940117+00:00 Clear Fair 2026 10 14 21:49:11+00:00 None 353a4128-b2a3-4cda-a9c8-a290166e71d5
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-29 17:20:18.940117+00:00 Clear NaN 2026 10 14 22:15:00+00:00 None 50ac8dd8-b708-4d0c-a1af-cc215a48871a
2119 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-29 17:20:18.940117+00:00 Clear NaN 2026 10 14 21:15:00+00:00 None 73654d49-e498-489e-82c3-99a240a12751
2120 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-29 17:20:18.940117+00:00 Clear Fair 2026 10 14 21:49:11+00:00 None c8d185e6-1f84-4be0-b4db-2d23953eeca6

2121 rows × 24 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]
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.

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

[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 ... 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.40 ft ... USGS 2026-10-29 17:20:18.940117+00:00 Clear NaN 2019 1 29 19:24:00+00:00 None 113743b5-cfa7-4c34-9268-16037ed9c7d2
1 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-29 17:20:18.940117+00:00 Clear Good 2019 1 29 19:57:30+00:00 None 3e3c6da4-c901-4879-899d-df9f04081751
2 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-29 17:20:18.940117+00:00 Clear NaN 2019 1 29 20:25:00+00:00 None 4c136f0e-9b50-4311-8534-aa077950b4a7
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-29 17:20:18.940117+00:00 Clear Good 2019 1 29 19:57:30+00:00 None 5be0c263-afd9-4f33-8407-ec3d00b92341
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.45 ft ... USGS 2026-10-29 17:20:18.940117+00:00 Clear NaN 2019 3 11 18:53:00+00:00 None 2f883a63-9a7a-4ced-a574-ca214af78920
5 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-29 17:20:18.940117+00:00 Clear Good 2019 3 11 19:29:30+00:00 None 78544191-f015-448d-8d29-f431c818274f
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.48 ft ... USGS 2026-10-29 17:20:18.940117+00:00 Clear NaN 2019 3 11 18:14:00+00:00 None c7f699b2-b3e7-4a70-bca5-d7121a2ad128
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-29 17:20:18.940117+00:00 Clear Good 2019 3 11 19:29:30+00:00 None c9e0b116-faae-4202-bb74-cb25f878285e
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 ... USGS 2026-10-29 17:20:18.940117+00:00 Clear NaN 2019 3 11 19:57:00+00:00 None d4b3b070-61c4-4ed8-a3f8-8cd2606b88d4
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 ... USGS 2026-10-29 17:20:18.940117+00:00 Clear NaN 2019 4 23 22:03:00+00:00 None 4d80dc63-2241-45aa-a4d6-2ba6f48434dd
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-29 17:20:18.940117+00:00 Clear Good 2019 4 23 21:39:16+00:00 None abbf3aa2-fd93-4ac0-accf-81a5a58c3315
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-29 17:20:18.940117+00:00 Clear NaN 2019 4 23 20:55:00+00:00 None b4af0d23-db0d-472c-ac99-9d91b782fe2e
12 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-29 17:20:18.940117+00:00 Clear Good 2019 4 23 21:39:16+00:00 None da223bf1-2be7-4af1-8781-a30affc8d6db
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 ... USGS 2026-10-29 17:20:18.940117+00:00 Clear NaN 2019 6 12 12:28:00+00:00 None 955a5b5c-345b-4125-9b59-c6b26808cf33
14 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-29 17:20:18.940117+00:00 Clear Good 2019 6 12 14:02:56+00:00 None c25758e3-9b6f-456c-8988-cf9126c12607
15 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-29 17:20:18.940117+00:00 Clear Good 2019 6 12 14:02:56+00:00 None ecce927a-0746-4252-8e69-d221534c343d
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 ... USGS 2026-10-29 17:20:18.940117+00:00 Clear NaN 2019 6 12 14:53:00+00:00 None ed41e5a2-b58b-477a-8da8-5bf474698dd4
17 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-29 17:20:18.940117+00:00 Vegetation - Light Good 2019 7 30 18:06:00+00:00 None 3929eef9-84d5-4032-a1e1-10858b9590ee
18 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-29 17:20:18.940117+00:00 Vegetation - Light NaN 2019 7 30 18:30:00+00:00 None 3f5e0d5c-0a71-4c3b-8c6a-67054203d532
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 ... USGS 2026-10-29 17:20:18.940117+00:00 Vegetation - Light Good 2019 7 30 18:06:00+00:00 None 5ceed4fd-21e4-4c5f-a220-f98c8bb0ae7f
20 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-29 17:20:18.940117+00:00 Vegetation - Light NaN 2019 7 30 17:16:00+00:00 None 5db2663c-6506-4b56-b6dd-637e79055877
21 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-29 17:20:18.940117+00:00 Vegetation - Light Good 2019 7 30 17:57:17+00:00 None e22ab98b-2d97-42de-b978-a82b9f6cb012
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-29 17:20:18.940117+00:00 Vegetation - Light Good 2019 7 30 17:57:17+00:00 None eb238623-2d43-4d65-9495-18a81ba796cc
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-29 17:20:18.940117+00:00 Vegetation - Light NaN 2019 9 16 17:33:00+00:00 None 20541ce6-8906-4bac-90f5-57ec7d89d5a9
24 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-29 17:20:18.940117+00:00 Vegetation - Light Good 2019 9 16 16:59:19+00:00 None 9304d0f4-2e54-4425-978b-688b2d0949f1
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-29 17:20:18.940117+00:00 Vegetation - Light Good 2019 9 16 16:59:19+00:00 None c14adc96-c6e3-4548-a816-91419b983d5a
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.62 ft ... USGS 2026-10-29 17:20:18.940117+00:00 Vegetation - Light NaN 2019 9 16 16:04:00+00:00 None cad60ab6-a273-4ea6-b1f6-29211659eb85
27 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-29 17:20:18.940117+00:00 Clear Good 2019 10 28 19:06:42+00:00 None 24019005-2d20-423e-be04-9ce2af7fce3a
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-29 17:20:18.940117+00:00 Clear NaN 2019 10 28 18:46:00+00:00 None 53a58fed-b242-43ca-9e4d-6596bbe41ce8
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.66 ft ... USGS 2026-10-29 17:20:18.940117+00:00 Clear NaN 2019 10 28 18:50:00+00:00 None 6a9f553c-479f-43b5-ade5-b1340d52ef6a
30 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-29 17:20:18.940117+00:00 Clear Good 2019 10 28 19:06:42+00:00 None 8bbb2dd0-ab4a-437b-b695-49ad16a863d5
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 ... USGS 2026-10-29 17:20:18.940117+00:00 Clear NaN 2019 10 28 21:15:00+00:00 None b0b5f5e7-c00b-4234-9b1a-d9c153dbc769
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-29 17:20:18.940117+00:00 Clear Good 2019 12 3 20:53:15+00:00 None 6710ff15-7e2e-4003-b89b-d9cf131f91f9
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.59 ft ... USGS 2026-10-29 17:20:18.940117+00:00 Clear NaN 2019 12 3 20:07:00+00:00 None 6a6c3bae-1ad2-426f-b092-1caf813fafae
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 ... USGS 2026-10-29 17:20:18.940117+00:00 Clear Good 2019 12 3 20:53:15+00:00 None a78a3971-37c1-4440-881b-fa93f6dd5cc4
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 ... USGS 2026-10-29 17:20:18.940117+00:00 Clear NaN 2019 12 3 21:17:00+00:00 None d891ad96-73de-441c-a3e1-866b958f7a12

36 rows × 24 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,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-11-09 21:08:02.271097+00:00 Clear Good 1955 4 7 19:05:00+00:00 None 45cc1e76-e870-4683-b3b8-4f0c2429eecc
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-11-09 21:08:02.271097+00:00 Clear Good 1955 4 7 19:05:00+00:00 None d02c1d83-0866-424b-9565-a8eac0764197
2 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-11-09 21:08:02.271097+00:00 Clear Fair 1955 5 4 21:05:00+00:00 None 8ab4479c-5429-47d7-bee0-680542aad12f
3 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-11-09 21:08:02.271097+00:00 Clear Fair 1955 5 4 21:05:00+00:00 None f20ba3bd-d064-4980-bbf1-f599f0af1328
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-11-09 21:08:02.271097+00:00 Clear Good 1955 6 10 13:35:00+00:00 None 3602f17d-e6dd-41f1-a869-b1f194b5a44f
... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ...
1011 POINT (-76.69369 38.95592) 10f75368-e5d4-4b6a-a4a7-ec3f00f906b7 MeanGageHeight 48037f4f-d8c4-4636-a28c-cb7238bccdc3 00065 USGS-01594440 Z None 4.57 ft ... USGS 2026-11-09 21:08:02.271097+00:00 Clear Good 2026 6 29 13:50:34+00:00 None cdde8dfe-0dbc-46e9-a23f-f6885c51853b
1012 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-11-09 21:08:02.271097+00:00 Clear NaN 2026 9 17 13:22:00+00:00 None 10e640bb-dbaf-40c7-ac7f-e058696bd613
1013 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-11-09 21:08:02.271097+00:00 Clear Fair 2026 9 17 14:12:01+00:00 None 20b31b44-93bf-4afd-a8b2-f3dbfbf2df21
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.95 ft ... USGS 2026-11-09 21:08:02.271097+00:00 Clear NaN 2026 9 17 14:38:00+00:00 None 874f66fd-f664-4c99-8caa-3069718d5123
1015 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-11-09 21:08:02.271097+00:00 Clear Fair 2026 9 17 14:12:01+00:00 None b88e37b8-3951-4af3-a3e3-5eb80c83b2ab

1016 rows × 24 columns