cartographer status badge CRAN status R-CMD-check

If you have a list of place/region names (for example as a column in a data frame) and you’d like to turn that into spatial data, {cartographer} can help. There are 2 steps:

  1. Register the spatial data with {cartographer} using register_map(), or load a package that already did that for you.
  2. Use add_geometry() to turn your ordinary data frame into a spatial one.

Cartographer will be most useful when you are working regularly with data about the same places. You can do the work once to curate your geospatial data, and thereafter you can use cartographer to quickly jump from place names to map data ready to analyse or visualise.

See vignette("cartographer") for examples, and {ggautomap} for some handy ggplot helpers that pull map data using {cartographer}.


You can install cartographer like so:

# CRAN release

# development version
install.packages('cartographer', repos = c('', ''))

Map data

Some packages provide data that works with {cartographer}:

Alternatively, you can register your own data using register_map() (see vignette("registering_maps")).