Creating a Google Maps API Key

Stockist uses Google Maps to power the map in your store locator. Google requires that each website owner obtain an "API key" for their website in order to show a Google map.

The steps below will guide you through creating a Google Maps key. Once created, you'll add this key to your Stockist account so that your store locator can display a map on your site.

New in September 2019: We now support the option to use Mapbox maps with your locator instead of Google Maps. Mapbox offers a similar map experience and a similar free usage allowance, but with a much easier setup process. You can find more details and setup instructions in this article.

Creating your key

Follow these steps to create your key:

  1. You'll need to be signed in to a Google account in order to create a key.

    Please check what you see on the  Google Account page:
    • If you see a sign-in screen, sign in to the Google account you'd like to use to create your key.
    • If you're signed in but don't want to use that account, sign out, then sign back in with the right account.

    Once you're signed in (the page will say Welcome, [your name]), continue below. Take note of which account you're signed in to, in case you need to make any changes later.

  2. Open the Google Maps Platform homepage to start the process.
  3. If a popup doesn't appear immediately, click Get Started in the top-right corner of the page:
  4. In the popup that appears, select all three checkboxes next to Maps, Routes, and Places, then click Continue:
  5. In the Select or create project dropdown, choose Create a new project, then pick a memorable project name (e.g. Stockist Store Locator). This name won't be visible to your customers. Once you've chosen a name, click Next.

Setting up a billing account

At this point, you may be prompted to set up a billing account, as shown below:

It's important to note that the Google Maps services aren't provided to you by us (Stockist), they're  provided directly to your website by Google. Google offers each website a certain level of free map usage every month, which is enough for approximately 10,000 - 15,000 visits to your locator page each month. 99% of Stockist clients use less than Google's free limit, so for most Stockist clients there is no additional cost beyond that of your Stockist plan.

However, Google requires that each website set up a billing account in order to use their maps, even if you never use more than the free credit. If your site uses less than the credit, you won't be charged.

After setting up billing, you may also want to set up the following with Google to track or limit your map usage:

New in September 2018: Don't want to set up billing with Google? We now support Mapbox maps, which have a much simpler setup process to get a key. You can find more details here.

To finish creating your Google Maps API key, follow these steps:

  1. In the prompt that appeared, click Create Billing Account:
  2. Confirm your country and the other requested details, then click Agree and continue:
  3. Choose an account type (Business or Personal, depending on who you're setting your map up for), then fill out the requested billing details. When you're done, click the button saying Continue or Next or similar (the actual button text changes frequently as Google experiments with their sign-up page).
  4. Now that your billing account is set up, you'll be prompted to finish enabling the Google services. Click Next:
  5. Almost done! After a moment, you'll see a prompt displaying your new Google Maps key:
  6. Select the key and copy it, or click the copy button on the right-hand side. Then, paste the key into the Google Maps API Key page on your Stockist app dashboard and click Save.

Once your key has been added to your Stockist account, your store locator will automatically begin displaying your map.

Next steps

Optionally, you may also want to set up the following with Google:

You can also  read more details about how Stockist uses Google Maps and how the free usage limit is calculated.