Map Providers
Choose your map provider and set up your API key
Choosing a Map Provider
Store Locator supports three map providers. Choose the one that works best for your store in Settings > Map Provider.
OpenStreetMap
The default option. No API key required and free to use. Works well for most stores. OpenStreetMap is a community-driven project funded by donations. If you find it useful, consider supporting them.
Google Maps
The most recognized mapping platform. Requires a Google Maps API key.
How to get your API key
- Go to the Google Cloud Console
- Create a new project or select an existing one
- Enable the Maps JavaScript API and Geocoding API
- Go to Credentials and create an API key
- Copy the key and paste it in Settings > API Token
Restrict your API key to your store's domain for security. In Google Cloud Console, go to Credentials, click your key, and add your domain under Website restrictions.
Mapbox
Modern maps with smooth animations. Requires a Mapbox access token.
How to get your access token
- Create a free account at mapbox.com
- Go to your Account page
- Find your Default public token
- Copy the token and paste it in Settings > API Token
Mapbox includes 50,000 free map loads per month.
Switching Providers
You can switch providers at any time in Settings > Map Provider. Your locations and settings are preserved when switching. If you switch to Google Maps or Mapbox, you'll need to enter your API key before the map will display.