Example code to search a WebApp by location, and output the results on a map or in a list

Prerequisites

• You have read the doc WebApps - Searching by location
• You have WebApp items prepared with location data
• You have a Google Projects API Key - You can either hardcode this, or add it to the 'Integrations' area in Siteglide, please ensure the following settings are enabled:
  • Must have billing enabled on Google Cloud API account
  • Must have "Maps JavaScript API" enabled
  • Must have "Geocoding API" enabled

For more information on setting up Google accounts and projects, see here.

Introduction

In this example we'll show you how to add a location search to a Page, and then output the results of that search both in a list and on a map. Items will display in the result set when they are within the radius of a chosen location. One example of how you can use this is as a Store Locator for a franchise of Shops.

Step by Step

1 - CDN Link the Google Maps JavaScript

2 - Add an HTML Form and JavaScript to take User input to decide starting position and search radius

Two different options are provided in this example:

Current location (using browser default functionality) and desired search radius

Add HTML and JavaScript

A location of their choice and desired search radius

Add HTML and JavaScript

3 - Output the results on the Page in a simple list

Use a Layout of your choice.

{%- include 'webapp', id: '1', use_location_search: 'true', layout: 'default' -%}

4 - Output the results on a map

This relies on there being a layout named 'json'. See the contents of 'json' in the 2nd block of code. Add HTML + Liquid The Liquid makes sure the map is only outputted after the Page has been refreshed by the JavaScript and the correct parameters are available in the URL for filtering the results.

Add JavaScript The following function is triggered by the script from step 1, only after it has finished loading- this occurs because the function's name is referenced in the URL parameter fetching the Script. The code must be placed above the <script> tag from step 1.

Layout 'json':

Full example