GPS Basemaps in R Using get_map

February 14, 2013

(This article was first published on Mollie's Research Blog, and kindly contributed to R-bloggers)

There are many different maps you can use for a background map for your gps or other latitude/longitude data (i.e. any time you’re using geom_path, geom_segment, or geom_point.)


Helpfully, there’s just one function that will allow you to query Google Maps, OpenStreetMap, Stamen maps, or CloudMade maps: get_map in the ggmap package. You could also use either get_googlemap, get_openstreetmap, get_stamenmap, or get_cloudmademap, but instead you can just use get_map for the same functionality as all of those combined. This makes it easy to try out different basemaps for your data.

You need to supply get_map with your location data and the color, source, maptype, and zoom of the base map.

Let’s go ahead and map the trails in Elwyn John Wildlife Sanctuary here in Atlanta. The csv data and R file are available in a gist.

gps <- read.csv("elwyn.csv",
  header = TRUE)

mapImageData <- get_map(location = c(lon = mean(gps$Longitude),
  lat = 33.824),
  color = "color", # or bw
  source = "google",
  maptype = "satellite",
  # api_key = "your_api_key", # only needed for source = "cloudmade"
  zoom = 17

pathcolor <- "#F8971F"

  extent = "device", # "panel" keeps in axes, etc.
  ylab = "Latitude",
  xlab = "Longitude",
  legend = "right") +
  geom_path(aes(x = Longitude, # path outline
  y = Latitude),
  data = gps,
  colour = "black",
  size = 2) +
  geom_path(aes(x = Longitude, # path
  y = Latitude),
  colour = pathcolor,
  data = gps,
  size = 1.4) # +
# labs(x = "Longitude",
#   y = "Latitude") # if you do extent = "panel"

We’ll be changing the four lines marked above in orange to change what basemap is used.

source = “google”

get_map option source = “google” (or using get_googlemap) downloads a map from the Google Maps API. The basemaps are © Google. Google Maps have four different maptype options: terrain, satellite, roadmap, and hybrid.

source = “google”, maptype = “terrain”

source = “google”, maptype = “terrain”, zoom = 14

Max zoom: 14

source = “google”, maptype = “satellite”

source = “google”, maptype = “satellite”, zoom = 17
Max zoom: 20

source = “google”, maptype = “roadmap”

source = “google”, maptype = “roadmap”, zoom = 17

source = “google”, maptype = “hybrid”

Hybrid combines roadmap and satellite.

source = “google”, maptype = “hybrid”, zoom = 17
Max zoom: 20

source = “osm”

get_map option source = “osm” (or using get_openstreetmap) downloads a map from OpenStreetMap. These maps are Creative Commons licensed, specifically Attribution-ShareAlike 2.0 (CC-BY-SA). This means you are free to use the maps for commercial purposes, as long as you release your final product under the same Creative Commons license. OpenStreetMap has no maptype options.

source = “osm” (no maptype needed)

source = “osm”, zoom = 17

Max zoom: 20

source = “stamen”

get_map option source = “stamen” (or using get_stamenmap) downloads a map from Stamen Maps. The map tiles are by Stamen Design, licensed under CC BY 3.0. The data for Stamen Maps is by OpenStreetMap, licensed under CC BY SA. Stamen has three different maptype options: terrain, watercolor, and toner.

source = “stamen”, maptype = “terrain”

source = “stamen”, maptype = “terrain”, zoom = 17
Max zoom: 18

source = “stamen”, maptype = “watercolor”

source = “stamen”, maptype = “watercolor”, zoom = 17
Max zoom: 18

source = “stamen”, maptype = “toner”

source = “stamen”, maptype = “toner”, zoom = 17
Max zoom: 18

source = “cloudmade”

CloudMade styles build on top of OpenStreetMap data. Thousands of CloudMade styles are available. You can browse them on the CloudMade site. You can also make your own styles.

To use CloudMade map styles in R, you will first need to get an API key to insert into your R code so it can access the maps. You can get an API key from the CloudMade site.

Here are just a couple examples of CloudMade basemaps:

source = “cloudmade”, maptype = 1, api_key = “your_key_here”, zoom = 17

Style: The Original
Author: CloudMade

source = “cloudmade”, maptype = 67367, api_key = “your_key_here”, zoom = 17

Style: 10Scape-2
Author: Romeady Adi

Max zoom: 18

The code and data are available in a gist.

To leave a comment for the author, please follow the link and comment on their blog: Mollie's Research Blog. offers daily e-mail updates about R news and tutorials on topics such as: Data science, Big Data, R jobs, visualization (ggplot2, Boxplots, maps, animation), programming (RStudio, Sweave, LaTeX, SQL, Eclipse, git, hadoop, Web Scraping) statistics (regression, PCA, time series, trading) and more...

If you got this far, why not subscribe for updates from the site? Choose your flavor: e-mail, twitter, RSS, or facebook...

Comments are closed.


Never miss an update!
Subscribe to R-bloggers to receive
e-mails with the latest R posts.
(You will not see this message again.)

Click here to close (This popup will not appear again)