MazamaSpatialUtils (version 0.5.4)

getState: Return State Names at Specified Locations

Description

Uses spatial comparison to determine which 'state' polygons the locations fall into and returns the ISO 3166-2 2-character state code strings for those polygons.

Specification of countryCodes limits spatial searching to the specified countries and greatly improves performance.

If allData=TRUE, additional data is returned.

Usage

getState(lon, lat, dataset = "NaturalEarthAdm1", countryCodes = NULL,
  allData = FALSE, useBuffering = FALSE)

Arguments

lon

vector of longitudes in decimal degrees

lat

vector of latitudes in decimal degrees

dataset

name of spatial dataset to use

countryCodes

vector of country codes

allData

logical specifying whether a full dataframe should be returned

useBuffering

logical flag specifying the use of location buffering to find the nearest polygon if no target polygon is found

Value

Vector of state names in English.

See Also

getSpatialData

Examples

# NOT RUN {
lon <- seq(-140,-90)
lat <- seq(20,70)
getState(lon,lat)
# }