Verifying your Google Maps API Key

Stockist uses a key from Google Maps to power the map and parts of the search in your store locator.

Google Maps functionality is divided into several “services” that each enable separate features. Stockist relies on three of them to work properly:
  • Maps JavaScript API: Used to display the map imagery
  • Geocoding API: Used by the search to help match a visitor's search to a specific place  
  • Places API: Used to display address suggestions in a dropdown by the search bar
If your Google Maps key is missing one of these services, you may notice an error on your store locator. This can be a grey box showing Oops! Something went wrong, or a popup near the search bar like the following:
The steps on this page will check that your key is set up correctly.

Enabling the three Google Maps services

Follow these steps to ensure the necessary services are enabled for your key:

  1. Open the Google APIs & Services Library. If needed, sign into the Google account you used to create your key.
  2. Ensure that the project selection dropdown at the top of the page is matches the project that contains the Google Maps key you initially created when setting up Stockist on your website:
  3. Under Maps, click View all:
  4. Click on the Maps JavaScript API tile:
  5. If you see a button labeled Enable, click it to turn on the service. If the button says Manage, the service is already enabled, and you can move to the next step.
  6. Return to the Library by clicking the menu icon in the top-left corner (three horizontal bars next to Google APIs), hovering over APIs & Services, then selecting Library.
  7. Under Maps, click View all:
  8. Click on the Geocoding API tile:
  9. If you see a button labeled Enable, click it to turn on the service. If the button says Manage, the service is already enabled, and you can move to the next step.
  10. Return to the Library by  clicking the menu icon in the top-left corner (three horizontal bars next to Google APIs), hovering over APIs & Services, then selecting Library.

  11. Under Maps, click View all:
  12. Click on the Places API tile:
  13. If you see a button labeled Enable, click it to turn on the service. If the button says Manage, the service is already enabled.
  14. Once you've checked all three services and have ensured that they're all enabled, your locator should be able to display properly.

Checking for key restrictions

If the steps above didn’t resolve the issue, another possibility is that your key has been restricted to only work with certain services.

These steps will ensure the necessary services are permitted for your key:
  1. Open the Credentials page of the Google dashboard.
  2. Find your key in the list and click on the name:
  3. Check for any restrictions under API Restrictions.  You want to ensure that either Don't restrict key is selected or, if Restrict key is selected, ensure that all 3 services (Maps Javascript API, Geocoding API, Places API) are included in the permitted APIs:

Need help?

If the steps above didn't solve your issue, we're here to help! Just click Contact Us at the top of this page.