Map Filters

Map filtering allows administrators to include predefined filters within a configuration profile. These filters can be based on different types, such as layers, shapes, regions, geojson, record location or geolocation , and help users focus on relevant data when interacting with the map.

Field	Description
Filter Condition	Specifies how this filter interacts with others when multiple filters are present: union, subtract, or intersect. This option is only available if more than one filter is defined.
Filter Type	The type of filter to apply: Layer, Shape, Region, or Geometry.
Buffer Distance	The distance (numeric value) to buffer around the selected area.
Distance Unit	The unit for buffer distance: metres, kilometres, or miles.

The options available in the form will change dynamically based on the selected filter type, ensuring that only the relevant configuration fields for that filter type are displayed.

Filter Type	Configuration Fields Shown
Layer	Select a map layer and define the condition(s) that must be met for the filter to apply.
Shape	Choose from a list of your predefined shapes (if any are configured) to use as the filter area.
Region	Enter a search term to find and apply a region-based filter.
GeoJSON	Upload a GeoJSON file or paste GeoJSON code directly to define the filter geometry.
Record Location	Filter based on the current record's address or location coordinates, with configurable timeout settings.
Geolocation	Filter based on the user's current geographic location, with configurable timeout for location detection.

---

Applying a Layer Filter

1. Open the Map Filters tab within the Config Manager.

2. Click the Add Filter button to create a new filter.

3. In the filter configuration panel, set the Filter Type to Layer.

4. Enter the desired Buffer Distance (numeric value) to define how far around the selected layer the filter should apply.

5. Choose the appropriate Distance Unit (e.g., metres, kilometres, or miles) for the buffer.

6. Click Add Layer to select the map layer you want to filter. A modal window will appear.

7. In the modal, select the desired layer or sublayer from the list, then confirm your selection.

8. (Optional) Define any Conditions under which this filter should be applied (e.g., only show features with a certain attribute value). If no conditions are set, the filter will always apply to the selected layer.

9. Review your filter settings in the summary panel. You can edit or remove filters as needed before saving your configuration.

10. Click Save Filter to activate the filter in your configuration profile.

---

Applying a Shape Filter

1. Open the Map Filters tab within the Config Manager.

2. Click the Add Filter button to create a new filter.

3. In the filter configuration panel, set the Filter Type to Shape.

4. Enter the desired Buffer Distance (numeric value) to define how far around the selected layer the filter should apply.

5. Choose the appropriate Distance Unit (e.g., metres, kilometres, or miles) for the buffer.

6. Select a shape from the dropdown. These shapes are populated from the Predefined Shapes tab.

7. Click Save Filter to activate the filter in your configuration profile.

---

Applying a Region Filter

1. Open the Map Filters tab within the Config Manager.

2. Click the Add Filter button to create a new filter.

3. In the filter configuration panel, set the Filter Type to Region.

4. Enter the desired Buffer Distance (numeric value) to define how far around the selected layer the filter should apply.

5. Choose the appropriate Distance Unit (e.g., metres, kilometres, or miles) for the buffer.

6. In the Search Terms field, type the name or keywords for the region you want to filter by (e.g., city, suburb, postcode, or custom region name). The more precise you are, the better the filter will apply

E.g 'Perth, City of Perth, Western Australia, Australia'

7. Click Save Filter to activate the filter in your configuration profile.

---

Applying a GeoJSON Filter

1. Open the Map Filters tab within the Config Manager.

2. Click the Add Filter button to create a new filter.

3. In the filter configuration panel, set the Filter Type to geojson.

4. Enter the desired Buffer Distance (numeric value) to define how far around the selected layer the filter should apply.

5. Choose the appropriate Distance Unit (e.g., metres, kilometres, or miles) for the buffer.

6. You can either paste your GeoJSON code directly into the provided text area, or upload your own GeoJSON (.geojson) file. Ensure your GeoJSON is valid and accurately represents the area you wish to filter.

7. Click Save Filter to activate the filter in your configuration profile.

---

Applying a Record Location Filter

1. Open the Map Filters tab within the Config Manager.

2. Click the Add Filter button to create a new filter.

3. In the filter configuration panel, set the Filter Type to recordlocation.

4. Enter the desired Buffer Distance (numeric value) to define how far around the selected layer the filter should apply.

5. Choose the appropriate Distance Unit (e.g., metres, kilometres, or miles) for the buffer.

6. Configure the Timeout setting to specify how long the system should attempt to retrieve the record's location coordinates. Set to 0 for indefinite waiting, or specify a time limit in seconds.

7. Click Save Filter to activate the filter in your configuration profile.

---

Applying a Geolocation Filter

1. Open the Map Filters tab within the Config Manager.

2. Click the Add Filter button to create a new filter.

3. In the filter configuration panel, set the Filter Type to geolocation.

4. Enter the desired Buffer Distance (numeric value) to define how far around the user's current location the filter should apply.

5. Choose the appropriate Distance Unit (e.g., metres, kilometres, or miles) for the buffer.

6. Configure the Timeout setting to specify how long the system should attempt to detect the user's current location. Set to 0 for indefinite waiting, or specify a time limit in seconds.

7. Click Save Filter to activate the filter in your configuration profile.