query_metadata: Query CO-OPS API for Station Metadata

In noaaoceans: Collect Ocean Data from NOAA

Description

Provides easy access to the CO-OPS Metadata API. The api makes information about measurement stations available to users. Information about a single station or a collection of stations can be accessed. Depending on the type of station queried different information is returned.

Usage

query_metadata(
  station_id = NULL,
  resource = NULL,
  type = NULL,
  ports = NULL,
  units = "english",
  radius = NULL,
  bin = NULL
)

Arguments

station_id	an optional string that provides the a 7 character station id. If omitted the derived product API returns data for all stations.
resource	a character string indicating they type of information to request for a specific station. A list of resource identifiers is available in the API Documentation
type	a character string indicating the sensor of interest. Specifying a sensor of interest returns a data frame with all stations that have the particular sensor. A list of sensor identifiers is available in the API Documentation
ports	A two character string indicating specific ports.
units	a character string specifying if the data should be returned using metric or English units. Defaults to 'english'
radius	an optional numeric argument indicating the radius in nautical miles to search for nearby stations
bin	an optional (positive integer) argument to requests for currents station harmonic constituents. If not specified, all the bins will be returned.

Value

A data frame. The content of the data frame is dependent on the API call. See the API documentation for specifics.

Examples

# Query a single stations sensors.
sensor_df <- query_metadata('9414290', 'sensors')

# Query all stations
all_stations_df <- query_metadata()

noaaoceans documentation built on April 10, 2021, 9:05 a.m.