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.15/x64/lib/python3.13/site-packages (0.1.dev1+g470280d9a)
Requirement already satisfied: httpx in /opt/hostedtoolcache/Python/3.13.15/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.15/x64/lib/python3.13/site-packages (from dataretrieval) (3.0.5)
Requirement already satisfied: anyio>=4.0 in /opt/hostedtoolcache/Python/3.13.15/x64/lib/python3.13/site-packages (from dataretrieval) (4.14.2)
Requirement already satisfied: numpy>=1.26.0 in /opt/hostedtoolcache/Python/3.13.15/x64/lib/python3.13/site-packages (from pandas<4.0.0,>=2.0.0->dataretrieval) (2.5.2)
Requirement already satisfied: python-dateutil>=2.8.2 in /opt/hostedtoolcache/Python/3.13.15/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.15/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.15/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.15/x64/lib/python3.13/site-packages (from httpx->dataretrieval) (2026.7.22)
Requirement already satisfied: httpcore==1.* in /opt/hostedtoolcache/Python/3.13.15/x64/lib/python3.13/site-packages (from httpx->dataretrieval) (1.0.9)
Requirement already satisfied: h11>=0.16 in /opt/hostedtoolcache/Python/3.13.15/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,117 rows

Retrieved 3117 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-08-13 18:35:47.109403+00:00 Clear Excellent 1951 9 6 16:40:00+00:00 20fccde0-ece4-4baa-a092-17d6c64292e9
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 ... Approved USGS 2026-08-13 18:35:47.109403+00:00 Clear Excellent 1951 9 6 16:40:00+00:00 68d4532e-3148-4916-a43f-b09bcb787610
2 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-08-13 18:35:47.109403+00:00 Clear NaN 1951 9 6 16:40:00+00:00 aa2ada30-a8ab-4c17-87b3-2e150e3b039f
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-08-13 18:35:47.109403+00:00 Clear Unspecified 1951 12 13 19:10:00+00:00 a61da8bd-dfeb-4df6-87b2-4a4ee3f8dc52
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-08-13 18:35:47.109403+00:00 Clear NaN 1951 12 13 19:10:00+00:00 c60b0d0e-19ee-494b-9648-6e485d125590
... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ...
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-08-13 18:35:47.109403+00:00 Clear NaN 2026 7 8 17:50:00+00:00 78d26993-8741-429a-ab16-ddc6886c62f1
3113 POINT (-111.78398 41.74355) 4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7 ReferencePrimary 3ffbe661-ee24-48ad-b993-162f97302e46 00065 USGS-10109000 Z Gage height, electric tape 2.43 ft ... Provisional USGS 2026-08-13 18:35:47.109403+00:00 Clear NaN 2026 8 12 16:03:00+00:00 fa4d7319-d2db-43ed-a820-9752abf574ff
3114 POINT (-111.78398 41.74355) 7d5b4004-ca7e-46c5-9bde-25d5dde481c8 Discharge 3ffbe661-ee24-48ad-b993-162f97302e46 00060 USGS-10109000 Z Mid-section 66.70 ft^3/s ... Provisional USGS 2026-08-13 18:35:47.109403+00:00 Clear Fair 2026 8 12 16:37:05+00:00 95678cae-48dc-4add-8170-af217fe1c40b
3115 POINT (-111.78398 41.74355) 442c040d-8a0f-43e8-b4c7-840b2a60a89a MeanGageHeight 3ffbe661-ee24-48ad-b993-162f97302e46 00065 USGS-10109000 Z None 2.43 ft ... Provisional USGS 2026-08-13 18:35:47.109403+00:00 Clear Fair 2026 8 12 16:37:05+00:00 96daa345-0983-4b33-928e-10d7292c9fa3
3116 POINT (-111.78398 41.74355) 4fd8c8cb-2d00-4858-bf22-fa8da4dc45f7 ReferencePrimary 3ffbe661-ee24-48ad-b993-162f97302e46 00065 USGS-10109000 Z Gage height, float tape gage 2.43 ft ... Provisional USGS 2026-08-13 18:35:47.109403+00:00 Clear NaN 2026 8 12 16:58:00+00:00 d421f420-214f-4561-acfb-2dd5b549cc99

