ne_states: Get natural earth world state (admin level 1) polygons

In AndySouth/rnaturalearth: World Map Data from Natural Earth

Get natural earth world state (admin level 1) polygons

Description

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').

Details

By default, this function uses the scale = 10 data from the rnaturalearthhires package. While data at scales 50 and 110 exist, they are not used as defaults because they contain fewer countries (e.g. scale 50 only includes Australia, Brazil, Canada and United States of America). For finer control, use ne_download.

ne_download( scale = 10L, type = "states", category = "cultural")

ne_download( scale = 50L, type = "states", category = "cultural")

ne_download( scale = 110L, type = "states", category = "cultural")

Value

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

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"))
}

AndySouth/rnaturalearth documentation built on April 14, 2025, 3:22 a.m.