Choosing a Map Provider
Store Locator supports two map providers:
Mapbox - Modern, customizable maps with a generous free tier
Google Maps - Familiar interface that customers know
Select your provider in Settings > Map Provider.
Setting Up API Keys
Both map providers require an API key to display maps.
Mapbox Setup
Create a free account at mapbox.com
Go to your Account page and find your default public token
Copy the token and paste it in Settings > Mapbox Access Token
Mapbox includes 50,000 free map loads per month.
Google Maps Setup
Go to the Google Cloud Console
Create a new project or select an existing one
Enable the Maps JavaScript API and Geocoding API
Create an API key in Credentials
Paste the key in Settings > Google Maps API Key
Remember to restrict your API key to your store’s domain for security.
Default Map View
Configure the initial map view when customers first load the store locator:
Default Center - The starting center point of the map
Default Zoom - How zoomed in the map starts (1-20)
Auto-fit to Locations - Automatically adjust the view to show all locations
Map Style
Customize the map appearance to match your brand:
Mapbox Styles
Light
Dark
Streets
Outdoors
Satellite
Google Maps Styles
Standard
Silver
Retro
Dark
Night
Marker Appearance
Customize how location markers appear on the map:
Marker Color - Primary color of the marker
Marker Icon - Default pin or custom icon
Cluster Markers - Group nearby markers at lower zoom levels