Setup Example

When a GIS Explorer is added in the GIS Explorers module, an empty GIS Explorer is created.

To set up the GIS Explorer, you need to perform the following:

The following sections is an example that briefly describes how to set up a GIS Explorer.

Edit Mode

To create these layers and filter controls, you need to be in the GIS Explorer Designer page or edit mode. To go into edit mode, click on the “Edit” button at the upper right corner of the page.

In edit mode, the GIS Explorer page will display and allow edit on the following via their respective icons:

  • Filter Controls (left panel)
  • Map Properties (right panel)

Create Layers

There are three different layers need to be created:

Tile Layer

To add a tile layer to display a map, click on the icon on the right panel. The “Map Properties” dialog box will appear.

In the “Map Properties” dialog box, click on the icon next to “Layers” section to show the sub-sections. Click on the icon next to “Tile Layers” sub-section.

To add a new tile layer, click on the “+” icon below the “Tile Layers” sub-section.

When the new tile layer is added, it is enabled by default (checkbox is selected). To edit the tile layer, click on the “…” icon to display the “Tile Layer” dialog box.

Field Description Input Type Constraints Default Value
Name Unique name of the tile layer. Text field Any text “[New Tile Layer]”
Attribution Defines the attribution text to be displayed at the bottom of the map (optional). Text field Any text Empty
Opacity % Defines how opaque the tile layer outline are in percentage. Text field Integer from 0 to 100 “100”
Use Predefined Selects the predefined tile layer.
Options are:
- Not Selected (blank)
- Default
- Grey
- OS
- Positron
Drop-down list Select from drop-down list Not selected (blank)
URL Defines the location of the map. Text field Any text Empty
Control As Layer If selected, allows tile layer to be controlled as a layer. Checkbox Selected or not selected Not selected

Key in an unique name for the tile layer in the “Name” field.

The “Attribution” field is an optional field which allows you to add an attribution text at the bottom of the map.

The default value for the “Opacity %” field is 100. A lesser value will make the tile layer more transparent and able to see through other layers.

The “User Predefined” field by default is not selected. If any of the values in the drop-down list is selected, it will automatically fills up the fields in the dialog box, replacing any previously values entered. If you wish to enter your own values, ensure to select “blank” for this field.

Key in the location of the tile in the “URL” field.

For the “Control As Layer” field, if unselected, allows for single selection of the tile layer. To allow multiple selection, select this field to treat the tile layer as any other layers. In this case, you may want to reduce the opacity of the tile layer to allow other tile layer to show through.

Click on the “OK” button in the dialog box to save the changes.

In the example below, the predefined value “Positron” is selected and “Control As Layer” field is unselected. Upon saving the settings, the tile layer will appear on the GIS Explorer. If the tile layer is disabled (that is, checkbox on the right of “Positron” is unselected), the map will not be displayed.

You can add more tile layers using the above steps.

Geo Layer

In the “Map Properties” dialog box, click on the icon next to “Geo Layers” sub-section.

To add a geo layer, click on the “+” icon below the “Geo Layers” sub-section.

When the new geo layer is added, it is enabled by default (checkbox is selected). To edit the geo layer, click on the “…” icon to display the “Geo Layer” dialog box.

Field Description Input Type Constraints Default Value
Name Defines the name of the geo layer. Text field Any text “[New Geo Layer]”
Attribution Defines the attribution text to be displayed at the bottom of the map (optional). Text field Any text Empty
Geo Layer Selects the geo layer. Drop-down list Select from drop-down list Not selected
Stroke
Stroke If selected, adds a geo layer outline onto the map with the defined properties. Checkbox Enable or disable Selected
Opacity % Defines how opaque the geo layer outline are in percentage. Text field Integer from 0 to 100 “100”
Color Selects the colour of the geo layer outline. Colour map Select from map “Dim grey”
Weight Defines the weight of the outline of geo layer. Text field Integer from 1 to 50 “2”
Fill
Fill If selected, fills the geo layer with the colour selected in colour palette. Checkbox Enable or disable Not selected
Opacity % Defines how opaque the geo layer outline are in percentage. Text field Integer from 0 to 100 “100”
Color Selects the colour of the geo layer. Colour map Select from map “Dim grey”
Class Name Defines the CSS class. Text box CSS class name None

Key in an unique name for the geo layer in the “Name” field.

The “Attribution” field is an optional field which allows you to add an attribution text at the bottom of the map.

Selects the desired geo layer from the drop-down list in the “Geo Layer” field. The options available for this field depends on the GeoJson file loaded into Ambience.

