Atlas Pickup Points requires two Google Maps API keys. Google Maps Platform is a paid service, but the free tier is typically sufficient for most stores. See pricing FAQ for details.

Why two keys?

We use two separate keys for security reasons.

The Public API Key is used to display the map. It is sent to the buyer’s browser, which is why we recommend enabling website restrictions to prevent unauthorized use on other websites.

The Private API Key is used for address lookup. Unlike the Public API Key, it is never sent to the browser. It is securely stored in our database and only accessible by you. This key uses the Geocoding API and Places API, which communicate with Google from our server. Website restrictions can’t be used for this key because requests come from our server, not from your website.

Setup

1. Set up Google Cloud

Visit the Google Maps Platform website.
Click Get started and sign in with your Google account.
Select Create a new project when prompted and give it a name.
Set up billing for your project by adding a payment method.
- Note: You won’t be charged until you exceed the free tier.
Once billing is set up, your project will be created and ready for API configuration.

2. Enable required APIs for your project

Enable the following APIs:

3. Create and configure the Public API Key

Go to the Keys & Credentials tab in Google Maps Platform.
Click + Create credentials button and select API key option.
Once API key is created, click on its name to configure.

Configure the Public API Key

Name: Atlas Pickup Points - Public API Key
In Application restrictions section:
- Select Websites option.
- Add the following websites (without trailing slashes):
```
https://your-shop-address.com
https://*.your-shop-address.com
https://your-store.myshopify.com
https://shop.app
https://shopify.com
```
  shop.app and shopify.com are required for the Shop Pay and Shopify Checkout. If you have local or regional domains (e.g., .de, .fr), add them all as well.
In the API restrictions section:
- Select Restrict key.
- Next on the list, select the following API:
  - Maps JavaScript API. If it’s not visible, you need to enable it first.
Click Save button at the bottom of the page.

4. Create and configure the Private API Key

Go to the Keys & Credentials tab.
Click + Create credentials button and select API key option.
Once API key is created, click on its name to configure.

Configure the Private API Key

Name: Atlas Pickup Points - Private API Key
Set an application restriction:
- We recommend not setting any application restrictions for this key. See Why two keys? for details.
API restrictions:
- Select Restrict key.
- Choose the following APIs:
  - Geocoding API. If it’s not visible, you need to enable it first.
  - Places API (New). If it’s not visible, you need to enable it first.
Click Save button at the bottom of the page.

5. Update the Atlas Pickup Points settings

Go to Atlas Pickup Points → Settings and paste both API keys into the appropriate fields.

6. Test the integration

After updating the API keys, verify that the pickup points selection is working correctly:

Enter a new address in your store’s checkout.
Test the following features:
- List view: Ensure that pickup points are loading and visible on the list.
- Map view: Confirm that the map displays tiles and pickup point markers are visible.
- Map search autocomplete: Check that the address autocomplete appears during search.

FAQ

How do I set up Google Cloud billing?

Visit the Google Cloud Billing page. You’ll need to enable billing and add a payment method for the API keys to function properly.

What are the costs associated with using Google Maps APIs?

Google Maps Platform offers two pricing options. See Google Maps Platform pricing for full details.

Pay as you go charges per request with 10,000 free requests per request type. Beyond that:

Dynamic Maps: $7 per 1,000 requests
Geocoding: $5 per 1,000 requests
Places API Place Details Essentials: $5 per 1,000 requests

If you prefer predictable billing, consider a Google Maps Subscriptions plan. Atlas Pickup Points uses Maps, Geocoding, and Places APIs, so you would need the Essentials plan or higher.

Here’s an approximate breakdown of how Atlas Pickup Points uses these APIs:

Loading a pickup points list for a new shipping address: 1 geocoding request
Displaying the map: 1 dynamic maps request Note: User interactions like panning, zooming, or changing map layers don’t count as additional map loads.
Using map autocomplete for a search: 1 place details request

For example, if a customer selects the pickup point shipping option, opens the map, and uses autocomplete to find a location, that’s 3 requests (1 from each type). On the Pay as you go plan, the first 10,000 customers per month are covered by the free tier. For every additional 1,000 customers beyond that, the cost would be $17 ($7 + $5 + $5).

To avoid unexpected charges, you can set up usage caps and budget alerts.

Why isn’t the map loading after I entered the API key?

Common issues include:

Website restrictions: domains ending with / (remove trailing slashes)
Billing not enabled
Wrong API enabled for the key
Check the Atlas Pickup Points → Settings page for any error messages on the API key fields
Open your browser’s developer console (F12 → Console tab) and look for Google Maps error messages — they usually include a link explaining the issue
Another app block that displays a map on the page (such as a different pickup points app) may conflict — remove it and try again

Can I use the same API keys for multiple stores?

Yes. If you have multiple storefronts within the same organization, you can reuse the same API keys across all of them. Just make sure the Public API Key’s website restrictions include the domains of all your stores.

What should I do if my API key is compromised?

If you suspect your API key has been compromised:

Delete the compromised key in the Google Cloud Console immediately
Remove the key from Atlas Pickup Points → Settings and save
Review your Google Cloud billing for any suspicious activity
Contact Google Maps Platform Support if needed
Create new API keys following the setup steps above and enter them in Atlas Pickup Points → Settings

How to create Google Maps API keys