Map properties

You open the properties panel for a visualization by clicking Edit in the toolbar and clicking the visualization that you want to edit.

If the properties panel is hidden, click in the lower right-hand corner to open it.

Common properties

Map settings

• Base map: Select the base map for the map chart. The following options are available:
  • Default: Use an OpenStreetMap-based map.
  • Pale: Use a paler version of the Default map.
  • Satellite: Use a satellite image map.
  • None: Use no map for the base map. This selection should be used if a background layer is going to be added to the map. None uses the background color from the current theme or the value defined for mapChart.backgroundColor in the current theme.
• Projection: Set the projection the map uses for locations and define what kind of coordinates the map uses. Each base map supports a set of projections. The following projections are available:

  • Mercator: Display the map using Mercator projection. Mercator projections requires coordinates use WGS-84.

    Available with Default, Pale, Satellite, and None base maps.

  • Adaptive: Display the map in an adaptive projection that does not exaggerate the areas close to the poles as much when zoomed out.

    Available with Default and Pale base maps.

  • Undefined degrees: Display the map using coordinates in a degree-based coordinate system. If you are using a custom base map with custom coordinates that use degrees, select this option.

    All settings in Location except Location field are not compatible with this projection.

    Available with None.

  • Undefined meters: Display the map using coordinates in a degree-based coordinate system. If you are using a custom base map with custom coordinates that use meters, select this option.

    All settings in Location except Location field are not compatible with this projection.

    Available with None.

• Map language: Set the language for labels on the map.
  • Auto: Use English labels (where available) when the map view is zoomed out and local language labels when zoomed in.

  • Local: Use labels in the local language for the displayed country or region where available.

    English: Use English labels where available.

• Map units: Set the units of measure for the map. The following options are available:
  • Metric
  • Imperial
• Selection method: Sets how users can select multiple values on the map while holding down the Shift key:
  • None: Disable multiselect in the map using the Shift key and clicking and dragging the cursor.
  • Circle with distance: Select by dragging from a center point and out in a circle. The circle measures and presents the radius of the circle.
  • Lasso: Select by drawing the perimeter of an area.
• Auto-zoom: Set whether the map zooms to a selected locations when the selection changes.
• Set default view: Set the current view of the map as the default view of the map when the app is opened.

Appearance

General

• Show titles: Select to enable or disable titles, subtitles, and footnotes in the map.

  Enter Title, Subtitle, and Footnote. By default, the string is interpreted as a text string. However, you can also use the text field for an expression, or a combination of text and expression. An equals sign (=), at the beginning of a string shows that it contains an expression.

  Click 3 if you want to create an expression by using the expression editor.

  Example:  

  Assume that the following string is used, including quotation marks: 'Sales: ' & Sum(Sales).

  By default, the string is interpreted as a text string and is displayed as presented in the example. But if you begin the string with an equals sign: (='Sales: ' & Sum(Sales)), the string is interpreted as an expression instead. The output is then Sales: <value of expression>, where <value of expression> is the calculated value.

Alternate states

• State: Set the state to apply to the visualization. You can select:

  • Any alternate state defined in Master items.
  • <inherited>, in which case the state defined for the sheet is used.
  • <default state>, which represents the state where no alternate state is applied.

  For more information about alternate states, see Using alternate states for comparative analysis.

Legend

• Show legend: Show or hide the legend for all layers.
• Legend position: Set the position of the legend relative to the map.

Presentation

• Navigation: Show navigation controls on top of map with buttons for panning, zooming, and returning to original position.

• Show scale bar: Select to show a scale bar for your map.

  Limit zoom levels: Set the zoom limits in the map.

  If set to No, the map can be zoomed in and out to the predefined limits in the base map.

  If set to Custom, the slider can be used to set limits:

  • Set the zoom out limit by adjusting the left side of the slider.
  • Set the zoom in limit by adjusting the right side of the slider.

• Limit pan navigation: Set limits on the vertical and horizontal movement of the map view, as well as limiting the zoom of the map. .

  If set to No, there are no pan limits.

  If set to Custom, you set the pan limit to the current view of the map by clicking Set pan limit. When a pan limit is set, users cannot move the map view outside the bounds of the current view or zoom out past the current zoom level.

