Obtaining a Google Maps API Key


New Pricing Plan for Google Maps - July 16, 2018

As of July 16th 2018, new pricing went into effect for Google Maps, Routes, and Places API.  Specific details on the cost associated with each SKU can be found on this pricing plan. Atlas requires 3 Google API Integrations (SKUs), identified in the pricing as SKUs, with a separate per-request cost.  Google currently includes a monthly recurring $200 credit to offset usage cost for Maps, Routes, and Places. 

A billing account, on Google, with an active credit card is required to establish the Google Maps, Routes, and Places API.


Google Maps for Online Directory and Events

The dynamic maps that appear in your Online Directory and Events are powered by Google Maps. To set this up, you will need to complete a one-time set-up of an API key so that Atlas can generate map data using Google Maps. Once you have the key, you will enter that key in Online Directory Settings area to complete the integration.

Visit the Google Cloud Console at https://console.cloud.google.com/ and log in with your Google Account.

Note: If possible, it's best to use a Google account set up specifically for your association (as opposed to your personal account). If the association does not have one, click Create Account.

Setup Google Maps API on Google Cloud Platform

1. Select Menu -> APIs & Services -> Dashboard

2. Select 'Create'


3. Enter 'Atlas' (or your choice) for the Project Name / Select 'No Organization' for the Location -> Create


4. Select 'Billing'

5. Click on 'Link a Billing Account' (button) -> click on 'Create Billing Account' (if prompted)

Follow the steps to create your billing account with an active credit card. 
- For more information on pricing plan, click here.
- For details on establishing a daily cap for requests on each integration (SKU), click here.

6. Select 'Library'


7. Select 'Maps JavaScript API'

8. Select 'Enable

9. Select the <- button

10. In the 'Unused APIs' section, select 'Roads API'

11. Select 'Enable'

12. Select the <- button

13. In the 'Unused APIs' section, select 'Geocoding API'

14. Select 'Enable'

15. Select Menu -> APIs & Services -> Credentials

16. Select 'Create Credentials' -> API Key

17. Select the 'Copy' button (copies key to clipboard), then select 'Restrict Key'

18. Select 'HTTP referrers (web sites) -> then create two entries, replacing <yourdomain.com> with your domain as below:

         - https://*.<yourdomain.com>/*
         - http://*.<yourdomain.com>/*

Make sure to include the leading asterisk, and the ending asterisk, these allow for all pages from your website to access the API key.

That is everything on Google Cloud Console, the API Key should still be saved to your clipboard, so follow the steps below in Atlas.

Adding the API Key to Atlas

Now that you have your API key created and copied, follow these steps to add the Key to your Online Directory Settings:

  1. Go to Admin > Set Preferences > Online Directory Settings > Search Page Settings. The Online Directory Settings window will open.
  2. Click the Map menu drop-down arrow.
  3. Enter your Key in to the Google Maps API Key field.
  4. Click Save Settings at the bottom of the window.The Settings Saved text will appear.

    Note: The following steps repeat the same process for each of the Online Directory pages that can display a Google Map.

  5. Click the Results Page Settings link
  6. Click the Map menu drop-down arrow.
  7. Enter your Key in to the Google Maps API Key field.
  8. Click Save Settings at the bottom of the window.The Settings Saved text will appear.
  9. Click the Listing Page Settings link
  10. Click the Map menu drop-down arrow.
  11. Enter your Key in to the Google Maps API Key field.
  12. Click Save Settings at the bottom of the window.The Settings Saved text will appear.


Common Errors:

RefererNotAllowedMapError    Error   
The current URL loading the Google Maps JavaScript API has not been added to the list of allowed referrers. Please check the referrer settings of your API key on the Google API Console.

See API keys in the Google API Console. For more information, see Best practices for securely using API keys.

- Check to make sure you are allowing access from your main and sub-domains with Atlas. Please enter like the below examples:


An additional error that can present is a window that overlaps the map that asks if the visitor is the site administrator, if you click OK it takes the visitor to a page on Google with pricing information and explains establishing a billing account for Google Cloud Platform.  This is detailed in steps 4-5 and is a requirement as of July 2018.





Was this article helpful?
0 out of 0 found this helpful



Article is closed for comments.

Want some training on Atlas? Sign up today for one of our upcoming training options.