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+gb3675aabc)
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.6)
Requirement already satisfied: anyio>=4.0 in /opt/hostedtoolcache/Python/3.13.15/x64/lib/python3.13/site-packages (from dataretrieval) (4.15.1)
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.3)
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.20)
Requirement already satisfied: typing_extensions>=4.16.0 in /opt/hostedtoolcache/Python/3.13.15/x64/lib/python3.13/site-packages (from anyio>=4.0->dataretrieval) (4.16.0)
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 · 2,117 rows

Retrieved 2117 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) 442c040d-8a0f-43e8-b4c7-840b2a60a89a MeanGageHeight 4cd21ba9-8644-ebfc-e053-0100007fd6db 00065 USGS-10109000 Z None 0.94 ft ... USGS 2026-09-27 02:10:13.165977+00:00 Clear Excellent 1951 9 6 16:40:00+00:00 None c59c39f2-2728-4503-83ec-fcb38fee6169
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-09-27 02:10:13.165977+00:00 Clear Excellent 1951 9 6 16:40:00+00:00 None e91199ef-9791-4670-8b41-983a75cd2fc9
2 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-09-27 02:10:13.165977+00:00 Clear Unspecified 1951 12 13 19:10:00+00:00 None 2a56c6ea-badf-4ce3-9dcd-ecf4a11aa77d
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 ... USGS 2026-09-27 02:10:13.165977+00:00 Clear Unspecified 1951 12 13 19:10:00+00:00 None 3d0f4ff8-0472-4c95-b23e-15a3dc0d022e
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-09-27 02:10:13.165977+00:00 Clear Good 1952 4 23 17:25:00+00:00 None 6823f847-ddc7-4246-a0c9-4600ddba1685
... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ...
2112 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-09-27 02:10:13.165977+00:00 Clear NaN 2026 9 8 22:10:00+00:00 None 0e147a8c-ed0d-45b3-9504-07e062efcf7c
2113 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-09-27 02:10:13.165977+00:00 Clear NaN 2026 9 8 23:05:00+00:00 None 1378a83c-65d0-45a8-8993-00c9e1f60c8f
2114 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-09-27 02:10:13.165977+00:00 Clear NaN 2026 9 8 23:05:00+00:00 None 14f7c30b-10d0-44e8-817c-a5f65554ec4f
2115 POINT (-111.78398 41.74355) 442c040d-8a0f-43e8-b4c7-840b2a60a89a MeanGageHeight 6caa9af4-cc49-4968-9f1e-601b1c861fb7 00065 USGS-10109000 Z None 2.41 ft ... USGS 2026-09-27 02:10:13.165977+00:00 Clear Fair 2026 9 8 22:41:02+00:00 None 574f3840-fdd1-4b90-8f14-cb47eb158baf
2116 POINT (-111.78398 41.74355) 7d5b4004-ca7e-46c5-9bde-25d5dde481c8 Discharge 6caa9af4-cc49-4968-9f1e-601b1c861fb7 00060 USGS-10109000 Z Mid-section 66.80 ft^3/s ... USGS 2026-09-27 02:10:13.165977+00:00 Clear Fair 2026 9 8 22:41:02+00:00 None f2dc9696-690d-48f3-89b5-0399117a0400