• Show debug info: Display resolution, scale, zoom level, and coordinates for the center of the displayed area.

Layer properties

Data (Point layer, area layer, line layer, and density layer)

• Dimensions
  • Field: The field or expression selected as the dimension for the layer. The dimension usually defines the locations on the layer, although you can change the field that defines locations in the Location properties settings.
  • Label: Enter a label for the dimension. If you have added a field from Fields in the assets panel, the field name is automatically displayed.
  • Include null values: Select to include null values in the map. By default, this is selected.

Data (Chart layer)

• Dimensions
  • Field: The field or expression selected as the dimension for the layer. The first dimension usually defines the locations on the layer, although you can change the field that defines locations in the Location properties settings. The second dimension defines the dimension on the charts of the layer.
  • Label: Enter a label for the dimension. If you have added a field from Fields in the assets panel, the field name is automatically displayed.
  • Include null values: Select to include null values in the map. By default, this is selected.
  • Limitation: Limits the number of displayed values. When you set a limitation, the only dimensions displayed are those where the measure value meets the limitation criterion:
    • No limitation: The default value.
    • Fixed number: Select to display the top or bottom values. Set the number of values. You can also use an expression to set the number. Click 3 to open the expression editor.
    • Exact value: Use the operators and set the exact limit value. You can also use an expression to set the number. Click 3 to open the expression editor.
    • Relative value: Use the operators and set the relative limit value in percent. You can also use an expression to set the number. Click 3 to open the expression editor.
    • Calculated on measure: <measure>: Shown when you make a limitation to the number of displayed dimension values. The dimensions whose measure value meet the criterion are displayed.
  • Show others: When selected, the last value in the visualization (colored gray), summarizes all the remaining values. When some kind of limitation is set (Fixed number, Exact value, or Relative number), the value counts as 1 in that setting. If, for example, Exact value is used and set to 10, the tenth value is Others.
  • Others label: Enter a label for the summarized values (when Show others is selected). You can also use an expression as a label.
• Measures
  • Expression: The field or expression selected as the measure for the charts on the layer.
  • Label: Enter a label for the measure. If you have added a field from Fields in the assets panel, the field name is automatically displayed.
  • Number formatting: Select to include null values in the map. By default, this is selected.

Data (Background layer)

• Label: Set the name of the background layer in the map.
• Format: The format of the service to which the background layer is connecting. The following formats are supported:
  • TMS
  • WMS

• URL: (TMS only) Enter the URL to a slippy or tile map server. You can use ${z}, ${x}, ${y} in the URL to select the correct tile. For example, http://tile.openstreetmap.org/${z}/${x}/${y}.png. You can also use Bing Maps $(quadkey) in the URL to select the correct tile. You can use expressions between the curly brackets in the URL when defining ${z}, ${x}, ${y}, or ${quadkey}.

  The URL is an expression and if the URL changes, the background data is reloaded.

  The map server must produce tiles in the same projection type as is set for the map in Projection in Map settings to display layer data correctly.

• Attribution: Enter the attribution string for the map set in URL. HTML-style escaped characters, such as &copy, and HTML links, (<a> elements with href attributes) are allowed.
• Advanced options: (TMS only) Enables additional configuration options for TMS format maps. The following settings are available:
  • Tile size pixels: Set the width and height of map tiles in pixels.

  • Tile width: Set the tile width at level 0 (maximum zoom out) in the base map. The geographic unit is the one used by the base map.

    Tip note

    For most base maps, the internal coordinate system uses Mercator with width in meters, even if the external coordinate system uses WGS-84 format degrees.

  • Tile height: : Set the tile height at level 0 (maximum zoom out) in the base map. The geographic unit is the one used by the base map.

    Tip note

    For most base maps, the internal coordinate system uses Mercator with height in meters, even if the external coordinate system uses WGS-84 format degrees.

  • Origin X: The origin of tiles in the x-axis. This field uses the same unit as Tile height. All tiles to the left of this origin use a negative value.

  • Origin Y: The origin of tiles in the y-axis. This field uses the same unit as Tile width. All titles to above this origin use a negative value.

    Tip note

    If ${-y} is used in the URL, the y-axis is reversed and all tiles below this value will have a negative value.

