# Getting started

## 1. Installation

* **Access the App:** Navigate to the [SpiceGems Store Locator App on the Shopify App Store](https://apps.shopify.com/easy-store-locator-2) and click "Add app" to integrate it into your Shopify store.

## 2. App Activation

* Open Store Locator App → click on Activate App Embed

<div data-full-width="false"><figure><img src="/files/Bk8A1OxUXKm3au5kxhsV" alt=""><figcaption></figcaption></figure></div>

* SpiceGems Store Locator toggle is already enabled → click **Save** (Top left corner)

<figure><img src="/files/nBnlcG8objpOv0xMgiXs" alt=""><figcaption></figcaption></figure>

## 3. Setting Up Your Map Provider

* Click on Set up Map Provider&#x20;

<figure><img src="/files/fX2WWtRw7n4dshCXOvdR" alt=""><figcaption></figcaption></figure>

* Select a Map Provider → By default, **Openstreet** is selected because it’s a free service.

{% hint style="info" %}
For [**Google Maps**](https://help.spicegems.com/esl-easy-store-locator/google-maps) and [**Map Box**](https://help.spicegems.com/esl-easy-store-locator/mapbox-maps), an API key is required. \
You can **buy an API key** from the respective sites to integrate and utilize the map services from these providers. These map service providers have wider options for Map styling.
{% endhint %}

<figure><img src="/files/DdMR1WwRk7CoQONrWRvf" alt=""><figcaption></figcaption></figure>

To learn more about these Map service providers, check the below links:

* [**Google Maps**](https://help.spicegems.com/esl-easy-store-locator/google-maps)
* [**Map Box**](https://help.spicegems.com/esl-easy-store-locator/mapbox-maps)

## 4. Add Store Locations

* Click on Add Location

<figure><img src="/files/atFN2gOQc9AuW2bCO610" alt=""><figcaption></figcaption></figure>

* Add location – Fill all the details (shown in the snapshot)

<figure><img src="/files/AVLEXADhlU8nAJrobCYu" alt=""><figcaption></figcaption></figure>

[Click here to learn more about adding locations](/esl-easy-store-locator/add-location.md)

## 5. Preview the locations in your store

The integration and configurations are done. The locations are now added to the map and visible in your store.

Click on the Preview button on the App Dashboard to access the map page.

<figure><img src="/files/2HnEJHBmNHeDzR6jS4RJ" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.spicegems.com/esl-easy-store-locator/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.