2117 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) 442c040d-8a0f-43e8-b4c7-840b2a60a89a MeanGageHeight 80a47f55-5d75-9c33-e053-0100007fa04d 00065 USGS-10109000 Z None 2.43 ft ... USGS 2026-09-27 02:10:13.165977+00:00 Clear Good 2019 1 29 19:57:30+00:00 None 43736f31-c7ca-48b0-bc20-4769b4504ced
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-09-27 02:10:13.165977+00:00 Clear NaN 2019 1 29 19:24:00+00:00 None 598f2387-bc14-4c97-857b-d5f4b7d81524
2 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-09-27 02:10:13.165977+00:00 Clear Good 2019 1 29 19:57:30+00:00 None 69706605-7bc7-42a2-b5b8-e5b913932d01
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 ... USGS 2026-09-27 02:10:13.165977+00:00 Clear NaN 2019 1 29 20:25:00+00:00 None bbe5b970-d40a-4991-95de-06f851e09441
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-09-27 02:10:13.165977+00:00 Clear NaN 2019 3 11 18:53:00+00:00 None 0c02032e-ef58-4dfb-a991-d8f2ee0a0321
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.48 ft ... USGS 2026-09-27 02:10:13.165977+00:00 Clear NaN 2019 3 11 18:14:00+00:00 None 4f694754-a540-4efa-8d89-875205e9471f
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 ... USGS 2026-09-27 02:10:13.165977+00:00 Clear Good 2019 3 11 19:29:30+00:00 None 7c10411d-3744-4a72-bed1-644819c220f1
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-09-27 02:10:13.165977+00:00 Clear Good 2019 3 11 19:29:30+00:00 None 898f04fa-0de3-4884-a823-4a21d4be9f5e
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-09-27 02:10:13.165977+00:00 Clear NaN 2019 3 11 19:57:00+00:00 None c53d8b4b-4dfe-40ef-8bd6-457b81c3de87
9 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-09-27 02:10:13.165977+00:00 Clear Good 2019 4 23 21:39:16+00:00 None 000f93fb-9690-43de-af28-5c5b522f4ef2
10 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-09-27 02:10:13.165977+00:00 Clear NaN 2019 4 23 22:03:00+00:00 None 7405b296-6db3-46b5-b94c-2fa09d1ab142
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-09-27 02:10:13.165977+00:00 Clear NaN 2019 4 23 20:55:00+00:00 None 8a61baa2-0d5e-4bf2-9ea4-4c04c23b20fe
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-09-27 02:10:13.165977+00:00 Clear Good 2019 4 23 21:39:16+00:00 None fc8d4b9a-6ddb-4733-9901-6fbea3b98784
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-09-27 02:10:13.165977+00:00 Clear Good 2019 6 12 14:02:56+00:00 None 09d68011-61ac-492c-a4be-1ef1ecbe09f3
14 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-09-27 02:10:13.165977+00:00 Clear NaN 2019 6 12 14:53:00+00:00 None a6bfd373-ca41-412b-9327-8a74faf07531
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.10 ft ... USGS 2026-09-27 02:10:13.165977+00:00 Clear NaN 2019 6 12 12:28:00+00:00 None d94dc148-0b95-42ad-802d-2f2030276152
16 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-09-27 02:10:13.165977+00:00 Clear Good 2019 6 12 14:02:56+00:00 None e95d676b-9281-4578-9871-4e589d037424
17 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-09-27 02:10:13.165977+00:00 Vegetation - Light Good 2019 7 30 17:57:17+00:00 None 1705f62d-e611-47df-b076-8a5b0c2a4748
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-09-27 02:10:13.165977+00:00 Vegetation - Light Good 2019 7 30 18:06:00+00:00 None 1f538320-1fa6-4cfb-b40d-3b330c686eca
19 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-09-27 02:10:13.165977+00:00 Vegetation - Light NaN 2019 7 30 18:30:00+00:00 None 21356263-6522-4f25-b719-c0436eff1e70
20 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-09-27 02:10:13.165977+00:00 Vegetation - Light Good 2019 7 30 17:57:17+00:00 None 957b4c91-7259-4449-8500-e4baea929e6a
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-09-27 02:10:13.165977+00:00 Vegetation - Light NaN 2019 7 30 17:16:00+00:00 None c9bc59e6-2cbb-442d-a7cc-f9ea926358f8
22 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-09-27 02:10:13.165977+00:00 Vegetation - Light Good 2019 7 30 18:06:00+00:00 None cc347839-2d5b-466f-97ad-fba507ee84aa
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 ... USGS 2026-09-27 02:10:13.165977+00:00 Vegetation - Light NaN 2019 9 16 16:04:00+00:00 None a0ce4844-1b9a-42e4-9d6e-ba09a33517e6
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-09-27 02:10:13.165977+00:00 Vegetation - Light Good 2019 9 16 16:59:19+00:00 None bbfe6ac2-f28b-4d24-8f38-e444216d2642
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-09-27 02:10:13.165977+00:00 Vegetation - Light Good 2019 9 16 16:59:19+00:00 None eddcf6b9-3403-4199-baff-9b32b6f0fe81
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 ... USGS 2026-09-27 02:10:13.165977+00:00 Vegetation - Light NaN 2019 9 16 17:33:00+00:00 None ee1bdc21-3a80-4cf1-971b-7a653b95629b
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.63 ft ... USGS 2026-09-27 02:10:13.165977+00:00 Clear NaN 2019 10 28 21:15:00+00:00 None 417153ee-ee2c-4c9a-b657-ab9978c7096c
28 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-09-27 02:10:13.165977+00:00 Clear Good 2019 10 28 19:06:42+00:00 None 458e76be-02fe-4dd3-9ec1-f1fa08f22d3e
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-09-27 02:10:13.165977+00:00 Clear NaN 2019 10 28 18:50:00+00:00 None d5ee10b4-a4be-49d2-a921-a7d5710d956c
30 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-09-27 02:10:13.165977+00:00 Clear NaN 2019 10 28 18:46:00+00:00 None e7a53dea-2ed0-4ad4-9389-8ffd3d890d6f
31 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-09-27 02:10:13.165977+00:00 Clear Good 2019 10 28 19:06:42+00:00 None e91df515-677c-4e9d-a2db-d93d8b0fd961
32 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-09-27 02:10:13.165977+00:00 Clear Good 2019 12 3 20:53:15+00:00 None 4c1f39f3-9f6c-40c9-bd26-f8a6beaf1f33
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 ... USGS 2026-09-27 02:10:13.165977+00:00 Clear Good 2019 12 3 20:53:15+00:00 None 8fa7352e-fb63-4220-84a4-ab66c2999e0c
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.61 ft ... USGS 2026-09-27 02:10:13.165977+00:00 Clear NaN 2019 12 3 21:17:00+00:00 None b1c73710-a6d0-4b15-a8be-1744262379ab
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.59 ft ... USGS 2026-09-27 02:10:13.165977+00:00 Clear NaN 2019 12 3 20:07:00+00:00 None c97220e3-b50b-431b-8cf4-6e2223cd77a9

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

