LAYER SETTINGS

Home navigation:   »no topics above this level«

LAYER SETTINGS

NPGeoMap

Version 3.1.54, 25.01.2019

Layer
groupname, opacity, excludefromzoom, minzoom, maxzoom
scaleonzoom, scalebasezoom, excludefromzoom

Data
selectable, orderexpression, popupvariable, path
areacovertoselect, renderemptycoordinates, proj4definition, caching

Format
kpiformat, usemetricunits, unitsFactor

Label

Image

Design

Only for MARKERS:
Heatmap
Cluster

 

The values for nearly all features may be entered as calculated
formulas or variables.

For detailed information about notation in this dialogs go to chapter The fx‑editor.

LAYER SETTINGS

SETTING / VALUES

EXPLANATION

 

 

Layer

 

groupname

text

assign Layers to groups - use groups for selection and zoom settings

opacity

number

defines opacity of the whole(!) layer in degrees (0-360), including Images, Labels, Arrows...
inside MAP/MARKER/LINE SETTINGS opacity of each record can be set

MARKER only

scaleonzoom

number

scalebasezoom

number

0= no scaling,
1-100 = percentage value to increase or decrease Marker size relative to zoom(level)

"scaleonzoom":
zooming out makes Markers smaller, zooming in makes them bigger

"scalebasezoom":
zoomlevel on which labels are precisely the size set in MARKER SETTINGS, from this basis on the "scaleonzoom" works

excludefromzoom

true/false

exclude this particular layer from the automatic zoom/view

minzoom

number

maxzoom

number

set a zoomlevel - the whole Layer won't be visible above ("minzoom") or beneath ("maxzoom")
(-1= setting disabled)

 

 

Data

 

selectable

true/false

defines if objects of this layer are selectable

MAP and LINE only

areacoveredtoselect

number

how much of the area of a Polygon or the length of a Line (in %) must be covered for the selection to take effect

orderexpression

number

objects of this layer will be ordered/sorted according to this setting,
if objects overlap, first objects in this order are beneath and last ones on top

popupvariable

text

Feature for setting Qlik variables for further use in Qlik objects. The variables are filled with a click on an object or a legend segment in NPGeoMap with the respective values.
It is used to display any Qlik visualizations in NPGeoMap PopUps or to reduce the data in Qlik objects with a simple click on the map (without taking actual selections).

