How to generate and set a Google Maps API key

Warning: You must have a Google account with billing enabled to generate a key for Google Maps API.

Google Maps requires a special Google Maps API key. Without this key, you cannot display Google Maps on your website. There used to be two separate keys, the Google Maps API browser key and the Google Maps API GeoCoding key. Since Yoast Local SEO 11.9, only 1 Google Maps API key is required.

The Google Maps JavaScript API browser key is used to display maps on your website. Without this key, you’ll see the following error:

Oops! Something went wrong.
This page didn’t load Google Maps correctly. See the JavaScript console for technical details.

Before you can set this API key in your Yoast SEO: Local installation, you’ll need to generate it. This tutorial will show you how to do that.

Table of Contents

Generate a new API key

  1. Go to the Google Maps Platform
  2. Click ‘Get Started’
  3. Check ‘Maps’, ‘Routes’ and ‘Places’
    Google Maps Enable APIs
  4. Click ‘Continue’
  5. If you want to use an existing project, please select it from the list. Otherwise, select ‘Create a new project’ and enter a project name.
  6. Click ‘Next’ to continue
  7. If you haven’t set up your billing account yet, follow the steps Google gives you to set it up.
  8. Click ‘Next’ to enable the APIs for the project
  9. Copy the generated API key from the popup, you’ll need this to set your key later.

View your existing API keys

  1. Go to the Google Maps Platform
  2. If the side menu is not visible, click the three-line (hamburger) menu icon
  3. Click ‘APIs & Services’ (API icon)
  4. Click ‘ Credentials’ (key icon)

If the above steps are not clear enough then please follow the tutorial video from the Google Maps Platform Team below. This video will show you how to generate and restrict API keys.

Add API key to Yoast SEO: Local

  1. Copy the API key you created from the Google Maps Platform.

  2. Log in to your WordPress website.

    When you’re logged in, you will be in your ‘Dashboard’.

  3. Click on ‘SEO’.

    On the left-hand side, you will see a menu. In that menu, click on ‘SEO’.

  4. Click on ‘Local SEO’.

    The ‘SEO’ settings will expand providing you additional options. Click on ‘Local SEO’.

  5. Click on ‘API Keys’. 

  6. Paste the API key you copied in step 1 into the ‘Google Maps API key’ field. 

  7. Click ‘Save Changes’.

If you have trouble displaying Google maps on your site, please verify that the Google Maps Javascript API is enabled in the Google Maps API Manager.

Check to See if Google Maps API Keys are Working

To check to see if your Google Maps are working try adding one using a sidebar widget, a shortcode, or a shortcode button here.

Are Google Maps not working?

If your Google Maps are not working for some reason, be sure to check out our troubleshooting article.

Securing your Google Maps API key

It’s recommended to secure your Google Maps API key against quota theft. In this article, we explain exactly how you can secure your Google Maps API key.

Billing prices

Pricing for the Google Maps, Routes and Places is pay as you go, and you only pay for what you use. You get a recurring $200 credit on your billing account each month to offset your usage costs, and you can also set usage limits to protect against unexpected cost increases.

For a table of Google’s pricing, see Pricing for Maps, Routes, and Places.