Usgs Water Examples

WaterStreamflowGroundwaterWater QualityHydrologyEnvironmentalUSGSNWISGovernmentOpen DataOGC
Usgs Water Examples is an example object payload from USGS Water Services, with 7 top-level fields. It illustrates the shape of data this provider's APIs accept or return.
Top-level fields

continuousdailyfield-measurementsmonitoring-locationsparameter-codespeakstime-series-metadata
Example Payload

{
  "continuous": {
    "endpoint": "https://api.waterdata.usgs.gov/ogcapi/v0/collections/continuous/items",
    "method": "GET",
    "description": "Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monito",
    "example_parameters": {
      "limit": 10,
      "time_series_id": "example",
      "monitoring_location_id": "example",
      "parameter_code": "example",
      "statistic_id": "example",
      "time": "example",
      "value": "example",
      "unit_of_measure": "example",
      "approval_status": "Provisional",
      "qualifier": "example",
      "last_modified": "example",
      "altitude_method_code": "example",
      "altitude_method_name": "example",
      "aquifer_code": "example",
      "aquifer_type_code": "example",
      "basin_code": "example",
      "construction_date": "example",
      "country_code": "example",
      "country_name": "example",
      "depth_source_code": "example",
      "horizontal_position_method_code": "example",
      "horizontal_position_method_name": "example",
      "horizontal_positional_accuracy": "example",
      "horizontal_positional_accuracy_code": "example",
      "minor_civil_division_code": "example",
      "national_aquifer_code": "example",
      "original_horizontal_datum": "example",
      "original_horizontal_datum_name": "example",
      "time_zone_abbreviation": "example",
      "uses_daylight_savings": "example",
      "vertical_datum": "example",
      "vertical_datum_name": "example"
    }
  },
  "daily": {
    "endpoint": "https://api.waterdata.usgs.gov/ogcapi/v0/collections/daily/items",
    "method": "GET",
    "description": "Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monit",
    "example_parameters": {
      "limit": 10,
      "time_series_id": "example",
      "monitoring_location_id": "example",
      "parameter_code": "example",
      "statistic_id": "example",
      "time": "example",
      "value": "example",
      "unit_of_measure": "example",
      "approval_status": "Provisional",
      "qualifier": "example",
      "last_modified": "example",
      "altitude_method_code": "example",
      "altitude_method_name": "example",
      "aquifer_code": "example",
      "aquifer_type_code": "example",
      "basin_code": "example",
      "construction_date": "example",
      "country_code": "example",
      "country_name": "example",
      "depth_source_code": "example",
      "horizontal_position_method_code": "example",
      "horizontal_position_method_name": "example",
      "horizontal_positional_accuracy": "example",
      "horizontal_positional_accuracy_code": "example",
      "minor_civil_division_code": "example",
      "national_aquifer_code": "example",
      "original_horizontal_datum": "example",
      "original_horizontal_datum_name": "example",
      "time_zone_abbreviation": "example",
      "uses_daylight_savings": "example",
      "vertical_datum": "example",
      "vertical_datum_name": "example"
    }
  },
  "field-measurements": {
    "endpoint": "https://api.waterdata.usgs.gov/ogcapi/v0/collections/field-measurements/items",
    "method": "GET",
    "description": "Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwa",
    "example_parameters": {
      "limit": 10,
      "field_measurements_series_id": "example",
      "reading_type": "example",
      "field_visit_id": "example",
      "parameter_code": "example",
      "monitoring_location_id": "example",
      "observing_procedure_code": "example",
      "observing_procedure": "example",
      "value": "example",
      "unit_of_measure": "example",
      "time": "example",
      "qualifier": "example",
      "vertical_datum": "example",
      "approval_status": "Provisional",
      "measuring_agency": "example",
      "last_modified": "example",
      "control_condition": "example",
      "measurement_rated": "example",
      "year": 10,
      "month": 10,
      "day": 10,
      "time_of_day": "example",
      "altitude_method_code": "example",
      "altitude_method_name": "example",
      "aquifer_code": "example",
      "aquifer_type_code": "example",
      "basin_code": "example",
      "construction_date": "example",
      "country_code": "example",
      "country_name": "example",
      "depth_source_code": "example",
      "horizontal_position_method_code": "example",
      "horizontal_position_method_name": "example",
      "horizontal_positional_accuracy": "example",
      "horizontal_positional_accuracy_code": "example",
      "minor_civil_division_code": "example",
      "national_aquifer_code": "example",
      "original_horizontal_datum": "example",
      "original_horizontal_datum_name": "example",
      "time_zone_abbreviation": "example",
      "uses_daylight_savings": "example",
      "vertical_datum_name": "example",
      "vertical_datum_site": "example"
    }
  },
  "monitoring-locations": {
    "endpoint": "https://api.waterdata.usgs.gov/ogcapi/v0/collections/monitoring-locations/items",
    "method": "GET",
    "description": "Location information is basic information about the monitoring location including the name, identifier, agency responsible for data collection, and the date the location was established. It also inclu",
    "example_parameters": {
      "limit": 10,
      "id": "example",
      "agency_code": "example",
      "agency_name": "example",
      "monitoring_location_number": "example",
      "monitoring_location_name": "example",
      "district_code": "example",
      "country_code": "example",
      "country_name": "example",
      "state_code": "example",
      "state_name": "example",
      "county_code": "example",
      "county_name": "example",
      "minor_civil_division_code": "example",
      "site_type_code": "example",
      "site_type": "example",
      "hydrologic_unit_code": "example",
      "basin_code": "example",
      "altitude_method_code": "example",
      "altitude_method_name": "example",
      "vertical_datum": "example",
      "vertical_datum_name": "example",
      "horizontal_positional_accuracy_code": "example",
      "horizontal_positional_accuracy": "example",
      "horizontal_position_method_code": "example",
      "horizontal_position_method_name": "example",
      "original_horizontal_datum": "example",
      "original_horizontal_datum_name": "example",
      "time_zone_abbreviation": "example",
      "uses_daylight_savings": "example",
      "construction_date": "example",
      "aquifer_code": "example",
      "national_aquifer_code": "example",
      "aquifer_type_code": "example",
      "depth_source_code": "example",
      "revision_note": "example",
      "revision_created": "example",
      "revision_modified": "example"
    }
  },
  "parameter-codes": {
    "endpoint": "https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items",
    "method": "GET",
    "description": "Parameter codes are 5-digit codes and associated descriptions used to identify the constituent measured and the units of measure. Some parameter code definitions include information about the sampling",
    "example_parameters": {
      "limit": 10000,
      "id": "example",
      "parameter_name": "example",
      "unit_of_measure": "example",
      "parameter_group_code": "example",
      "parameter_description": "example",
      "medium": "example",
      "statistical_basis": "example",
      "time_basis": "example",
      "weight_basis": "example",
      "particle_size_basis": "example",
      "sample_fraction": "example",
      "temperature_basis": "example",
      "epa_equivalence": "example"
    }
  },
  "peaks": {
    "endpoint": "https://api.waterdata.usgs.gov/ogcapi/v0/collections/peaks/items",
    "method": "GET",
    "description": "Annual peak flow values are the maximum instantaneous streamflow values recorded at a particular site for the entire water year from October 1 to September 30. Note that the annual peak flow value may",
    "example_parameters": {
      "limit": 10,
      "time_series_id": "example",
      "monitoring_location_id": "example",
      "parameter_code": "example",
      "id": "example",
      "unit_of_measure": "example",
      "value": "example",
      "last_modified": "example",
      "time": "example",
      "water_year": 10,
      "year": 10,
      "month": 10,
      "day": 10,
      "time_of_day": "example",
      "peak_since": 10,
      "qualifier": "example"
    }
  },
  "time-series-metadata": {
    "endpoint": "https://api.waterdata.usgs.gov/ogcapi/v0/collections/time-series-metadata/items",
    "method": "GET",
    "description": "Daily data and continuous measurements are grouped into time series, which represent a collection of observations of a single parameter, potentially aggregated using a standard statistic, at a single ",
    "example_parameters": {
      "limit": 10,
      "id": "example",
      "unit_of_measure": "example",
      "parameter_name": "example",
      "parameter_code": "example",
      "statistic_id": "example",
      "hydrologic_unit_code": "example",
      "state_name": "example",
      "last_modified": "example",
      "begin": "example",
      "end": "example",
      "begin_utc": "example",
      "end_utc": "example",
      "computation_period_identifier": "example",
      "computation_identifier": "example",
      "thresholds": "example",
      "sublocation_identifier": "example",
      "primary": "example",
      "monitoring_location_id": "example",
      "web_description": "example",
      "parameter_description": "example",
      "parent_time_series_id": "example"
    }
  }
}