Skip to content

Account Setup : MapMyStores Google API Key (Store Locator)

← Account Setup
It is possible you already have a Google Cloud Platform (GCP) account setup if you are using Google APIs for other projects, such as your website or a different map you used to use. If so, you can skip to ‘Enabling the Appropriate APIs' below. 

If your company has a Google Business Account (not an Individual account) already setup you will most likely want to tie the billing account for the new GCP account to that billing account.  

Remember GCP gives you a $200/month credit towards the use of all of their APIs, so you should not incur any usage fees as long as you receive approximately 25,000 or less requests on your MapMyStores implementations each month.

If your company does not have a Google Business Account, no problem, follow the steps below to setup your GCP account and billing at the same time.

Creating a GCP Account


In a browser, navigate to https://cloud.google.com. Click 'Get started for free'. 


Select your country, check the 'Terms of services' checkbox, and click 'AGREE AND CONTINUE':

On the next page, it will either allow you to link to an existing Google billing account, or create a new one. Once you have entered/updated your company's information (not TurnTree Solutions information) click 'START MY FREE TRIAL':



Enabling the Appropriate APIs

You will have a project automatically created which is called ‘My First Project’.  Click on the Project Settings and then Edit the name to be called 'MapMyStores':



After you have renamed the Project and clicked Save, you can get started by Enabling the Google Maps Platform. This will automatically enable all of the API Services required for MapMyStores and create a key. 

Check the two boxes in the image below for 'Enable all Google Maps APIs for this project' and 'Create budget alerts...' and then press 'Go to Google Maps Platform' button:


When asked to Protect your API Key, select 'HTTP referrers (web sites, c)'  and then key in https://*.turntree.com/* under the Referer and click 'Restrict Key' button:

 


Then click on 'Credentials' on the menu on the left and then click on the API Key that was created to edit the name to 'Places and Maps' and save your changes with only this one change to the name:



Creating the 2 Additional API Keys

Click the menu icon on the top left of the screen, and choose 'Credentials' from the 'APIs and services' dropdown menu:


Click 'Create Credentials' and select 'API Key':


You will see the API Key created. Click 'CLOSE':


After the key is created, use the menu on the far right (3 dots) on the row 'API Key 1' and click 'Edit API Key'


  • Name the second key 'Company Overview Image'
  • Under 'Set an application restriction' click 'HTTP referrers (web sites)'
  • Click 'Add' 
  • Copy and paste in https://*.turntree.com/* 
  • Do not change the API restrictions from 'Do Not Restrict'.
  • Click 'Save'

Once the second key, 'Overview Images', has been added, you will add the final one by clicking 'Create Credentials' on the top of the page and selecting 'API Key' again.

Repeat the steps to 'Edit API Key' by selecting it from the menu on the right next to the words 'Show Key'

  • Name this key 'Geocoding'
  • **Important** For this key, leave ‘Set an application restriction’ set to 'None' since geocoding API keys can not be restricted.  We do keep them secure and never in any HTML page or elsewhere on the web.  
  • **Important** Under the 'API Restrictions' select 'Restrict Key' then search for Geocoding and check the box next to 'Geocoding API' , and search for Places and also check the box next to 'Places API', and click OK.
  • 
  • Click the 'Save' button on the bottom and you will have all the following 3 API Keys:



    • Copy/paste all 3 Keys and their names into an email and send it to support@turntree.com. We will promptly update them in your system!

    Monitoring GCP Billing

    You can monitor your billing from the 'Billing' submenu where you can drill down in 'Reports' to see daily usage and the corresponding monthly $200 credit.

    Feedback and Knowledge Base

    (thinking…)