Adding the Bubble Layer

You can add a bubble layer to a geo map.


To add data from a model to a bubble layer, the model must contain at least one location dimension. For more information see Creating a Model with Coordinate or Area Data for Geospatial Analysis.


  1. To pick the model that the layer will be based on, under Data Source, select (edit).
  2. Select Bubble Layer from the Layer Type list.
  3. From the Location Dimension list, select the dimension that you want to visualize.
    1. To change the marker icon, select the arrow to the right of Style and choose a new icon.
      You can also use a custom marker; choose Add Custom, select Enter SVG Path to directly enter the icon's SVG Path, or select Upload SVG File to load the file containing the icon.
    2. You have the option to apply more changes to the location dimension marker:
      • Select a new color from the Palette list.
      • If necessary, you can adjust the Opacity or the Size of the marker icon.
      The settings for Palette, Opacity, and Size only correspond to the localization dimension. Once the marker size or color is associated with a measure, the location dimension settings are ignored.
  4. Use the Add Measure/Dimension list under Bubble Color to associate a bubble color with a measure or a dimension.
    You can choose the number of Ranges for the palette. This sets the number of KPI values and allows you to specify values to set the KPI ranges for each color in the palette. If necessary, adjust the Opacity of the bubbles to ensure that the basemap or other layers are visible.
    Use the switch beside the Ranges list to show KPI values as percentages or as absolute values. To reverse the palette order, use the (Switch) icon.
    If you choose to associate Bubble Color with a dimension, the dimension's top five members are displayed within pie charts in the resulting bubbles. If no measure is specified for Bubble Size, the pie sections will be evenly proportional. If a measure is specified, the proportion will be aggregated according to the measure values. To highlight a bubble, select it once. To highlight a section of the pie within the bubble, select the bubble and then select the section. If you associate Bubble Color with a hierarchical dimension, you can drill up or down the hierarchy after selecting a bubble or section.
    You can only sync colors by dimension using a geo map and a chart.
    You can associate Bubble Color with only one dimension or measure.
  5. Use the Add Measure list under Bubble Size to associate the bubble size with a measure.

    Use the Size slider to adjust the size of bubbles. Toggle the Adjust Range Scale switch between a scale range based on percentages and a range based on numeric values. You can customize the range by modifying the min and max values or using the provided range slider.

    Data points representing values outside the bounds of the specified range will display as bubbles with dotted boundaries and no fill color.

  6. To control the display of data point labels in geo maps, select the geo map and go to Start of the navigation pathMore Actions Next navigation step Show/Hide Next navigation step LabelsEnd of the navigation path) to display or remove labels for a particular layer.

    By default, labels will display in a Bubble layer, and labels will not overlap. However, to remove the automatic control on label overlap, choose Designer and select (Styling). Turn Off the Avoid Data Label Overlap under Map Controls.

    To visualize multiple data points associated with the same location, hover over the location to display all the values. The bubble size and color used for overlapping points is based on the average value of all the points at that location.

  7. Use the switch beside Location Clustering to disable or enable clustering.
    To support the rendering of large numbers of locations, the bubble layer is set by default to display clusters rather than all the individual points. Use the Maximum Display Points value to specify when to start clustering data points. You can also adjust the Cluster Opacity of the clusters in your map, and the Cluster Color. Clustering is enabled by default when a geo map contain more than 5000 data points. You can reduce the number of visible points by using a filter or zoom. Another option is to use the choropleth layer, which aggregates data points into regions such as state or countries. The maximum number of points that can be rendered on a geo map is 20,000. Clustering is strictly enforced when a map contains more than 20,000 data points.
  8. To manage thresholds in the geo map, in (Builder) select the icon to the right of the measure.
    Go to Start of the navigation pathShow Threshold Next navigation step NoneEnd of the navigation path to remove all thresholds. Go to Start of the navigation pathShow Threshold Next navigation step ModelEnd of the navigation path or Start of the navigation pathShow Threshold Next navigation step StoryEnd of the navigation path to specify which type of threshold you want to display. Select Edit Ranges or View all Thresholds to modify the thresholds. If you choose not to display thresholds in geo map, the Bubble Color palette specified for the layer will override the one specified in the threshold. Any palette changes will be reflected in the map legend.
  9. To customize the data that displays for a given data point in the bubble layer, select the icon to right of Layout. You can also use the (More Actions) icon to the right of the geo map to access Add Tooltip or Add Tooltip Chart for a specific bubble layer.
    • Select Tooltip Information to specify information displayed as you hover over a given data point in the geo map. Use the provided Tooltip Information field to choose from a selection of measures, dimensions, and dimension attributes, or to create a calculated measure or measure input controls.
    • Select Tooltip Chart to populate a corresponding table of information for a point in the geo map. Make your selections from the provided list of Measures and Dimensions, and click OK.
  10. Select OK to save all the layer settings.