Location finder
Options
How many results to show | Number of results and pins to return. Default is 100 |
Distance unit of measurement | Which unit to use to calculating distance from the visitor. Options are "miles" or "km" |
Disable Geolocation prompt | Don't prompt the visitor for their location in the browser, requiring them to enter a search manually |
Geocoder components | Pass a series of valid geocoder components to pass on geocoder requests to influence results. Must match a specific format from google. Example: |
Geocode Region Hint | For non-US finders, you can give the finder a hint of the visitor geography so that Google returns more relevant results |
Search input type | Custom search field types. - 5 digit US zip code: only US zip codes (numbers only) |
Distance threshold of results | How far the bounds of the search should show locations. Default is 4000 units (miles or km) |
Redirect one result | If a single location is found and it has a location URL, it will automatically redirect the visitor in the browser |
Default location (Latitude) | This location is used for the initial map center point and is also used if "Search on load" is enabled. Example: |
Default location (Longitude) | This location is used for the initial map center point and is also used if "Search on load" is enabled. Example |
Search on load | Automatically search locations when the location finder loads (uses the "Default location" point) |
Initial search distance threshold | Only apply to the initial loading of locations, this option overrides the normal "Distance threshold of results" to show a wider or shorter distance of locations. Good to use if you want to show "All locations" on initial load, but less (only the closest) locations when someone is entering a search. |
Show infowindow on search | This will automatically expand the infowindow pin for the first result after a search is entered |
Geolocation
Browser-based geolocation requires that the page is served under https (secure).
Currently preview URLs are not served under HTTPS, so a manual search is required for testing on the preview.
URL parameters
Our location finder supports passing URL parameters the location finder page to pre-populate location search queries, filters and other parameters.
Parameter | |
| Location search (zip code, address, city/state) |
| Comma separated list of services tags if your location finder is configured for filtering the results |
Form example
Here is an example of creating a simple form to link to the Location Finder that takes a visitor search location and passes that to the finder.
The form code above can be updated as desired. The only required/important elements are:
Action set to the URL of your location finder -
action="https://www.yourdomain.com/location-finder/"
Form should use GET -
method="get"
<input>
with name ofnear_location
Styling the finder
More information on themes and templates for the location finder:
Store locator theme exampleLast updated