> For the complete documentation index, see [llms.txt](https://support.storefront.co.za/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.storefront.co.za/features/stores/store-settings/shopping-experience/google-maps.md).

# Google Maps

Connecting Google Maps lets your store work with addresses properly: suggesting them as a customer types, pinning them accurately, and powering your store locator. It is also required before local delivery can work, because local delivery needs to measure the distance to a customer's address.

### Before You Start

You need a Google Maps API key. You can set one up through the [Google Maps Platform](https://developers.google.com/maps/get-started). The relevant APIs must be enabled in your Google Cloud Console.

### Settings

* **Google Geocoding** - precise address pin-drop at checkout.
* **Google Places** - powers the store locator, address selection and checkout address lookup.
* **Enable New Places API** - uses Google's newer address search component on the store locator. This requires the new Places API to be enabled in your Google Cloud Console.

### How to Enable Google Maps

1. Set up your Google Maps API key and enable the APIs you need in the Google Cloud Console
2. Select the store you want to enable Google Maps on
3. Click on Manage Store Settings underneath Settings
4. Open Shopping Experience
5. Open the Google Maps section
6. Enter your Google API key
7. Switch on Geocoding and Places as required
8. Save your changes
9. Test an address lookup at checkout on your storefront to confirm suggestions appear

{% hint style="warning" %}
If address lookup or your store locator stops working, the usual cause is the relevant API not being enabled on the Google side, or the key having usage restrictions. Check your Google Cloud Console before assuming the key is wrong.
{% endhint %}

Local delivery will not calculate distances without Google Maps enabled. See [Local Delivery](/features/stores/shipping/local-delivery.md).