fx - ZOOM LEVEL DEFINITION

Home navigation:   NPGeoMap Properties Dialog > Basic Settings > Zoom Settings >

fx - ZOOM LEVEL DEFINITION

Zum deutschen Handbuch wechseln NPGeoMap

Version 2.50.84, 07.12.2017

maxZoom
Feature for setting a maximum zoom to prevent too close automatic zooming.

minZoom
Feature for setting the outer most zoom level.

fixZoom
Feature for setting a fixed zoom level - disables the automatic zoom, for example to control zooming by the use of a Sense variable.

zoomBuffer
Feature for setting a buffer space between the current map content and the border around it. This prevents labels and other information near the edge from being "cut".

centerPoint
Feature to move the map center to a fixed geographical point. Useful for working with variables to control the focus point directly in the Sense application.

click to expand

click to expand

 

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.

ZOOM LEVEL DEFINITION

SETTING / VALUES

EXPLANATION

 

 

maxZoom

-1

 feature disabled (default)

number

 feature enabled - fill in maximum zoom level, number from 0 to 22 (varies with background maps)

Defines, how close the automatic zoom is allowed to zoom into the map. It is no restriction, the user is still able to zoom further in.
The purpose of this feature is, for example if there are only Dynamic Markers on the map and one of them is selected, the automatic map would focus the selected Marker on the highest zoom level (which means rooftop level). That wouldn't make much sense, because there is no more relation displayed, like where the Marker is located.
Apart from selections, if you always want to keep the overview and never zoom in closer than for instance level 10, you can set it in this feature.

Without any background maps (when the background is just white) there are 46 zoom levels. The exact number of available zoom levels when using a background map, like GoogleMaps or any other Tile Map, depends on the respective provider. However there are maximum 22 levels.
Level 0 shows always the whole world, 22 is the so called rooftop level where you can spot streets and buildings.
(Level 45 without a background map is in the macro meter range.)

minZoom

-1

 feature disabled (default)

number

 feature enabled - fill in minimum zoom level, number from 0 to 22

Defines a minimum zoom level to block a bigger map section.
(Level 0 shows always the whole world, 22 is the so called rooftop level where you can spot streets and buildings.)
This feature is a restriction, the user is not able to zoom further out of the map.

In combination with the feature MapBoundaries and zoomlevels it is a way to specify and determine an area on the map within the user can operate. This is useful if a user must not have access to other areas on the map or if limited tiles are used (to prevent missing images - see screenshot). Have a look at these features as well.

click to expand

click to expand

fixZoom

-1

 feature disabled (default)

number

feature enabled - set fixed zoom level, number from 0 to 22

Defines a fixed zoom level and disables the automatic zoom, for example to control zooming by the use of a Sense variable. However the user is still able to zoom further in and out, by using the zoom buttons or the mouse wheel.
This can be useful if you want the map to adjust the position of the map section automatically, when selecting, but at the same time never want to change the zoom level.

Without any background maps (when the background is just white) there are 22 zoom levels. The exact number of available zoom levels when using a background map, like GoogleMaps or any other Tile Map, depends on the respective provider. However in any case there are maximum 22 levels.

zoomBuffer

number

 buffer added to the current zoom level, number from 0 to 100, unit is 0,01 zoom level (default is 12)

Defines a buffer space between the current map content and the border around it. This prevents labels and other information near the edge from being "cut" as well as keeping an better overview.

The unit of the zoom buffer is a hundredth of a zoom level - 0,01. With a click on  Info ?  in the menu bar or info_grey in the touchscreen menu, the current zoom level will be displayed in the dialog.
Example:
If the current zoom level is 12 and the zoom buffer is set to 40, the map will be displayed in zoom level 12,4 (see screenshot).

click to expand

click to expand

Please note that Tile Maps (background maps) can only be displayed in integers (whole numbers), because they consist of several images, which can only be displayed at once. That's why the zoom changes gradually, when any background maps are activated. Without a background map the course is fluent and in decimals.

Therefore the zoom buffer is a minimum distance, which means that the zoom level will be rounded to the next smaller level (the level with a bigger map section), if a background map is enabled.

centerPoint

coordinates

coordinates for a fixed point in the map center (default placeholder is 51.109790, 10.647978)

Moves the map center to a fixed geographical point. Useful for working with variables to control the focus point directly in the Sense application.
This feature is active, if in Basic Settings the Zoom Layer "Center Point" is selected.

As long as you don't pan the map, this coordinate will always stay in focus, for example while selecting or zooming. You can combine this feature with maxZoom or fixZoom to define a whole area.

You can get the needed coordinates for instance by right clicking in GoogleMaps and choosing "What's here?" in the context menu - the coordinates will then be displayed in the upper left corner of the web page.

To create a kind of Center Area instead of a Center Point, you can set several points in this feature - separated by semicolon.

Notation:
In JSON coordinates are handled as text (string), that's why they have to be enclosed in double quotes "" . Coordinates in NPGeoMap are always separated by comma and have a dot as decimal separator.
Example:
"latitude,longitude"
"51.109790,10.647978"

mastermap

Qlik object ID

ID des Map-Objektes, das als Quelle dient

Set here the ID of a map object (e.g. "cbUas") that functions as source for the map position of this map. As soon as the Mastermap changes the position, for example because of a selection, this map here will be adapted. The source map can also be on a different worksheet, as long as it is in the same app.
Description in the Sense Manual how to get the object ID: help.qlik.com/obtain-app-object-id