rnoaa (version 0.2.0)

ncdc_locs: Get metadata about NOAA NCDC locations.

Description

From the NOAA NCDC API docs: Locations can be a specific latitude/longitude point such as a station, or a label representing a bounding area such as a city.

Usage

ncdc_locs(datasetid = NULL, locationid = NULL, locationcategoryid = NULL,
  startdate = NULL, enddate = NULL, sortfield = NULL, sortorder = NULL,
  limit = 25, offset = NULL, callopts = list(), token = NULL)

Arguments

datasetid

A single valid dataset id. Data returned will be from the dataset specified, see datasets() (required)

locationcategoryid

A valid location id or a chain of location category ids in a comma-separated vector. Locations returned will be in the location category(ies) specified

startdate

A valid ISO formated date (yyyy-mm-dd). Data returned will have data after the specified date. Paramater can be use independently of enddate (optional)

enddate

Accepts valid ISO formated date (yyyy-mm-dd). Data returned will have data before the specified date. Paramater can be use independently of startdate (optional)

sortfield

The field to sort results by. Supports id, name, mindate, maxdate, and datacoverage fields (optional)

sortorder

Which order to sort by, asc or desc. Defaults to asc (optional)

limit

Defaults to 25, limits the number of results in the response. Maximum is 1000 (optional)

offset

Defaults to 0, used to offset the resultlist (optional)

token

This must be a valid token token supplied to you by NCDC's Climate Data Online access token generator. (required) Get an API key (=token) at http://www.ncdc.noaa.gov/cdo-web/token. You can pass your token in as an argument or store it in your .Rprofile file with an entry like

• options("noaakey" = "your-noaa-token")

callopts

Further arguments passed on to the API GET call. (optional)

locationid

A valid location id or a chain of location ids seperated by ampersands. Data returned will contain data for the location(s) specified (optional)

Value

A list containing metadata and the data, or a single data.frame.

Examples

## Not run: ------------------------------------
# # All locations, first 25 results
# ncdc_locs()
# 
# # Fetch more information about location id FIPS:37
# ncdc_locs(locationid='FIPS:37')
# 
# # Fetch available locations for the GHCND (Daily Summaries) dataset
# ncdc_locs(datasetid='GHCND')
# 
# # Fetch all U.S. States
# ncdc_locs(locationcategoryid='ST', limit=52)
# 
# # Fetch list of city locations in descending order
# ncdc_locs(locationcategoryid='CITY', sortfield='name', sortorder='desc')
## ---------------------------------------------