Map: Icons

Overview #

#

The Map Visualization renders data that contains latitude and longitude information on a map. You can choose from several tile maps, and configure custom map markers that can show status and icons. The rendering engine is smart enough to render important markers on top of lesser ones. The marker cluster option can show cluster numbers for congested maps with status and zoom options to see the markers. If your data updates over time, an optional auto-zoom feature will keep all of the markers rendered in the window.

This example shows the location of national parks, and the color rules on the pins summarize total number of visitors.

Tip: Double clicking on a Map Visualization will zoom in one level.

Map Tiles and Overlays

Icon Map Configuration #

Icon Map configuration is broken out into these main steps.

  • Base Map
  • Markers
  • Marker Clustering (if enabled)
  • Marker Labels (if enabled)
  • Legend
  • Optional Layers
  • Weather (if enabled)
  • Heat Map (if enabled)
  • Preview

Step: Base Map #

Visualization Name #

A symbolic name used to represent this Visualization. This is the name that will show up in choosers when adding a Visualization to a Page.

Tile Provider #

The Tile Provider controls what the map looks like. Each tile set provides its own look and feel, as well as min and max zoom ranges. These ranges are included on the right hand side of the pull-down.

Refer to the Map Tiles and Overlays section for more information.

Default Zoom Levels #

Yes Use the minimum and maximum zoom levels that the tile provider supports.
No Specify zoom levels to support; along with the center latitude and longitude, this is good for limiting a map to a specific region.

Minimum Zoom #

Choose the minimum zoom level that the map is allowed to show. This option is only enabled when you choose No for Default Zoom Levels.

Min 1
Max 22

Maximum Zoom #

Choose the maximum zoom level that the map is allowed to show. This option is only enabled when you choose No for Default Zoom Levels.

Min 1
Max 22

Auto Zoom & Center #

Yes Let the visualization automatically zoom the map so that all map markers fit into view.
No Provide your own custom center point and zoom level to start the map on.

Zoom Level #

This sets the default zoom level for the map.

  • Only visible when Auto Zoom & Center = No.
  • The Default Zoom Level should be set to a value within the supported range specified by the Tile Provider.

Latitude #

This sets the Latitude for the center point of the map.

  • Only visible when Auto Zoom & Center = No.
  • Value is expected in decimal format.

Longitude #

This sets the Longitude for the center point of the map.

  • Only visible when Auto Zoom & Center = No.
  • Value is expected in decimal format.

Zoom Control

Determine the placement of the zoom control on the map.

Enable Geocoding

Enables options for looking up current location based off an address.

Yes Turn on a search field for entering addresses to find on the map. Also adds a “Show my location” button to center the map on your current location.
No Will not add a search field or “Show my location” button to the map.

Step: Markers #

Latitude Attribute #

Choose the attribute in the data that will contain the Latitude of the marker to place. Value is expected in decimal format.

Longitude Attribute #

Choose the attribute in the data that will contain the Longitude of the marker to place. Value is expected in decimal format.

Use Clustering? #

Determines whether icons will be combined together based on proximity.

Yes When there are several markers in close proximity to one another, they will be combined into a cluster. A numeric value will indicate how many individual icons are represented by the cluster. The color of a cluster will be determined by the color rule used on the markers in the cluster.

  • Static Color
    This occurs when the first layer of a marker is set to a static color.
  • Derived Color
    This occurs when the first layer of a marker is set to a Derived color, and is highly dependent upon how the data is sorted. To get the highest-severity color to appear as the color of the cluster, the data should be sorted by the same attribute used for the color rule. The order should reflect the severity, from the most important values to least important values.
No All markers will be rendered individually. This means that a group of markers in close proximity to one another will render on top of each other. The Map Visualization is smart enough, however, to bring the more important markers to the top of the group.

Show Label? #

Yes Show a label along with a marker.
No Show only the marker without a label.

Marker Properties

Define a static or rule based icon to place on the marker.

Marker Placement Type #

Pin Places the marker horizontally centered and (using the height of the marker) above the Latitude and Longitude position.
Center Places the marker centered on the Latitude and Longitude position.

Step: Marker Clustering (if enabled) #

This step is enabled on step Markers, when “Use Clustering?” = Yes.

If Heap Map option is turned on, then no clustering will be done.

Clustering Type #

Basic Single color representing cluster icon.
Pie Chart A pie chart like rendering of cluster icon.

Sectional Clustering Options #

Area Specify a number indicating the area of the cluster. Higher number means more markers “merged”.
Icon Radius Radius of cluster icon.
Icon Inner Radius Inner radius of cluster icon.
Icon Inner Opacity Inner cluster icon’s opacity.
Show Tooltip? Show breakdown of the pie chart slices on mouse over; only for clusters with multiple slices.

Step: Marker Labels (if enabled) #

This step is enabled on step Markers, when “Show Label?” = Yes.

Position #

This option is configured in the “Marker Labels” menu, which is activated when “Use Label?” is set to Yes.

Bottom Place the label centered and below the marker.
Left Place the label to the left of the marker.
Right Place the label to the right of the marker.
Top Place the label centered and above the marker.

Derive from Attribute #

Choose the attribute from the data that contains the value to be used with the label.

Label Formatter #

Configure a text formatter for the label.


Step: Legend #

This will appear if, in the “Markers” Section, the Formatter Type property is set to Derived From. The legend’s colors and labels will be rendered from the derived rules’ color and label. See Rule Sets for more detail.

Position #

The location of the Legend box on the map.

  1. Bottom Left
  2. Bottom Right
  3. None: turn off legend.
  4. Top Left
  5. Top Right

Title #

Available when “Position” is not set to None. Optional title for the legend box.

Text Color #

Available when “Position” is not set to None. Determines the text color of the legend’s title and key labels.


Step: Optional Layers #

Weather? #

Yes Show a translucent weather layer above the map. Choosing Yes will add another step to the wizard to configure the Weather layer.
No Do not add a weather layer to the map.

Step: Weather (if enabled) #

Choose which weather layers you would like to enable by turning “Enable Layer” column switch to Yes. Choose Yes for “On by default” if you would like the layer to be visible on a newly initialized map. If you choose No for “On by default”, the user can enable the layer manually on the visualization later. Layer Opacity allows you to change the translucency of the layer.


Step: Heat Map (if enabled) #

Scale Radius #

Yes Zoom level affects the size of the heat map radius.
No Zoom level does not affect the size of the heat map radius.

Radius #

The radius (in pixels) of the Heat Map brush.

Min Opacity #

A numeric value that defines the minimum opacity of a heat point.

Min 0
Max 1.0

Max Opacity #

A numeric value that defines the maximum opacity of a heat point.

Min 0
Max 1.0

Blur #

A numeric value that adjusts how much a heat point is blurred.

Min 0
Max 1.0

Use Aggregation? #

Yes Aggregate the values defined in the Intensity field to determine the heat of a point.
No Heat is determined by marker density, not value.

Intensity #

(This option is displayed when “Use Aggregation?” is set to Yes.)

Choose a field to aggregate a value for heat.

Show Markers as Well #

Yes Show the markers in addition to the heat map.
No Hide the markers when the heat map is enabled.

Step: Preview #

Displays a preview of the Map.

Sample Data #

Click here to download the National Parks data referenced on this page: National Parks Data Files