Radius Behavior

Store Locator Plus  Radius Behavior is set to “always use” in the base plugin. The Experience and/or Premier Add On packs extend the functionality beyond the basic “Always Use” setting.  This setting impacts how the radius selector is employed and how locations are filtered before being displayed to the user.

The map search radius is set under the Settings /Search tab and the results after search is established under the Settings/Results tab with “Initial Search radius” and can be set to any number which equates to miles radius.

The radius selection options presented to the user in the drop down menu is set under the Settings / Search tab  panel.

Continue reading “Radius Behavior”

Limiting Search Results By Territory

The Premier Add On provides territories for locations.  Each location can have a territory assigned that describes a rectangular area with a boundary specified in miles or kilometers north, south, east, and west of the location.

You can restrict the list of locations a user sees via the Radius Behavior setting in Store Locator Plus.   The options and their influence on results returned is described in Radius Behavior.
Continue reading “Limiting Search Results By Territory”

Importing Locations With Territories

Importing locations with territories follows the same procedure as importing a standard locations file.  As with all location files the format must be a proper CSV file exported using the UTF-8 character set with no special or non-printable characters.

To load the territory data you must have first enabled the territories feature in the Premier Add On.  You will also need to have installed and activated with the Pro Add On or Power Add On for Store Locator Plus.

Your CSV file should add the following five columns to the file.    Make sure you add the field names to the top of each of these new columns as listed here:

  • territory_distance_unit
  • territory_distance_north
  • territory_distance_south
  • territory_distance_east
  • territory_distance_west

Within each column you will want to have the following values:

  • territory_distance_unit can be ‘miles’, ‘km’, or be blank.  If this is not set to ‘miles’ or ‘km’ it will assume the territory is not enabled for this location.
  • territory_distance_north , south, east, and west should be the distance north, south, east, or west from the location that is part of its territory.

The territory boundaries will automatically be calculated for each location during the import.

Premier 4.5 Territory Results Highlight Example

Highlighting Locations Served By Territory

Version 4.5 of the Premier Add On for Store Locator Plus introduces territories to locations.

Once a location is setup with a territory the map markers that are sent back from the server during a user search will include a ‘in_territory’ property set to ‘1’ if the user’s location is within the territory and ‘0’ if not.   An additional ‘in_territory_class’ property will also be set to either ‘in_territory’ or a blank string.   Both settings are part of the ‘data’ property of the location marker.
Continue reading “Highlighting Locations Served By Territory”

Enabling Territory Features

Version 4.5 of the Premier add on for Store Locator Plus introduces territories to locations.

Before you can use the territories features of the Premier add on, you will need to enable the feature under the General / Data tab.   This is off by default to reduce the data storage and processing overhead of Store Locator Plus for sites that do not need territory services.  Go to the General / Data tab and check off “Enable Territory Bounds” and click save.   This will create the necessary data fields and enable territory settings and features within the application.

SLP 4.5 Premier 4.5 General Data Tab
SLP 4.5 Premier 4.5 General Data Tab

 

If you later disable this feature any of the existing location territory data will be retained until you delete the location.    However the location search process will no longer restrict search results to locations within a territory nor output data related to locations being inside or outside of a territory; assuming those features are enabled in the Experience settings.

Location Data

Locations will now show several new fields when managing a location.

Premier 4.5 Editing A Location Territory
Premier 4.5 Editing A Location Territory

Territory Distance Unit – what is the distance unit used with this location to determine the territory coverage.  None disables the territory.

Distance North – how many miles to the north of the location is the northern boundary of the territory.

Distance South – how many miles to the south of the location is the southern boundary of the territory.

Distance East – how many miles to the east of the location is the eastern boundary of the territory.

Distance West – how many miles to the west of the location is the western boundary of the territory.

When the location is saved the Territory Bounds is calculated.   Editing the location will show the location point as well as the territory it covers.

User Experience Settings

Under the experience tab there is a setting the dictates how locations are shown to the user.

Experience Results Functionality settings
Experience Results Functionality settings

By default the standard “find locations within this distance of a user” is used.    Any location that is within the selected radius from the address the user entered is shown on the map.  Site designers and use the Experience Results Layout and Custom CSS settings to highlight locations that service the address the user has entered.

If you check of the Only Show If In Territory checkbox under the Experience / Results tab in the Functionality group the list of locations shown to the user will only include the locations where the user’s address is within the location’s territory.    The radius is still used to limit the results that the server processes.    If the radius is hidden and set to a default value, caution should be taken to set a reasonable radius.   Checking if a point lies within a territory can be time consuming.  First limiting the locations to a reasonable list by first filtering those within a certain distance of the user can sped up processing.

For example, if none of your territories are more than 100  miles from the location you can reasonably set the default radius to be all locations within 100 miles.   This will limit how many locations need to have their boundaries tested to see if the user’s address is within.  This will improve your territory matching performance.