• WMS Setup: (WMS only) Click to set up the WMS format background layer.
  • WMS server URL: Enter the URL to the WMS server.
  • Version: Select the WMS version. Qlik Sense supports:
    • 1.1.0
    • 1.1.1
    • 1.3.0
  • Via server (CORS): Select this option if Qlik Sense fails to load information after you click Load WMS. If a browser does not allow loading data from another site, the Qlik GeoAnalytics server can load the capabilities information instead, enabling cross-origin resource sharing (CORS).

  • CRS: Select the coordinate reference system used by the WMS map.

  • Transparent: Select to make areas in the WMS map that have no data as transparent. This enables the WMS map can be overlaid another base map.

    Information note

    Support for transparency depends on your WMS.

  • Layers: Select the WMS layers to display in the map chart. The available layers depend on your source WMS map.

Sorting (Point layer, area layer, density layer, and chart layer)

Click the dimension name to open the settings and click the sorting button to switch to Custom sorting. Sorting determines the order map locations are added. For example, if you have three overlapping points in a layer, sorting determines which point is on top. Sorting also determines which locations are displayed in a layer if you limit the number of visible map objects with Max visible objects. The sorting is either Ascending or Descending. The following sorting options are available:

• Sort by expression: Enter an expression to sort by.
• Sort numerically
• Sort alphabetically

Additionally, you can sort by load order by switching to Custom and leaving all sorting options unselected.

If you have set a custom order for a field, that custom order will override any selected internal sort order in Sorting. See Customizing the order of dimension values.

Location

• (Line layer only) Set what kind of data you are using for your lines.

  • Start & end point: Select to use two fields to set the start and end points. When selected, separate sections are added in Location for the start point and end point location settings.
  • Line geometry: Select to use GeoJSONLineString or MultiLineString format line geometry from a field. When selected, all other location settings are replaced with Line geometry field.

• Latitude and Longitude fields: (Point, Line ,Density, and Chart layers only) Select to use separate latitude and longitude fields.

  If selected, Location field is replaced with the following fields:

  • Latitude: (Point, Line ,Density, and Chart layers only) Enter the field or expression containing latitude data.
  • Longitude: (Point, Line ,Density, and Chart layers only) Enter the field or expression containing longitude data.

• Location field: Enter the field or expression containing the locations to use in this layer. The field can contain geometries or the names of locations such as countries, cities, or postal codes. For more information, see Loading your own map data.

  Information note

  If there are multiple locations associated with dimension values, you should set a custom scope for locations or use an expression that contains qualifiers.

• Scope for locations: Set the scope of locations names the map chart uses to look for values contained in Location field. This improves accuracy when the name of a location is not globally unique or if you want one location per dimension value.

  • Auto: Set the scope of locations to all any type of locations.
  • Custom: Set the scope of locations to a custom set of locations.

    • Location type: Select the type of locations contained in Location field:

      • Auto: Any type of location.
      • Continent: Continent names.
      • Country: Country names.
      • Country code (ISO 2): ISO alpha 2 country codes.
      • Country code (ISO 3): ISO alpha 3 country codes.
      • Administrative area (Level 1): First-level administrative area names. such as a state or province names.
      • Administrative area (Level 2): Second-level administrative area names.
      • Administrative area (Level 3): Third order administrative area names.
      • Administrative area (Level 4): Fourth order administrative area names.
      • Postal code/ZIP Code: Postal codes or ZIP Codes.
      • City, place: City, village, or other populated place names.
      • Airport code (IATA): IATA airport codes.
      • Airport code (ICAO): ICAO airport codes.
    • Country: Enter a field or expression containing country names or country codes for the locations in Location field.
    • Administrative area (Level 1): Enter a field or expression containing first-order administrative area names or codes for the locations in Location field.
    • Administrative area (Level 2): Enter a field or expression containing second-order administrative area names or codes for locations. in Location field.

Size & Shape (Point layer)

