---

This site uses cookies. Read more.

 23 November, 2021

Visualizing spatial data in R is oftentimes more challenging than it initially seems. There’s a ton of moving parts, like map center point, zoom, map type, marker size, and so on. And then there’s cartographic design and managing aesthetic appeal along with the functional elements. It goes without saying, but you have to get all of them right to have a cohesive map.

That’s where this article comes in. We’ll show you how to build interactive Google Maps with R, and how to include them in R Shiny dashboards. With Google Maps in R, you can give your users a familiar map and retain customizability by placing it within a Shiny dashboard.

To follow along, you’ll have to set up a Google Cloud account. It’s fairly simple, but we’ll show you how.

Looking for a Google Maps alternative? Check our guide on building interactive maps with R and Leaflet.

Table of contents:


How to Set up Google Cloud Account

As the name suggests, Google Maps are developed by Google and offered as an API through their Cloud Platform. You’ll have to register an account and set up billing. Yes, you do need to put in credit card information, but they won’t charge you a dime without your knowledge.

Once you have an account and a project setup, you can enable APIs required for communication between R and Google. These are:

  • Maps JavaScript API
  • Maps Static API
  • Geocoding API

To enable them, click on the menu icon, go under APIs & Services and click on Library. You can search for the APIs from there and enable all three. Once done, you’ll see them listed on the main dashboard page:

Image 1 - Enabled APIs on the Google Cloud Platform

Image 1 – Enabled APIs on the Google Cloud Platform

Yours should show zeros under Requests if you’re setting up a new Google Cloud account. The final step is to create a new API key. Go under Credentials and click on + Create credentials to get a new API key:

Image 2 - Creating Maps API key

Image 2 – Creating Maps API key

Once created, copy the string code somewhere safe. You’ll need it in the following section, where you’ll create a couple of interactive Google Maps with R.

Build Interactive Google Maps with R

You’ll need the googleway library to follow along, so make sure to have it installed. Dataset-wise, you’ll use the US airports dataset from Kaggle:

Image 3 - List of US Airports dataset

Image 3 – List of US Airports dataset

Copy the following code snippet to load in the library and the data — don’t forget to change the working directory and the API key:

Here are the first six dataset rows:

Image 4 - Head of the US Airports dataset

Image 4 – Head of the US Airports dataset

The dataset has everything needed for map visualization. Latitude and longitude are generally everything you need, but you’ll see how the additional columns can make the map richer.

Basic interactive Google Map with R

Let’s start with the basics. We’ll add markers to every latitude and longitude combination from the dataset. You can use the google_map() function from googleway package to specify the API key and the dataset, and then call the add_markers() function to add the points:

Image 5 - A basic map of US airport locations

Image 5 – A basic map of US airport locations

There are many built-in options you don’t have to worry about. You can zoom in, zoom out, change the map type, and even use Google Street View! You can also tweak how the markers look like. We’ll explore how, next.

Change marker color

The googleway library is quite restrictive with marker colors. You can go with red (default), blue, green, or lavender. To make matters worse, the package requires an additional column in the dataset for the color value. It’s useful if you’re using some conditional logic to color the markers, but a complete overkill if you aren’t.

Image 6 - Changing the marker color

Image 6 – Changing the marker color

Long story short, you’re quite limited in color selection if you’re using google way to build interactive Google Maps with R.

Add mouse over

Adding mouse over effect to your interactive Google Maps with R is strongly advised if you want to make maps users will love. The mouse over effect represents what happens as the user pulls the mouse cursor over a marker.

The code snippet below shows you how to add an airport name, stored in the AIRPORT column:

Image 7 - Adding mouse over text

Image 7 – Adding mouse over text

Mouse over effect can become a nightmare if your map has many markers, or if there’s almost no spacing between them. If that’s the case, you might want to consider info windows instead.

Add info window

Unlike mouse overs, info windows will activate only if the user clicks on a marker in your interactive map. Keep in mind — the info window also has to be closed manually by the user.

To spice things up, we’ll add an additional column that contains the airport name, city, and state. You can add and customize yours easily with the paste0() function.

Image 8 - Adding info window on marker click

Image 8 – Adding info window on marker click

It’s hard to tell if info windows are better than mouse overs for this dataset, as markers aren’t packed extremely tightly. Go with the one that feels more natural.

You now know the basics of interactive Google Maps with R and googleway. Next, you’ll see how to embed them to an R Shiny dashboard.

Add Interactive Google Maps to R Shiny Dashboards

You’ll now see how easy it is to add interactive Google Maps to R Shiny dashboards. The one you’ll see below allows the user to specify a list of states from which the airports are displayed.

Keep in mind:

  • App UI — You can use the google_mapOutput() function as a placeholder for the interactive Google map.
  • App Server — Use the renderGoogle_map() function to display the map. The data is prepared earlier as a reactive component to match the user-selected states and display the airport, city, and state info on mouse over.

Here’s the entire code:

Image 9 - US Airports R Shiny dashboard

Image 9 – US Airports R Shiny dashboard

The googleway library configures the location and the zoom level automatically for you. The map was zoomed to New York by default and changed instantly when we added more states. Overall, we have a decent-looking map for 30-something lines of code.

Learn how to use R to analyze large geolocation databases and build a Corona Risk heat map – CoronaRank.

The questions left to address are the speed and the looks. Luckily, we have dedicated articles on these topics, written with having R Shiny dashboards in mind:

These two are excellent reads if you’ve enjoyed this article, as they allow you to take your R Shiny dashboards to the next level.


Conclusion

And there you have it — How to build, tweak, and style interactive Google Maps with R. You’ve learned a lot today, but there’s always room to improve. Here are a couple of challenges you can do next:

  • Use custom icons instead of the default markers
  • Show airports as a heat map instead of markers
  • Calculate distances between airports using the Google Maps API

Reference the official documentation if you decide to work on these challenges. And feel free to share your results with us – @appsilon. We’d love to see what you come up with.

If you’re looking for a faster way to showcase your map online, check out our Shiny Dashboard Templates. They’re free to use and a great launching point for your project.



Reach out to Appsilon

Anirban Shaw
Anirban Shaw
R/Shiny Developer