Store Locator Widget Quick Start

How to customize your Store Locator Widget

  1. Introduction
  2. Supported Languages & Unit Systems
  3. Display
  4. Map
  5. Search assets
  6. Initial State
  7. Google Maps


The Woosmap Store Locator Widget is a one-stop-shop to create a Store Locator displaying the basemap that best fit your needs from three different map providers: Woosmap Map, Google Maps, or Baidu Map. Our aim is to help you to integrate a powerful store locator on your website in the simplest way possible. To match your preferences and website’s graphic style, all the properties of your Store Locator Widget can be customised client side thanks to the setConf() method. Here is a quick overview of some of the properties you’ll be able to set in your integration code ( see Store Locator Widget Reference for more details).

Supported Languages & Unit Systems

The Store Locator Widget is currently available for the following languages : French, English, Spanish, German, Italian, Portuguese, Dutch, Catalan, Brazilian Portuguese, Russian, Chinese, Japanese, Ukrainian, Hebrew and Polish. In addition to language, the Unit System for distance (meters /miles) and the period for opening hours (12h/24h) can be set. Because you may have a multi-national brand and assets across the world, you can also set the language on Store Locator Widget load. Though, a unique Store Locator can be displayed in all your websites/pages in adequate language thanks to a simple parameter in the integration code. See Store Locator Widget Reference for more details.


To keep up with your brand identity, the Store Locator Widget accepts some configuration parameters. A primary color can be set. This color applies on labels and background for the Search and Results panel. To complete display customisation, the Store Locator Widget is also compatible with Google’s basemap custom configuration. Here are some examples you can adapt.

Tiled View Tiled View Tiled View


A particular viewport can be specified for the map openning. You can ask to get a centered & zoomed view on map load that can render all your store locations. To assure maximum readability and navigation, the map offers two types of display for assets :

These two views are complementary. By default, on map load the view is set to display the entire network locations centered in the frame. The Store Locator Widget can also be configured to define a zoom level related to the user’s position. Depending on your store density you can ask for a specific value or let us set the optimal zoom level for the best rendering.

Simplified view

Useful to render large amount of assets or high store density. This view makes the map displayed faster and provide a clean view. On this view, dots colors can be set: a unique color for all store or colors depending on types of service you may have on your network (eg. drive, click and collect, etc).

Tiled View

Markers view

Useful to render detailed markers (branding, etc) after a specified level of zoom (breakpoint). For the following three kind of markers, you can define images of your choice, or default ones if not specified, as well as set a custom size and hotspot.

Store Marker

Marker View

For store location.
Could be based on types

Selected Store Marker

Selected Store

For selected store location.
Could be based on types

Location Marker

Marker View

For user and search location

Search assets

Number of assets fetched from a user search can be set between 1 to 10. By default value is 3 assets. In addition to the number of assets, the search can be bounded in a setable radius to take into account your store density.

Initial State

You could define an initial state for the Widget by using the public javascript methods. Here are the allowed initial states:

Google Maps

Your Google Maps Platform license can be set by providing your Google Maps API Key in the Store Locator Widget configuration (MapsConf Object Specification). Google Maps API key can also be set as usual and independently of the Store Locator Widget if used elsewhere in the targeted page.

Was this article helpful?
Have more questions? Submit a request