Forms Builder - Configuring a Location Picker

Created by Ben Hayes, Modified on Fri, 10 Apr at 12:07 PM by Ben Hayes

Introduction 

 

About this Guide:  

   

This guide has been written to highlight the options in the Location Picker, what they do, and how these options can be properly configured.   

 

Configuration Options 

   

   

   
   

   

Primary  

   

Setting the 'Primary' box to Yes will Place the location of this location picker into the 'Location' subheading of the SR, instead of the 'Information' subheading, where other form answers are. Setting the Primary box to 'No' will place the location of the SR in the SR's summary, instead of the SR's location.   

   

Below is an example of an SR where a location picker is set to primary. Please note that only one location picker can be set to Primary per form.   

   

   

    

Advanced:  

   

    what3words search   

   

If enabled, this gives the ability for submitters to report a location via what3words. This will denote the location both in the what3words and co-ordinates format if the pin drop is used, which is useful when the location of the incident is not near a property, such as a fly tip in a field. If this option is not enabled, this will mark the location as the nearest property.


If you would like the ability for report locations to be recorded as Co-ordinates or what3words, please contact isupport@abavus.co.uk. Once this is enabled on your system.

   

   
   

   

    Default to Home Address (Web Only)   

   

This setting, if enabled, will automatically fill the location picker with the 'home address' of the submitter. If a home address is not configured for the submitter, it will leave the location picker blank.   

   

    Display map (Web Only)   

   

If enabled, this will display a google-embedded map in the form, which shows an arial view of the location and it's surrounding area. The map can be manipulated to allow the customer more freedom when selecting a location.   

   

This also unlocks the ability for submitters to choose a location 'By dropping a pin on to a map'. This can be done by clicking on the map.    

   

   

   

The behaviour of the pin will work as the following:   

   

If what3words is enabled, the location can be selected anywhere, and will be denoted as co-ordinates, as shown:   

   

   

   

If what3words is disabled, or not enabled on your client, the dropped pin will snap to the nearest available property and will show as a regular address.   


What3Words is a paid feature. If you are interested in enabling this on your production client, please contact ore Support team at isupport@abavus.co.uk

   

    Show only council location   

   

If enabled, only properties within the council's boundaries will be selectable for the submitter.   

   

 

 

    BLPU Classification   

   

If any BLPU classification is selected (sent to the right hand area) the selectable properties will be limited to their BLPU classifications, which can be configured under Administration > Location. For example, in the below configuration, only the Residential BLPU classifications can be selected.   

   

   
   

   

    Location within boundary   

   

Similarly to 'show only council location' , only properties within the boundaries that you select (selectable in the box below this option) will be shown to the submitter. Boundaries can be configured via Administration > Location.   

   

   

    Select boundary area   

   

Here, if 'location within boundary is enabled, the configured boundaries will be able to be selected. This is only enabled if the boundary is sent to the right hand area.   

   

    Boundary message   

   

If 'location within boundary is enabled, and a location outside of the boundary is selected, the message written in this box will display as a pop-up to the submitter.   

   

    Show nearby reports   

   

This, if enabled, pins will appear to represent nearby reports. This can be customised with the below menu that appears when the option is enabled:   

   

   

   

  • Certain information about the report (Displayed Item)    
  • The range near the location where other reports will show (radius),   
  • The age of the reports (submission date)   
  • The date range of the reports (from and to date)   
  • Restrict data to your council - you can choose whether to include reports of nearby councils, or just your council.   
  • Whether the forms are limited to the category of the form (Same category as current incident)   
  • Manual selection of category (Category)   
  • Status and Priority of the nearby SRs (status and priority)   

   

    Map overlay   

   

If enabled, you can select a map overlay for the embedded map. This can be configured via Administration > General > Plugin > Map Overlay   

   

Then, layers from this overlay can be added as needed. This allows form creators to add landmarks, such as streetlights, bus stops, trees and more into the map for the submitter's reference.   

   

   

Validations  

   

    is Required   

   

If this is enabled, the location picker must have an answer for the submitter to proceed to the next page.   

   

    Validation Type   

   

This is more often used for textfields and textareas, and do not necessarily apply to location pickers.   

   

    Error Message   

   

This is the message that will appear when the submitter attempts to go to the next page without entering any information into the location picker.   

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article