Creating a Google Maps API Key

Stockist uses third-party map providers to power the map imagery in your store locator, and one popular option we support is Google Maps. If you'd like to use Google Maps for the map in your store locator, Google requires that you obtain an "API key" for your website.

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.

Short on time (or patience)?
Setting up a Google Maps key isn't difficult, but it's a bit of an involved process that winds through some fairly technical Google dashboards. Stockist supports another option for map imagery called Mapbox that's much easier to set up. If you'd like to save some effort, consider setting up Mapbox in your Stockist account instead. You can always switch map providers later!

Creating your key

Follow these steps to create your Google Maps 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:

Don't want to provide billing details with Google? We also support Mapbox maps, which are much easier to set up and don't require a credit card. 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 Map provider 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.