---
title: "How to get a Google Maps API key for the pickup point map"
description: "Create a Google Maps key and add it to ShipDock so customers can pick their pickup point on a map."
url: https://help.shipdockapp.eu/en/articles/10591817-how-to-get-a-google-maps-api-key-for-the-pickup-point-map
collection: "Pickup points"
updated: 2026-11-19
language: en
---

# How to get a Google Maps API key for the pickup point map

Create a Google Maps key and add it to ShipDock so customers can pick their pickup point on a map.

With your own Google Maps key, customers get a _Select from map_ button that opens a map of pickup points. The pickup point list and search work without a key.

## Before you start

-   The map is used in checkout on Shopify Plus and on the Thank you and Order status pages in **List with Map** mode.
    
-   **Banner** mode shows the courier's own map and the cart widget has its own map. Neither needs this key.
    
-   You need a Google account with a billing account in Google Cloud. Google bills map usage to your Google account. See [Google Maps Platform pricing](https://mapsplatform.google.com/pricing/?hl=en_US).
    
-   On stores without Shopify Plus, set **Display mode (TY / OS page)** to **List with Map** first. Otherwise the **Google Map APIs** card is hidden.
    
-   Switching the mode needs a paid ShipDock plan.
    

Mode setup: [How to choose the pickup point widget display mode](https://help.shipdockapp.eu/en/articles/11530648.md).

## Create the key in Google Cloud

1.  Sign in to the [Google Cloud console](https://console.cloud.google.com/) and select a project, or create one.
    
2.  If the project has no billing account yet, set one up. This video shows how:
    

3.  Open the [API Library](https://console.cloud.google.com/apis/library), find **Maps JavaScript API** and click **Enable**. It is the only Google API ShipDock needs. You don't need Places.
    

![Maps JavaScript API in the Google API Library with the Enable button](https://staticfiles.gleap.io/helpcenter/68949ce73cfde7b987f63c30/20250808130225_6429.png)

4.  Open [Credentials](https://console.developers.google.com/projectselector/apis/credentials), create an API key if you don't have one yet, and copy it.
    

![Google shows the new API key](https://staticfiles.gleap.io/helpcenter/68949ce73cfde7b987f63c30/20250808130225_2108.png)![Credentials page: Edit API key](https://staticfiles.gleap.io/helpcenter/68949ce73cfde7b987f63c30/20250808130225_3148.png)

5.  Edit the key. Under **Application restrictions**, choose **Websites** and add:
    
    -   `*.yourdomain.com` and `yourdomain.com` (replace with your store's domain)
        
    -   `*.myshopify.com`
        
    -   `https://shopify.com/*`
        
    -   `https://shop.app`
        

![API key restrictions: Websites with the store domains, API restricted to Maps JavaScript API](https://staticfiles.gleap.io/helpcenter/68949ce73cfde7b987f63c30/20250808130225_8139.png)

6.  Click **Save**.
    

## Add the key to ShipDock

1.  In ShipDock, open **Settings → Widget (Pickup points)**.
    
2.  In the **Google Map APIs** card, paste the key into **Public Api Key**.
    
3.  Click **Save**.
    

![Google Map APIs card with the Public Api Key field](https://staticfiles.gleap.io/helpcenter/68949ce73cfde7b987f63c30/20250808130225_8391.png)

Until you save a key, the card shows the banner "API Key is required to show the Map button".

## What your customers see

A _Select from map_ button next to the pickup point list. It opens a map with the courier's pickup points. A click on a marker shows the point's details and a _Select pickup point_ button.

![The Select from map button above the pickup point list](https://staticfiles.gleap.io/helpcenter/68949ce73cfde7b987f63c30/20250808130225_7322.png)

## Troubleshooting

-   **The Select from map button is missing:** check that the key is saved. On stores without Shopify Plus, the display mode must be **List with Map**.
    
-   **The map doesn't load:** check that **Maps JavaScript API** is enabled in the same Google Cloud project as the key and that the project has an active billing account.
    
-   **The map loads only on some pages:** check that the website restrictions include your store's domains from step 5.
    
-   After any change, test the map in checkout (Shopify Plus), on the Thank you page and on the Order status page.
    

## Related articles

-   [How to choose the pickup point widget display mode](https://help.shipdockapp.eu/en/articles/11530648.md)
    
-   [How to add the pickup point widget to the Thank you and Order status pages](https://help.shipdockapp.eu/en/articles/9448644.md)
    
-   [How to add the pickup point widget to checkout (Shopify Plus)](https://help.shipdockapp.eu/en/articles/10695859.md)
    
-   [How to add the pickup point widget to your store](https://help.shipdockapp.eu/en/articles/11516895.md)

## Related

- [How to add the pickup point widget to your store](https://help.shipdockapp.eu/en/articles/11516895-how-to-add-the-pickup-point-widget-to-your-store.md)
- [How to add the pickup point widget to checkout (Shopify Plus)](https://help.shipdockapp.eu/en/articles/10695859-how-to-add-the-pickup-point-widget-to-checkout-shopify-plus.md)
- [How to add the pickup point widget to the Thank you and Order status pages](https://help.shipdockapp.eu/en/articles/9448644-how-to-add-the-pickup-point-widget-to-the-thank-you-and-order-status-pages.md)
- [How to let customers choose a pickup point in the cart](https://help.shipdockapp.eu/en/articles/11764760-how-to-let-customers-choose-a-pickup-point-in-the-cart.md)
- [Cart widget: limits and how checkout behaves](https://help.shipdockapp.eu/en/articles/11764798-cart-widget-limits-and-how-checkout-behaves.md)
