Skip to contents

Get data from within the package

Source: R/get_data.R
get_data.Rd

returns world country polygons at a specified scale, used by ne_countries()

Usage

get_data(
  scale = 110L,
  type = c("countries", "map_units", "sovereignty", "tiny_countries")
)

Arguments

scale

The scale of map to return, one of `110`, `50`, `10` or `small`, `medium`, `large`.

type

country type, one of 'countries', 'map_units', 'sovereignty', 'tiny_countries'

Value

A sf object.

Details

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

If the data is to be loaded into memory (`load = TRUE`), the download will be handled using the GDAL virtual file system, allowing direct access to the data without writing it to disk.

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

if (FALSE) { # \dontrun{
spdf_world <- ne_download(scale = 110, type = "countries")

plot(spdf_world)
plot(ne_download(type = "populated_places"))

# reloading from the saved file in the same session with same arguments

spdf_world2 <- ne_load(scale = 110, type = "countries")

# download followed by load from specified directory will work across sessions
spdf_world <- ne_download(scale = 110, type = "countries", destdir = getwd())
spdf_world2 <- ne_load(scale = 110, type = "countries", destdir = getwd())

# for raster, here an example with Manual Shaded Relief (MSR) download & load

rst <- ne_download(scale = 50, type = "MSR_50M", category = "raster", destdir = getwd())

# load after having downloaded
rst <- ne_load(
  scale = 50, type = "MSR_50M", category = "raster", destdir = getwd()
)

# plot
library(terra)
terra::plot(rst)
# end dontrun
} # }