The “Stroke” field allows you to define the outline of the geo layer, such as its colour, opacity and weight. The “Fill” field allows you to define the fill-in of the geo layer, such as colour and opacity.

Both fields can be enabled or disabled by selecting or unselecting the checkbox of the “Stroke” and “Fill” fields respectively.

The default value for the “Opacity %” field is 100. A lesser value will make the geo layer more transparent and able to see through other layers. This may be useful if more than one geo layer is displayed.

Click on the “Color” field to display the drop-down list and select the desired colour. Alternatively, you can search for the desired colour using the search bar.

Key in the desired thickness of the geo layer in the “Weight” field.

If the “Fill” field is selected, it will fills the geo layer with the selected colour. By default it is unselected.

Click on the “OK” button to save the changes. Upon saving the settings, the geo layer will appear in the map. If the geo layer is disabled (that is, checkbox on the right of “PA” is unselected), the layer will not be displayed.

Setting up the geo layer is optional. You can add more geo layers using the above steps.

Pin Layer

In the “Map Properties” dialog box, click on the icon next to “Pin Layers” sub-section.

To add a pin layer, click on the “+” icon below the “Pin Layers” sub-section.

When the new pin layer is added, it is enabled by default (checkbox is selected). To edit the pin layer, click on the “…” icon to display the “Pin Layer” dialog box.

Field Description Input Type Constraints Default Value
Name Defines the name of the pin layer. Text field Any text [New Pin Layer]
Attribution Defines the attribution text to be displayed at the bottom of the map (optional). Text field Any text Empty
Opacity % Defines how opaque the pin layer outline are in percentage. Text field Integer from 0 to 100 “100”
Geo Datasource
Dataset Selects the geo dataset. Drop-down list Select from drop-down list Not selected
Subset Selects the geo subset. Drop-down list Select from drop-down list Not selected
GeoJson Field Selects the geo JSON. Drop-down list Select from drop-down list Not selected
Group Field Places the output of the dataset./subset into separate groups or data traces based on field selected. Drop-down list Select from drop-down list Not selected
Selection Field Defines the field for selection in the GIS View (optional). Drop-down list Select from drop-down list Not selected
Controlled By Add or remove filter controls for the explorer (optional). Drop-down list Select from drop-down list Not selected
Pins Displays the pins according to the value selected in Group Field. Text field Not editable Empty

Key in an unique name for the pin layer in the “Name” field.

The “Attribution” field is an optional field which allows you to add an attribution text at the bottom of the map.

The default value for the “Opacity %” field is 100. A lesser value will make the pin layer more transparent and able to see through other layers. This may be useful if more than one pin layer is displayed.

For the “Geo Datasource” field, select the appropriate dataset, subset and GeoJSON in their respectively fields. Select the output field in the “Group Field” field. By defining the optional “Selection Field” field, it allows you to use this field for filter control in GIS View in the dashboard. The “Group Field” field can also be used in the same manner.

If there are filter controls being set up, you will see a “+” icon below the “Controlled By” field. In this example, no filter controls has been set up yet. Therefore, no options are available for this field.

The “Pins” field(s) is not editable and it will be automatically populated when the “Group Field” field is defined. It allows you to preview the different types of pins available for this pin layer.

Click on the “OK” button to save the settings. Upon saving the settings, the pins will appear in the map. If the pin layer is disabled (that is, checkbox on the right of “Pin Layer Nationality” is unselected), the pins will not be displayed.

You can add more pin layers onto the map using the above steps.

Click on the “Save” button at the upper right corner of the page to save your settings. By adding the tile, geo and pin layers, a basic GIS Explorer is created.

Create Filter Controls

The pins on the map shows only its location, with no other information. You can use filter controls to display or change some of the basic settings of the pins.

In this example, four common types of filter controls are to be created:

For the other filter controls, refer to Filter Control for more details.

Info Filter

Adding the pin onto the map allows you to view the location of pins. The pins do not provide any information except its location. To provide information on the pins, you can use the “Info Filter” filter controls. One filter control for each type of pin. The “Info Filter” filter controls display the selected information of the pin on the Information Panel at the bottom of the page when the pin is selected.

To add a “Info Filter” filter control, enter into the edit mode. Click on the icon in the Filter Control Panel on the left of the page. The “Control Properties” dialog box will appear.

Click on the “+” icon to add a new filter control.

Click on the “…” icon on the left of the filter control to display the “Control” dialog box. In the “Type” field, select “Info Filter” from the drop-down list. The fields in the dialog box changes according to the selection.

