Skip to contents

returns state polygons (administrative level 1) for specified countries

Usage

ne_states(
  country = NULL,
  geounit = NULL,
  iso_a2 = NULL,
  spat_object = NULL,
  returnclass = c("sf", "sv")
)

Arguments

country

a character vector of country names.

geounit

a character vector of geounit names.

iso_a2

a character vector of iso_a2 country codes

spat_object

an optional alternative states map

returnclass

A string determining the spatial object to return. Either "sf" for for simple feature (from `sf`, the default) or "sv" for a `SpatVector` (from `terra`).

Value

An object of class `sf` for simple feature (from `sf`, the default) or `SpatVector` (from `terra`).

Details

Note that the filename of the requested object will be returned if `load = FALSE`.

See also

ne_load, pre-downloaded data are available using ne_countries, ne_states. Other geographic data are available in the raster package : getData.

Examples


# comparing using country and geounit to filter
if (requireNamespace("rnaturalearthhires")) {
  spdf_france_country <- ne_states(country = "france")
  spdf_france_geounit <- ne_states(geounit = "france")

  plot(spdf_france_country)
  plot(spdf_france_geounit)

  plot(ne_states(country = "united kingdom"))
  plot(ne_states(geounit = "england"))
}
#> Loading required namespace: rnaturalearthhires
#> Warning: plotting the first 9 out of 121 attributes; use max.plot = 121 to plot all

#> Warning: plotting the first 9 out of 121 attributes; use max.plot = 121 to plot all

#> Warning: plotting the first 9 out of 121 attributes; use max.plot = 121 to plot all

#> Warning: plotting the first 9 out of 121 attributes; use max.plot = 121 to plot all