By clicking on an object in NPGeoMap the variable is filled with the respective dimension value. (For example clicking on a Marker fills the variable with it's dimension value.)
When clicking on a Radial Sphere or an Isochrone, all values of the Markers or Polygons within this Sphere will be written in the variable. The same goes with clicking on a Legend segment (due to QlikView this option is limited to 20,000 values - no limitation in Qlik Sense).

Example Polygon:
The map shows the US states and their names are set as Polygon dimension.
A click on the state Texas for example now fills the variable with its ID "Texas". Now configured QlikView visualizations are reduced to the value "Texas".
If additionally a PopUp is set for this map with the feature "qvchart", the QlikView visualization in the opened PopUp as well is reduced to "Texas".

Example Legend:
The map from above is now dynamically colored by using Classes, for example from good to bad sales with green-yellow-red.
Now a click on the green segment in the legend fills the variable with the dimension values from all green Polygons, like "Texas, California, New York, Florida".

A simple click on an object is the trigger for filling the variable.

Basically this feature is enabled as soon as the variables are set in the Qlik application as well.

Make sure to press  F5  for a refresh after setting the variables, in order to let the changes take effect.

The best is to use aggregation formulas for limiting the displayed values within Qlik expressions:

Sum({<ID = {$(#NPG_MarkerValues)}>} sales)

This Example sums up all "sales", where the ID contains the values from the element list of the variable NPG_MarkerValues.

You can find more information about this formula in the QlikView Manual in chapter "Set Analysis".

In this way Qlik charts and visualizations can be steered by NPGeoMap and displayed in its PopUps.

MARKER and LINE only

renderemptycoordinates

true/false

Faulty Marker or Line coordinates just won't be displayed by default. They are faulty, if either the latitude or the longitude is missing or even both.
With this feature you can activate them to be displayed as well. The Marker coordinates will then appear exactly at zero - this is the point on earth, where the Greenwich meridian and the equator meet (located somewhere near the west African coast).

Therefore all faulty Marker coordinates can be located easily. Since PopUps automatically sum up Markers that are located exactly at the same point, you can enable them in the settings and then just read out which Markers are affected.

MARKER and LINE only

proj4definition

text

If the Marker coordinates are not in WGS84 format, the actual format can be used by setting the so called "Proj4" code (of respective map projection) here.
In this way the Marker coordinates can be used directly in the NPGeoMap object.
(This setting takes no effect on Path coordinates.)

Example:
Marker coordinates are provided in the Lambert format "EPSG:2204"
The Proj4 code can be determined via spatialreference.org (see screenshot) and set in this feature like:

"proj4definition": "+proj=lcc +lat_1=35.25 +lat_2=36.41666666666666 +lat_0=34.66666666666666 +lon_0=-86 +x_0=609601.2192024384 +y_0=30480.06096012192 +ellps=clrk66 +datum=NAD27 +to_meter=0.3048006096012192 +no_defs"

 

click to expand

click to expand

Learn more about Proj4 on the Internet.

Paths

maps (MAP and LINE only)

path

images

path

This feature allows to store map or image files in a customized place, even on an external server.

Map files in NPGeoMap are loaded from the path you set here.
The default map path is "\Extensions\maps". If you use an external server, make sure CORS is set correctly.

For Images set a web path/URL or use a folder inside the NPGeoMap image directory:
"...QlikView\Extensions\Objects\NPGeoMap_v3\NPGeoMap_v3_Basic\images\[yourimagepath]"

MAP and LINE only

Caching

savechachedmapsfromserver

true/false

maxcachedays

number

By default NPGeoMap works with a system that caches the Maps (used in the object) and saves it inside the browser memory. This increases the performance a lot, especially when big map data is used.
In case the browser memory on your server is limited and quite small, you may turn off the caching here to save the memory space.

This setting may be restricted to a specified duration.
After a defined amount of days the Cache will be cleared automatically and all required Maps will be reloaded.
If you set it to "0 days", the cache will never be cleared automatically. This means for example if new Map files are available, they should be renamed (versioned) or you have to clear the map cache manually.

 

 

Format

 

kpiformat

number

default format of KPI values - referes to setting inside MAP/MARKER/LINE SETTINGS
comma symbolizes thousands separator, point stands for decimal delimiter and the zeros after the point are the decimal places

usemetricunits

number

Defines the basically used unit system for calculated numbers (like the displayed numbers in the legend, in selection areas or distance information) in NPGeoMap:

 1 = use metric system (default)

    meters, kilometers

 0 = US/UK system (United States customary units/Imperial units)

    miles, feet

unitsFactor

number

sets the unit for calculated distances

1= kilometers/miles (default)
0= meters/feet

 

 

Label

 

MAP only

multipolygon

true/false

Labels of Multipolygons can be displayed on the largest/first Polygon of each record (false = default) or on all Polygons (true).

If several Polygons have the same ID, they end up to a Multipolygon, e.g. the shape of Italy with Sicilia, Sardegna and some other small islands.

MAP and LINE only

overflow

true/false

true  = labels are always visible, even when they overlap the endings of the Line (label longer than line)

false = labels are only displayed, when they fit along the Line (when zooming out and Lines are getting too short, labels disappear)

font

text

set font-size and font-family like in HTML

color

color

When setting colors you can use Hex-Codes, HTML color names or RGB
Example: color red = #FF0000 or red or RGB(255, 0, 0)
(Detailed information in chapter The fx‑editor)

stroke

number

thickness of a stroke around the letters of labels in pixels

strokecolor

color

When setting colors you can use Hex-Codes, HTML color names or RGB
Example: color red = #FF0000 or red or RGB(255, 0, 0)
(Detailed information in chapter The fx‑editor)

MARKER SETTINGS:

markerheading

true/false

LINE SETTINGS:

uselineheading

true/false

labels head just like their respective Markers or Lines do (along the Line)

labelposition

number

centerLeft=1, centerRight=2, centerCenter=3, topLeft=4, topRight=5, topCenter=6, bottomLeft=7, bottomRight=8, bottomCenter=9

labeloffsetx

number

labeloffsety

number

set offset for labels along x-axis in pixels (LINES: the x-axis is always along the Line)

scaleonzoom

number

scalebasezoom

number

0= no scaling,
1-100 = percentage value to increase or decrease label size relative to zoom(level)

"scaleonzoom":
zooming out makes Markers smaller, zooming in makes them bigger

"scalebasezoom":
zoomlevel on which labels are precisely the size set in "font", from this basis on the "scaleonzoom" works

minzoom

number

maxzoom

number

set a zoomlevel - labels are not visible above ("minzoom") or beneath ("maxzoom")
(-1= setting disabled)

 

 

Image

 

LINE only

imageheading

number

imageposition

number

Images head just like their respective Lines do (along the Line)

position on Line:
1 = start/beginning of Line,
2 = center,
3 = end of Line

MAP and LINE only

scaleonzoom

number

scalebasezoom

number

0= no scaling,
1-100 = percentage value to increase or decrease image size relative to zoom(level)

"scaleonzoom":
zooming out makes Images smaller, zooming in makes them bigger

"scalebasezoom":
zoomlevel on which labels are precisely the size set in MAP/LINES SETTING, from this basis on the "scaleonzoom" works

MAP and LINE only

minzoom

number

maxzoom

number

set a zoomlevel - Images are not visible above ("minzoom") or beneath ("maxzoom")
(-1= setting disabled)

chart

colors

color array

stroke

number

strokecolor

color

set default color, stroke thickness and stroke color for Image Charts

When setting colors you can use Hex-Codes, HTML color names or RGB
Example: color red = #FF0000 or red or RGB(255, 0, 0)
(Detailed information in chapter The fx‑editor)

 

 

Design

 

MAP only

defaultcolors

color array

default colors for polygons

When setting colors you can use Hex-Codes, HTML color names or RGB
Example: color red = #FF0000 or red or RGB(255, 0, 0)
(Detailed information in chapter The fx‑editor)

selected

color

color

This color is used as fill color for marked objects while making a selection - this means before you release the control key or confirm in selection menu with the green OK button, selected objects are marked with this color. When selection is done, they turn back to their original color.
The feature is meant to use in case if your original color is the same as the selectedpolygoncolor.

When setting colors you can use Hex-Codes, HTML color names or RGB
Example: color red = #FF0000 or red or RGB(255, 0, 0)
(Detailed information in chapter The fx‑editor)

highlight

active

true/false

stroke (MAP only)

number

color

color

Enables or disables an effect which highlights dynamic objects when the cursor hovers on them.
Hexagons respond to that feature as well (because technically they are also Polygons).
This is especially very useful when Legends are configured - if the cursor hovers on a Legend segment, all objects referring to that segment are highlighted.

click to expand

click to expand

In case the color of the highlight is to similar to the object color (or the same), the highlight color can be set as well - even to get a better contrast.

When setting colors you can use Hex-Codes, HTML color names or RGB
Example: color red = #FF0000 or red or RGB(255, 0, 0)
(Detailed information in chapter The fx‑editor)

 

 

Heatmap

MARKER SETTINGS only

gradient

color array

blur

number

radius

number

enable Heatmap by setting Marker "Type" = 7 inside MARKER SETTINGS

"gradient":
set the colors for a Heatmap melting
default color array: ["#00f", "#00f", "#0f0", "#ff0", "#f00"],

"blur":
set color gradient intensity of the Heatpoints

"radius":
size of Heatpoints in pixels
the size set inside MARKER SETTINGS defines the weighting/intensity of each Heatpoint

click to expand

click to expand

 

 

Cluster

MARKER SETTINGS only
basic settings for Circle and Hexagon Grid Cluster - set colors and sizes inside CLASS SETTINGS

type

number

set kind of Cluster:

0 = no Cluster
1 = Circle Cluster
2 = Hexagon Grid Cluster

circle

distance

number

threshold

number

qvchart

qlik object ID

popup

content

tooltip

content

label

content

opacity

number

bordercolor

color

borderwidth

number

colorsource

number

sizesource

number

set circle cluster

click to expand

click to expand

"distance":
maximum radius of the area of a Cluster Marker - Markers within this distance will be summed up keep in mind that this setting is given in pixels, hence the calculation changes in relation to the zoom level

"threshold":
minimum amount of Markers within the defined Cluster distance, to basically create a Cluster Marker if there are less, Markers are just displayed as set inside MARKER SETTINGS

"qvchart":
set a QlikView Object ID e.g. "CH01" - you can use all QlikView visualizations to display them in the Popup (original size)
use "popupvariable" inside LAYER SETTINGS to restrict the QlikView visualization to the values of the variables, like for example the current selection
more information on setting qvcharts in MARKER SETTINGS

"popup":
information displayed when clicking on Cluster Marker - you can use several NPGeoMap [#Hashtag] variables in here:
[#Info] [#Count] [#Distance] [#Units] [#KPI] (as well as all custom KPI variables, e.g. [#KPIyourname])
more information on setting popups in MARKER SETTINGS

"tooltip":
information displayed when cursor hovers over Cluster Marker - you can use several NPGeoMap [#Hashtag] variables in here:
[#Info] [#Count] [#Distance] [#Units] [#KPI] (as well as all custom KPI variables, e.g. [#KPIyourname])
more information on setting tooltips in MARKER SETTINGS

"label":
label displayed on center of Cluster Marker - you can use several NPGeoMap [#Hashtag] variables in here:
[#Info] [#Count] [#Distance] [#Units] [#KPI] (as well as all custom KPI variables, e.g. [#KPIyourname])

"opacity":
opacity of the fill color in %

"bordercolor":
border color
When setting colors you can use Hex-Codes, HTML color names or RGB
Example: color red = #FF0000 or red or RGB(255, 0, 0)
(Detailed information in chapter The fx‑editor)

"borderwidth":
thickness of border in pixels

"colorsource" and "sizesource":
define if Cluster colors/sizes are calculated based on the amount of Markers or on their respective number values (set inside MARKER SETTINGS "Color%", "Size%" or "KPI")

0 = automatic (if available KPI values, else Color values, else amount of Markers)
1 = amount of Markers
2 = number values of Color settings
3 = number values of KPI settings

hexagon

caption

text

showmarker

true/false

radius

number

qvchart

qlik object ID

popup

content

tooltip

content

label

text

opacity

number

bordercolor

color

borderwidth

number

colorsource

number

"radius":
radius of a Hexagon in kilometers/miles (set inside "unitsFactor")
!Important: since maps are always a distortion of a 3D globe though the Hexagon Grid is displayed evenly over the 2D map, all the Hexagons can't have the exact same "real" distances! therefore use the NPGeoMap Hashtag variable [#Distance] (showing the actual distance of each Hexagon) to avoid false or inaccurate assumptions

"qvchart":
set a QlikView Object ID e.g. "CH01" - you can use all QlikView visualizations to display them in the Popup (original size)
use "popupvariable" inside LAYER SETTINGS to restrict the QlikView visualization to the values of the variables, like for example the current selection
more information on setting qvcharts in MARKER SETTINGS

"popup":
information displayed when clicking on Cluster Marker - you can use several NPGeoMap [#Hashtag] variables in here:
[#Info] [#Count] [#Distance] [#Units] [#KPI] (as well as all custom KPI variables, e.g. [#KPIyourname])
more information on setting popups in MARKER SETTINGS

"tooltip":
information displayed when cursor hovers over Cluster Marker - you can use several NPGeoMap [#Hashtag] variables in here:
[#Info] [#Count] [#Distance] [#Units] [#KPI] (as well as all custom KPI variables, e.g. [#KPIyourname])
more information on setting tooltips in MARKER SETTINGS

"label":
label displayed on center of Cluster Marker - you can use several NPGeoMap [#Hashtag] variables in here:
[#Info] [#Count] [#Distance] [#Units] [#KPI] (as well as all custom KPI variables, e.g. [#KPIyourname])

"opacity":
opacity of the fill color in %

"bordercolor":
border color
When setting colors you can use Hex-Codes, HTML color names or RGB
Example: color red = #FF0000 or red or RGB(255, 0, 0)
(Detailed information in chapter The fx‑editor)

"borderwidth":
thickness of border in pixels

"colorsource":
defines if Cluster colors are calculated based on the amount of Markers or on their respective number values (set inside MARKER SETTINGS "Color%" or "KPI")

0 = automatic (if available KPI values, else Color values, else amount of Markers)
1 = amount of Markers
2 = number values of Color settings
3 = number values of KPI settings