Field Description Input Type Constraints Default Value
Type Selects the type of filter control. Drop-down list Select from drop-down list “Info Filter”
Name Unique name of the filter control. Text field Any text “[New Control]”
Dataset Dataset to be used in the filter. Drop-down list Select from drop-down list None
Subset Subset of the dataset selected. Drop-down list Select from drop-down list
The dataset must be selected first.
None
Group Field Field of the selected dataset to be filtered. Drop-down list Select from drop-down list None
Group Value Value of the field selected in Group Field. Drop-down list Select from drop-down list None
Enable Filters If selected, checkboxes will appear in Information Panel for filtering of the pins. Checkbox Enable or disable Enabled
Column No. Defines the number of columns in the Information Panel. Text field Integers from 1 to 25 “3”
Items Defines the info to be displayed in the Information Panel.
If none is defined, by default all info are displayed.
Drop-down list Select from drop-down list
(more than one can be selected)
Not selected

In the “Name” field, key in an unique name for the filter control.

Selects the same dataset, subset, and group field as in the Pin Layer. In the “Group Value” field, select a value from the drop-down list.

By default “Enable Filters” field is selected. Checkboxes will appear in the Information Panel, allowing filtering of the pins on the map by selecting these checkboxes. Unselect this field if you do not want the filtering function. The checkboxes will not appear in the Information Panel.

In the “Columns No.” field, key in the desired number of columns to display the pin information in the Information Panel.

To display all information on the pin, do not define any items in the “Items” field. The Information Panel will display the information according to the order in the dataset. In the case where there may be sensitive information that you do not wish to show users, you can selective choose the information using the “Items” field.

To do so, click on the text box to display the drop-down list and select a field. To add more items, click on the “+” icon below the text box. A new row will be added. Click on the text box to select another field. Repeat these actions until all desired fields are added.

These fields can be re-ordered by clicking on the and icons. Do note that this will affect the order of the information that will be displayed in the Information Panel.

Click on the “OK” button to save the settings.

Repeat the above steps for the different values in the “Group Value” field for different types of pin (if desired). In this example, there are five different Nationalities in the dataset, one “Info Filter” filter control for each nationality.

Once the “Info Filter” filter controls are created, they can be added into the pin layer.

Pin Icon

The “Pin Icon” filter controls allows you to define the pin colour of a particular group of pins.

To do so, click on the icon in the Filter Control Panel on the left of the page. The “Control Properties” dialog box will appear.

Click on the “n+” icon to add a new filter control.

Click on the “…” icon on the left of the filter control to display the “Control” dialog box. In the “Type” field, select “Pin Icon” from the drop-down list. The fields in the dialog box changes according to the selection.

Field Description Input Type Constraints Default Value
Type Selects the type of filter control. Drop-down list Select from drop-down list “Pin Icon”
Name Unique name of the filter control. Text field Any text “[New Control]”
Dataset Dataset to be used in the filter. Drop-down list Select from drop-down list None
Subset Subset of the dataset selected. Drop-down list Select from drop-down list
The dataset must be selected first.
None
Group Field Field of the selected dataset to be filtered. Drop-down list Select from drop-down list None
Group Value Value of the field selected in Group Field. Drop-down list Select from drop-down list None
Icon Selects the colour of the pin icon. Popup dialog box Select from popup dialog box “black”

Key in an unique name for the filter control in the “Name” field.

Selects the same dataset, subset, and group field as in the Pin Layer. In the “Group Value” field, select a value from the drop-down list.

Click on the “…” on the right of the “Icon” field to display the “Icon” dialog box.

In the “Name” field, change to the desired colour (that is, if red is desired, change the name to “Red”). In the “Icon” field, click on the icon to display the available colours and select the desired colour. You can also search for the desired colour using the search bar.

Click on the “OK” button to save the changes and close the “Icon” dialog box. Click on the “OK” button on the “Controls” dialog box to save the changes.

Repeat the above steps for the different values in the “Group Value” field for different types of pin (if desired). In this example, there are six different Nationalities in the dataset, one “Pin Icon” filter control for each nationality.

The “Pin Icon” filter controls are created and is ready to be added into the pin layer. Do note that the “Pin Icon” filter control works in the background and will not appear in the Filter Control Panel.

Pin Filter

The “Pin” filter control allows you to filter the Pin Icon filter controls that were created. This filter control will appear in the Filter Control Panel.

To add a “Pin” filter control, click on the icon in the Filter Control Panel on the left of the page. The “Control Properties” dialog box will appear.

Click on the “+” icon to add a new filter control.

