returns downloaded data as a spatial object or the filename if load=FALSE. if destdir is specified the data can be reloaded in a later R session using ne_load with the same arguments.

ne_download(
  scale = 110,
  type = "countries",
  category = c("cultural", "physical", "raster"),
  destdir = tempdir(),
  load = TRUE,
  returnclass = c("sp", "sf")
)

Arguments

scale

scale of map to return, one of 110, 50, 10 or 'small', 'medium', 'large'

type

type of natural earth file to download one of 'countries', 'map_units', 'map_subunits', 'sovereignty', 'states' OR the portion of any natural earth vector url after the scale and before the . e.g. for 'ne_50m_urban_areas.zip' this would be 'urban_areas'. See Details. OR the raster filename e.g. for 'MSR_50M.zip' this would be 'MSR_50M'

category

one of natural earth categories : 'cultural', 'physical', 'raster'

destdir

where to save files, defaults to tempdir(), getwd() is also possible.

load

TRUE/FALSE whether to load file into R and return

returnclass

'sp' default or 'sf' for Simple Features

Value

A Spatial object depending on the data (points, lines, polygons or raster), unless load=FALSE in which case it returns the name of the downloaded shapefile (without extension).

Details

A non-exhaustive list of datasets available according to scale specified by the type param

scale = 'small'scale = 'medium'scale = 'large'
category = 'physical', type = '[below]'coastlineyy
ylandyy
yoceanyy
yrivers_lake_centerlinesyy
ylakesyy
yglaciated_areasyy
yantarctic_ice_shelves_polys-y
ygeographic_linesyy
ygraticules_1yy
ygraticules_30yy
ywgs84_bounding_boxyy
yplayas-y
yminor_islands--
yreefs--
ycategory = 'cultural', type = '[below]'populated_placesy
yyboundary_lines_landy
yybreakaway_disputed_areas-
yyairports-
yyports-
yyurban_areas-
yyroads-
-yrailroads-

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) { spdf_world <- ne_download( scale = 110, type = 'countries' ) if (require(sp)) { 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(raster) raster::plot(rst) } # end dontrun