mr_records_by_type: Get Marineregions records by place type

In ropenscilabs/mregions: Marine Regions Data from 'Marineregions.org'

Get Marineregions records by place type

Description

Get Marineregions records by place type

Usage

mr_records_by_type(type, offset = 0, ...)

Arguments

type	(character) One place type name. See mr_place_types() for place type names
offset	(numeric) Offset to start at. Each request can return up to 100 results. e.g., an offset of 200 will give records 200 to 299.
...	Curl options passed on to httr::GET()

Details

Internally we use the getGazetteerRecordsByType.json API method, which searches for Marineregions records by user supplied place type

Value

If no results, an empty list. If results found, a data.frame with the columns:

• MRGID (integer)

• gazetteerSource (character)

• placeType (character)

• latitude (numeric)

• longitude (numeric)

• minLatitude (numeric)

• minLongitude (numeric)

• maxLatitude (numeric)

• maxLongitude (numeric)

• precision (numeric)

• preferredGazetteerName (character)

• preferredGazetteerNameLang (character)

• status (character)

• accepted (integer)

Examples

## Not run: 
# Get records of type 'EEZ', then inspect data.frame
res <- mr_records_by_type(type="EEZ")
head(res)

# You can use mr_place_types() function to get types
## then pass those into this function
types <- mr_place_types()
mr_records_by_type(types$type[1])
mr_records_by_type(types$type[10])

# use regex to find a type name matching a pattern
x <- grep("MEOW", types$type, value = TRUE)

# then pass to the function
mr_records_by_type(x)
mr_records_by_type(x, offset = 100)

## End(Not run)

ropenscilabs/mregions documentation built on Feb. 28, 2024, 9:21 p.m.