Click on the “…” icon on the left of the filter control to display the “Control” dialog box.

Field Description Input Type Constraints Default Value
Type Selects the type of filter control. Drop-down list Select from drop-down list “Pin Filter”
Name Unique name of the filter control. Text field Any text “[New Control]”
Collapsible Indicates if the control, if displayed on view mode, can be collapsed and expanded.
This also acts as the “switch” to enable or disable the control. If collapsed, the control is disabled. If expanded, the control is applied. Selected options are retained when collapsing and expanding controls.
Checkbox Enable or disable Enabled
Visibility Indicates if the control would be displayed on the explorer.
Available options:
- Always (always displays the control on the explorer, regardless of usage)
- When Used (only displays the control on a page if at least one explorer on the same page is linked to it)
- Hidden (won’t be displayed regardless of usage)
Drop-down list Select from drop-down list “When Used”
Initial Values Determines the initial set or selected values upon loading in the explorer.
Available options are:
- None
- First
- Last
- All
- Values
Drop-down list Select from drop-down list “None”

Key in an unique name for the filter control in the “Name” field.

Select the “Collapsible” field to allow the options of the filter control to be expandable and collapsible in the Filter Control Panel.

Select the value “When Used” from the drop-down list in the “Visibility” field to allow the filter control to be visible only when the pin layer that includes this filter control is selected. Otherwise, this filter control will remain hidden. This setting is advisable as it will not confuse users, as the filter control will not work with pin layers that do not include it.

Select the desired initial values for the filter control in the “Initial Values” field. If “Value” is selected in “Initial Values” field, key in a value in the text box below it.

Click on the “OK” button to save the changes. Upon saving, the “Pin” filter control appears in the Filter Control Panel on the left.

Once the “Pin” filter control is created, it can be added into the pin layer.

Interval Timer

The “Interval Timer” filter control defines the refresh interval of the map.

To add an “Interval Timer” filter control, click on the icon in the Filter Control Panel on the left of the page. The “Control Properties” dialog box will appear.

Click on the “+” icon to add a new filter control.

Click on the “…” icon on the left of the filter control to display the “Control” dialog box. In the “Type” field, select “Interval Timer” from the drop-down list. The fields in the dialog box changes according to your selection.

Field Description Input Type Constraints Default Value
Type Selects the type of filter control. Drop-down list Select from drop-down list “Interval Timer”
Name Unique name of the filter control. Text field Any text “[New Control]”
Visibility Indicates if the control would be displayed on the explorer.
Available options:
- Always (always displays the control on the explorer, regardless of usage)
- When Used (only displays the control on a page if at least one explorer on the same page is linked to it)
- Hidden (won’t be displayed regardless of usage)
Drop-down list Select from drop-down list “When Used”
Units Defines the units of the interval.
Available options:
- Hours
- Minutes
- Seconds
Drop-down list Select from drop-down list “Seconds”
Interval Defines the interval. Text field Integers greater than 1 “10”

Key in an unique name for the filter control in the “Name” field.

Select the value “Hidden” from the drop-down list in the “Visibility” field to hide this filter control from the users, as there is no selection for this filter control. Alternatively, select the value “When Used” to allow the filter control to be visible only when the pin layer that includes this filter control is selected. Otherwise, this filter control will remain hidden. These two settings are advisable as it will not confuse users as the filter control will not work with pin layers that do not include it.

Select the appropriate time unit from the drop-down list in the “Units” field and key in the desired interval in the “Interval” field.

Click on the “OK” button to save the changes. Upon saving, if the “Interval Timer” filter control is not hidden, it will appears in the Filter Control Panel on the left.

Once the “Interval Timer” filter control is created, it can be added into the pin layer.

Include Filter Control to Pin Layer

Once the filter controls are created, they can be added into the pin layers.

To do so, click on the icon of the Map Properties. The “Map Properties” dialog box will appear. Select the “Pin Layers” sub-section in the “Map Properties” dialog box. Click on the “…” of the desired pin layer.

In the “Pin Layer” dialog box, you may noticed that the “+” icon is displayed below the “Controlled By” field. If there are no filter control created, the “+” icon will not appear.

To add a filter control, click on the “+” icon. Select the desired filter control from the drop-down list. Repeat until all desired filter controls are added.

Click on the “OK” button to save the changes.

Upon saving the changes, the map will change according to the filter controls added.

In this example, all different nationalities have a different pin colour (using the “Pin Icon” filter controls). One “Pin Icon” filter control for each nationality.

