# Mapbox maps

Follow this step-by-step guide to purchase and set up Mapbox map with the app.

## **1. Create a Mapbox Account**

1. Visit the [Mapbox website](https://www.mapbox.com/).
2. Click **Sign Up** and create an account using your email address.
3. Verify your email and log in to your Mapbox account.

<figure><img src="https://3493004268-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCda7k33fJ94C7T44fJOk%2Fuploads%2F0OHzWqLl6arO3iIUgfHq%2Fimage.png?alt=media&#x26;token=6b970667-6a8d-475f-becf-817ff4741a19" alt=""><figcaption></figcaption></figure>

## **2. Set Up a Billing Plan**

1. Once logged in, navigate to the **Billing** section from the dashboard.
2. Add a payment method to activate your account.
   * Mapbox offers a free tier with 50,000 map loads per month. Additional usage will incur charges based on the Mapbox pricing plan.
3. Review and confirm your plan details.

<figure><img src="https://3493004268-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCda7k33fJ94C7T44fJOk%2Fuploads%2FYZ4V6NiIo1oVJt3J2SgA%2Fimage.png?alt=media&#x26;token=5760572f-8792-4705-b78c-66fda6a10e2e" alt=""><figcaption></figcaption></figure>

## **3. Create an API Key**

1. Go to the **Access Tokens** section from the Mapbox dashboard.
2. Click **Create a Token**.
3. Enter a name for your token (e.g., "Store Locator Key").
4. Select **Public Token** if the key will be used for general map features.
5. Under **Scopes**, select the permissions required:
   * **Map Loads**: Allows maps to load in your app.
   * **Geocoding**: Enables address search functionality.
6. Click **Create Token**. Your API key will be generated. Copy this key for later use.

## **4. Add the API Key to the** SpiceGems Store Locator **App**

1. Open the **SpiceGems Store Locator App** in your Shopify Admin.
2. Go to the **Map Provider** section.
3. Select **Mapbox** as your provider and paste the API key into the provided field.
4. Save your settings and verify the map loads correctly in the store locator.

***

## **Frequently Asked Questions**

**1. Is Mapbox free to use?**\
Mapbox offers a free tier with 50,000 map loads per month. Usage beyond this limit is charged based on their pricing plans.

**2. How can I monitor my usage?**\
Log in to your Mapbox account and navigate to the **Usage Dashboard** to track API requests and manage your plan.

**3. What happens if I exceed the free tier?**\
Additional charges will apply based on your usage. Review the Mapbox pricing to understand costs.

{% hint style="info" %}
If you need any assistance regarding the above configurations, please drop an email at **<help@spicegems.com>**
{% endhint %}


---

# 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/mapbox-maps.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.