Retrieved 1017 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) af34921e-31ca-46f0-afad-731e7ab10cae Discharge 53fb2a20-7b79-4148-e053-0100007f46df 00060 USGS-01594440 Z Unspecified 152.00 ft^3/s ... USGS 2026-09-24 16:36:10.659596+00:00 Clear Good 1955 4 7 19:05:00+00:00 None c320b869-41c0-46c2-9dab-5031c55a4cde
1 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-09-24 16:36:10.659596+00:00 Clear Good 1955 4 7 19:05:00+00:00 None ce448c4f-7811-4c71-ac55-b262d774fdcd
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-09-24 16:36:10.659596+00:00 Clear Fair 1955 5 4 21:05:00+00:00 None 512e26e6-7763-46d8-815a-b5011dee6647
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-09-24 16:36:10.659596+00:00 Clear Fair 1955 5 4 21:05:00+00:00 None 6eb44a66-1037-41df-860b-263b4a44932a
4 POINT (-76.69369 38.95592) 10f75368-e5d4-4b6a-a4a7-ec3f00f906b7 MeanGageHeight 53fb2a2a-6d26-3f11-e053-0100007f0ef5 00065 USGS-01594440 Z None 4.26 ft ... USGS 2026-09-24 16:36:10.659596+00:00 Clear Good 1955 6 10 13:35:00+00:00 None 6f923998-87ee-400a-bd94-95604bcf186c
... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ...
1012 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 ... USGS 2026-09-24 16:36:10.659596+00:00 Clear Good 2026 6 29 13:50:34+00:00 None 770c72e9-e935-43e3-82e8-debda52c45cf
1013 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-09-24 16:36:10.659596+00:00 Clear NaN 2026 9 17 14:38:00+00:00 None 1c1c1fb6-7c95-4401-8f9f-f30458311f94
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-09-24 16:36:10.659596+00:00 Clear NaN 2026 9 17 13:22:00+00:00 None 72c0472a-1c5d-4565-a515-c1a176fa694c
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-09-24 16:36:10.659596+00:00 Clear Fair 2026 9 17 14:12:01+00:00 None 844dc4dc-da81-494d-9008-5671a7e4aaf5
1016 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-09-24 16:36:10.659596+00:00 Clear Fair 2026 9 17 14:12:01+00:00 None c6407e87-26b4-4429-8038-4c947328216a

1017 rows × 24 columns