The Information Panel at the bottom of the page displays the the selected information of the selected pin (enlarged red pin on the right of the map). The selected information is filtered using the “Info Filter” controls. One “Info Filter” control for each nationality.

In the Filter Control Panel, there are two filter controls. The “Pin Filter Nationality” filter control is created using the “Pin Filter” control and using the “Pin Icon” filter controls as options to filter the pins on the map. The “Interval 10s” filter control refreshes the map every ten seconds. The interval timer filter control does not have any selection.

You can add more to the GIS Explorer, such as proximity search into the Information Panel, tooltip or popups when hovered over the pins.

Layer Control Selection

More than one layer can be added onto the map and they can be turned on or off using the “Layer Control” in the “Map Properties”. To demonstrate the use of the layer control, another set of layers are added onto the GIS Explorer.

To enable layer control, click on the icon on the right panel. The “Map Properties” dialog box will appear.

In the “Map Properties” dialog box, click on the icon next to “Layer Control” to display the properties.

Field Description Input Type Constraints Default Value
Enabled Enables/disables the layer control. Checkbox Enable or disable Enabled
Hide Single Tile If selected, and if one tile layer is selected in the Content field, the explorer will not display the tile layer of the map. Checkbox Enable or disable Disabled
Collapsed If selected, allows the layer control to be collapsed when not in use. Checkbox Enable or disable Disabled
Content Defines which layer(s) to be displayed on the map. Dialog box Selection Not selected

The first three fields may use the default values. To set up the “Content” field, click on the “…” icon below the field. The “Layer Control Content” dialog box will appear.

Field Description Input Type Default Value
Tiles Selects the tile layers to be displayed on the map.
If more than one tile later is selected, the first tile layer at the top will be set as initial value.
Checkbox Not selected
Layers Selects the geo and pin layers to be displayed on the map and set the initial options. Checkbox Not selected

In the “Tiles” section, select the outer checkboxes next to the desired tile layers to enable them. If more than one tile layers are selected, the topmost tile layer will be set as the initial option. You can change this initial option by clicking on the radio button of the desired tile layer.

For the “Layers” section, enable the desired layers by selecting the outer checkboxes. In this case, geo and pin layers. This action will enable the inner checkboxes of the selected layers. Set the initial option by selecting the inner checkboxes of the desired layers. If the tile layers are enabled as layers, the tile layers will appear at the “Layers” section instead of “Tiles” section. In this case, select the tile layers as per geo and pin layers.

Click on the “OK” button to save the settings. The layer control selection will appear at the upper right corner of the map.

If the “Collapsible” field is selected in the “Layer Control Content” dialog box, the “Layer” icon will appear. The layer control selection will only appear when the “Layer” icon is hovered over.

Legend Control

The legend at the bottom left of the map can be enabled or disabled. You can also define how the legend is to be displayed.

To enable legend control, click on the icon on the right panel. The “Map Properties” dialog box will appear.

In the “Map Properties” dialog box, click on the icon next to “Legend Control” to display the properties.

Field Description Input Type Default Value
Enabled If selected, displays the legend onto the map. Checkbox Selected
Position Defines the location of the legend to be displayed.
Available options:
- Top Left
- Top Right
- Bottom Right
- Bottom Left
Drop-down list “Bottom Left”
Collapsed If selected, allows the legend to be collapsed when not in use. Checkbox Not selected
Group By Layers If selected, groups the legend by layers on the map. Checkbox Selected
Columns Displays the legend in the number of columns defined. Text box “1”

The “Enabled” field allows to enable or disable the display of the legend on the map by selecting or unselecting the checkbox respectively.

By default the legend is placed at the bottom left of the map. You can change the location by selecting one of the available options in the “Position” field.

It may not be desirable to display the legend on the map all the time as it may obstruct the view of the map. In this case, you may want to collapse the legend by selecting the “Collapsed” field. In this way, the legend will only be displayed when hovered over.

The list of items in the legend can be grouped together by their respective layers. To do that, select the checkbox in the “Group By Layers” field. That will group the items together according to their respective layer, with a title

The “Columns” field allows you to define how many columns are to be used to display the items in legend. By default, one column is used.

GIS Explorer

The GIS Explorer now has two tile layers, two geo layers, two pin layers and the appropriate filter controls for each pin layer. Upon landing in the GIS Explorer, the Positron tile layer, PA geo layer and Nationality pin layer are displayed.

To switch to or turn on other layers, simply click on the desired radio button or select the checkboxes.

Depending on the selection of the layers, different sets of demographic information can be presented in a single GIS Explorer.