• Size by: Enter a field or expression to control the size of the symbol. The minimum and maximum values in the data are mapped to the minimum and maximum sizes of the field in <Symbol> size range, unless the Range is set to Custom.
• Label: Set a label for the Size by property.
• <Symbol> size range: Set a minimum and maximum size range limit for the selected symbol for your point layer.

• Range: Set the value limits for the size range.

  • Auto: The symbol size range maps to the minimum and maximum value of the Size by field.
  • Custom: The symbol size range maps to the minimum and maximum values set in Minimum size value and Maximum size value. Values exceeding the minimum and maximum values will use the same settings as the minimum and maximum values.
• Shape: Select the shape for your point layer. The following shapes are available:

  • Bubble

  • Triangle

  • Square

  • Pentagon

  • Hexagon

Size & Shape (Chart layer)

• Pie chart
• Size by: Enter a field or expression to control the size of the pie charts. The minimum and maximum values in the data are mapped to the minimum and maximum sizes of the pie charts, unless the Range is set to Custom.
• Label: Set a label for the Size by property.
• Pie chart size range: Set a minimum and maximum size range limit for the pie charts for your chart layer.
• Range: Set the value limits for the size range.
  • Auto: The size range maps to the minimum and maximum value of the Size by field.
  • Custom: The size range maps to the minimum and maximum values set in Minimum size value and Maximum size value. Values exceeding the minimum and maximum values will use the same settings as the minimum and maximum values.
• Bar chart
• Height: Set a height size for the bar charts for your chart layer.
• Width: Set a width size for the bar charts for your chart layer.

Width & Style (Line layer only)

• Width by: Enter a field or expression to control the width of the lines. The minimum and maximum values in the data are mapped to the minimum and maximum sizes of the field in Line size width range, unless the Range is set to Custom.

• Label: Set a label for the Width by property.

• Line size width range: If you are using Width by, set the minimum and maximum width of the lines.

• Line width: Set the width of the lines.

• Range: Set the value limits for line width.

  • Auto: The line width range maps to the minimum and maximum value of the Width by field.
  • Custom: The line width range maps to the minimum and maximum values set in Minimum line value and Maximum line value. Values exceeding the minimum and maximum values will use the same settings as the minimum and maximum values.
• Line curve: Set the curvature of the lines in your line layer.

• Arrow: Set the style of the arrows for your lines. The following options are available:

  • None: No arrow is added to your line.
  • Forward: An arrow is added in the direction of the last point of the line.
  • Backward: An arrow is added in the direction of the first point of the line.
  • Both: Arrows are added facing both the first and last point of the line.
• Arrow position: Set the position of the arrow in the line.

Weight & Radius (Density layer only)

• Weight by: Enter a field or expression to control how much each point contributes to the density. The default weight value is 1.
• Label: Set a label for the Weight by property.
• Influence radius: Set the radius of the circular area that each point influences. The unit of measure for the radius is set by Radius unit.
• Radius unit: Set the unit of measure for the radius of influence. The following options are available:
  • Pixels: Screen pixels.
  • Meters: Map meters.
  • Feet: Map feet.

Colors (Point layer, area layer, line layer, chart layer, and background layer)