3117 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-08-13 18:35:47.109403+00:00 Clear NaN 2019 1 29 19:24:00+00:00 0112ac15-7a07-4f75-bb90-c61060afc666
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-08-13 18:35:47.109403+00:00 Clear Good 2019 1 29 19:57:30+00:00 6c4b0fbe-283f-4f59-8ee2-4d7add1fa18c
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-08-13 18:35:47.109403+00:00 Clear Good 2019 1 29 19:57:30+00:00 97fee890-7a64-476a-b06b-39029cffbf15
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-08-13 18:35:47.109403+00:00 Clear NaN 2019 1 29 20:25:00+00:00 f9feed31-670a-4d38-9554-2dadae12c6d8
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-08-13 18:35:47.109403+00:00 Clear NaN 2019 3 11 18:14:00+00:00 08129df4-397b-4525-b519-b42e5bf7a12e
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-08-13 18:35:47.109403+00:00 Clear NaN 2019 3 11 18:53:00+00:00 028e9492-7c6e-48c2-b8c9-3ec673c4ca25
6 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-08-13 18:35:47.109403+00:00 Clear Good 2019 3 11 19:29:30+00:00 172c62f6-ade6-4c84-bd62-ac2981bd3600
7 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-08-13 18:35:47.109403+00:00 Clear Good 2019 3 11 19:29:30+00:00 419adff4-a952-4aa6-95b8-a29e231d3787
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-08-13 18:35:47.109403+00:00 Clear NaN 2019 3 11 19:57:00+00:00 b35e01be-a694-4956-baa9-4a0d13b472f3
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-08-13 18:35:47.109403+00:00 Clear NaN 2019 4 23 20:55:00+00:00 6b634c6a-5b8c-449d-b2ed-4d9e6b2286ff
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-08-13 18:35:47.109403+00:00 Clear Good 2019 4 23 21:39:16+00:00 90d57826-2664-4bcf-8ab2-cc05af1372c2
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-08-13 18:35:47.109403+00:00 Clear Good 2019 4 23 21:39:16+00:00 b0b60765-1666-46e8-9676-a5f76fa70a45
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-08-13 18:35:47.109403+00:00 Clear NaN 2019 4 23 22:03:00+00:00 bd3ad334-4526-466f-99da-8e90aabdcf11
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-08-13 18:35:47.109403+00:00 Clear NaN 2019 6 12 12:28:00+00:00 c9438748-1b6f-47b5-991e-369488e96049
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-08-13 18:35:47.109403+00:00 Clear Good 2019 6 12 14:02:56+00:00 63f2ddc2-332f-4bf2-9733-007c490cb62c
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-08-13 18:35:47.109403+00:00 Clear Good 2019 6 12 14:02:56+00:00 8c8c3977-6012-45dd-b648-8c2cc10393ca
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-08-13 18:35:47.109403+00:00 Clear NaN 2019 6 12 14:53:00+00:00 bb5c983c-abec-4a74-a766-5cc78110ad82
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-08-13 18:35:47.109403+00:00 Vegetation - Light NaN 2019 7 30 17:16:00+00:00 76ec0784-fbba-4a7e-bf08-f338738cea5d
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 ... Approved USGS 2026-08-13 18:35:47.109403+00:00 Vegetation - Light Good 2019 7 30 17:57:17+00:00 b7d92d9f-b53c-4f95-8d4b-3524c296b5b2
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 ... Approved USGS 2026-08-13 18:35:47.109403+00:00 Vegetation - Light Good 2019 7 30 17:57:17+00:00 cb2fda51-d378-49ac-b743-25faed9d3cfb
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-08-13 18:35:47.109403+00:00 Vegetation - Light Good 2019 7 30 18:06:00+00:00 c2d14a17-6d54-42fe-8420-c4ad060130e2
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-08-13 18:35:47.109403+00:00 Vegetation - Light Good 2019 7 30 18:06:00+00:00 d73b6c6a-e542-4d28-b0fd-eb3398873dd0
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-08-13 18:35:47.109403+00:00 Vegetation - Light NaN 2019 7 30 18:30:00+00:00 3a226f7e-8b35-41a8-8614-ac423a32f253
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-08-13 18:35:47.109403+00:00 Vegetation - Light NaN 2019 9 16 16:04:00+00:00 ca4a5d23-b38c-4b79-9346-19e8ce349d7b
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 ... Approved USGS 2026-08-13 18:35:47.109403+00:00 Vegetation - Light Good 2019 9 16 16:59:19+00:00 7662cbeb-f6ca-4fc2-9646-2b9572583313
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 ... Approved USGS 2026-08-13 18:35:47.109403+00:00 Vegetation - Light Good 2019 9 16 16:59:19+00:00 82596f06-7370-460b-9905-875fd6739e4c
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-08-13 18:35:47.109403+00:00 Vegetation - Light NaN 2019 9 16 17:33:00+00:00 117564b8-027c-46bb-9455-c04e9b8aae1a
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-08-13 18:35:47.109403+00:00 Clear NaN 2019 10 28 18:46:00+00:00 396d63dd-db50-49ef-87df-8a7811e7057f
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-08-13 18:35:47.109403+00:00 Clear NaN 2019 10 28 18:50:00+00:00 fbac70b3-8939-41a5-a5c5-d87901a558d7
29 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-08-13 18:35:47.109403+00:00 Clear Good 2019 10 28 19:06:42+00:00 7b401ced-6f7d-4601-b96f-882d43b70b04
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 ... Approved USGS 2026-08-13 18:35:47.109403+00:00 Clear Good 2019 10 28 19:06:42+00:00 c69b8d78-aa9f-4e1f-b59f-6515cc4c31fb
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-08-13 18:35:47.109403+00:00 Clear NaN 2019 10 28 21:15:00+00:00 e9fb77b4-00af-4e07-8364-c50b00b31339
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-08-13 18:35:47.109403+00:00 Clear NaN 2019 12 3 20:07:00+00:00 fd840a3c-aa0b-47cb-87b7-8666b29a813f
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-08-13 18:35:47.109403+00:00 Clear Good 2019 12 3 20:53:15+00:00 d1f23796-c353-4c94-9f4f-d609596c2362
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-08-13 18:35:47.109403+00:00 Clear Good 2019 12 3 20:53:15+00:00 fac38497-fd09-49d9-a456-3f966bff7ff5
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-08-13 18:35:47.109403+00:00 Clear NaN 2019 12 3 21:17:00+00:00 33f5df01-577d-482f-9f07-3ecf5206d312

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

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