Store Locator Widget Quick Start

How to customize your Store Locator Widget
  1. Introduction
  2. Supported Languages & Unit Systems
  3. Display
  4. Map
    1. Simplified view
    2. Markers view
  5. Search assets
  6. Initial State
  7. Google Maps


The Woosmap Store Locator Widget is a one-stop-shop to create a Store Locator based on Google Maps API. Our aim is to help you to integrate a powerful store locator on your website in the most simplest way possible. To match your preferences and website’s graphic style, several properties of your Store Locator Widget can be customised by the Woosmap team. Here is a quick overview of what you can ask to the Support Team. Some properties can be set direct in your integration code. This allows you to create duplicate versions of the Store Locator Widget to be used in other websites. (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, Dutch, Catalan, Brazilian Portuguese, Russian, Chinese and Japanese. 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 declined 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 exemples we can adapt for you.

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 for Work license can be set by providing your Google Maps client Id (Public Key). According to your license, Google Places can be activated on demand to use autocomplete search. Additionnally to your Google Maps for Work settings, you can get a Channel parameter that will help you to monitor your maps credits consumption. Without a Client Id, The Woosmap Store Locator Widget will use Google Maps Public license with standard limitations