• Colors: Select how the map values are colored. There are two settings:
  • Auto: Colors the map values using default settings.
  • Custom: Manually select the method of coloring your values in the map. The following methods are available
    • Single color: Color the map using a single color (by default blue). When selected, the following settings are available:

      • Color: Select the color to use for objects in the layer.

      • Outline color: Select the outline color for objects in the layer.

    • By dimension: Color the map by dimension values. By default, 12 colors are used for the dimensions. The colors are reused when there are more than 12 dimension values. When selected, the following settings are available:

      • Select dimension: Enter a field or expression containing the values to color objects in this layer.
      • Library colors: Select whether to use the master dimension color or to disable the master dimension color. Option available only when a master dimension used in the visualization has a color assigned to it.
      • Persistent colors: Select to have colors remain the same between selection states.

      • Color scheme: Select 12 colors or 100 colors to be used for the different values. The 12 colors can all be distinguished by people with color vision deficiency, but not all of the 100 colors.

    • By measure:
      • Select measure: Select the measure to use to color your layer.
      • Label: Enter text or an expression for the measure that displays in the legend.
      • Color scheme: Select a color scheme from the following options:

        • Sequential gradient: The transition between the different color groups is made using different shades of colors. High measure values have darker hues.

        • Sequential classes: The transition between the different color groups is made using distinctly different colors.

        • Diverging gradient: Used when working with data that is ordered from low to high, for instance, to show the relationship between different areas on a map. Low and high values have dark colors, mid-range colors are light.
        • Diverging classes: Can be seen as two sequential classes combined, with the mid-range shared. The two extremes, high and low, are emphasized with dark colors with contrasting hues, and the mid-range critical values are emphasized with light colors.
      • Reverse colors: When selected, the color scheme is reversed.
      • Range: Define the range of values used to color by measure or by expression.
        • Auto: The color range is set by the measure or expression values.
        • Custom: When custom is selected, you can set the Min and Max values for the color range.
    • By expression: Color the map using an expression to define colors for values. Supported color formats are: RGB, ARGB, and HSL.
      • Expression: Enter the expression that you want to use. Click 3 to open the expression editor.

      • The expression is a color code: Selected by default. In most cases, it is best to keep this setting. When the selection is cleared, the expression evaluates to a number, which in turn is plotted against one of the chart gradients.

        For more information, see Coloring a visualization

        When the coloring is by measure or by expression, you can set the color range (Min and Max values). By setting the color range, the colors remain constant throughout selections and paging. When using color by expression, the option The expression is a color code must be cleared before you can set the color range.

  • Outline color: Select the color for the outline of the shapes in the map.
    
  • Outline opacity: (Point, chart, and area layers only) Set how opaque the outline of shapes in the map is.
• Opacity: Set how opaque the layer is over the base map.

Colors (Density layer)

• Segment Colors: Select how the influence area of the points is colored. There are two settings:
  • Auto: Colors the influence area using default settings.
  • Custom: Manually select the method of coloring the influence area in the map.
    • Add limit: Adds a segment to the gauge. Use the slider or type an expression to set the limit of the segment. Click 3 to open the expression editor. You can add several segments. Click the segment to change colors.

      • Gradient: Select to use different shades of colors in the transition between the segments.

    • Remove limit: Click to remove the selected limit.
• Range: Define the range of values used to color the influence area. There are two settings:
• Auto: Sets the range of values using default settings.
• Custom: Manually select the range of values coloring the influence area.
  • Min: Set the minimum value for the range. Click 3 if you want to create an expression.
  • Max: Set the maximum value for the range. Click 3 if you want to create an expression.
• Opacity: Set how opaque the layer is over the base map.

Options

General

• Show legend: Display a legend if there is enough space on the map. You can set a size for the legend or let Qlik Sense automatically determine the size. The placement can be changed using Legend position.
• Show tooltip: (Point, area, chart, and line layers only) Display a tooltip over the displayed locations in a layer with the location's value.
• Max visible objects: (Point, area, density, chart, and line layers only) Set the maximum locations to display in the layer. The maximum number of values in a map layer is 50,000 for point layers, 10,000 for area layers, 20,000 for line layers, 50,000 for density layers, and 50.000 for chart layers. By default, map layers display a maximum of 4,000 values for point layers and 1,000 for other layers.
• Show label: (Point, area, chart, and line layers only) Set whether to include a text label with the layer's locations on your map.
  • Labels: Set the label for the locations in this layer.
  • Label position: Set the position of the label relative to the location.
  • Show in zoom levels: Set the label to be visible at all zoom levels or at a select range of zoom levels.

Layer display

• Show layer: Select to show or hide layer.
• Show in zoom levels: Set the layer to be visible at all zoom levels or at a select range of zoom levels.
• Visible drill-down levels: Set which dimensions in the drill-down are displayed with this layer.

• Calculation condition: Specify an expression in this text field to set a condition that needs to be fulfilled (true) for the object to be displayed. The value may be entered as a calculated formula. For example: count(distinct Team)<3. If the condition is not fulfilled, the message or expression entered in Displayed message is displayed.

  A calculation condition is useful when a chart or table is very big and makes the visualization slow to respond. A calculation condition can then help so that for example an object does not show until the user has filtered the data to a more manageable level by applying selections.