Skip to main content

Circles

Icon Map Pro provides the ability to draw circles on the map.

Data configuration

Circles Data Configuration

To draw circles, the following fields must be configured:

  • ID - A unique ID representing that location. This field can contain more than one value to generate a drill-down hierarchy.
  • Longitude (with aggregation type Average)
  • Latitude (with aggregation type Average)
  • Circle Size - a numeric value determining what size to draw the circle

Sample data

IDLongitudeLatitudeDestination LongitudeDestination LatitudeCircle SizeH3 WeightImage / WKT / GeoJSONFeature ReferenceDaylight Date & TimeTooltips
Circle1-2.57651.481nullnull50nullnullnull(optional)optional
Circle2-2.95551.332nullnull100nullnullnull(optional)optional

Circles Configuration

In the Data Layers card of the formatting options, ensure that "Circles" is enabled. This will then show the Circles Configuration and Circles Formatting cards.

Size Behavior

The size behavior dropdown has three options that determine how the circles are drawn.

Size Behavior

  • Relative - The circles will be drawn between the Minimum Size and Maximum Size options. The lowest value in the dataset will be minimum size, and the highest value will be the maximum size, with values scaled in between.
  • Size in pixels - The circles will be drawn with a diameter in pixels based on the value in the size field. The circles will appear to stay the same size as the map zooms in and out.
  • Size in meters - the circles will be drawn with a diameter in meters on the underlying map, based on the value in the size field The circles will appear to get bigger and smaller as the map zooms in and out.

Include rows with null values

This is only suitable for maps where circles are the only data-bound items being drawn. Rows with null values will be treated as having a 0 value.

Include in Auto-Zoom

Include these items when auto zooming. Auto zoom scales the map to fit all of the data-bound objects with this value set to Yes. You can use conditional formatting to set this on a row by row basis by providing a field value or measure with the values of yes or no.

Include tooltip

Whether to show a Power BI tooltip for this circle.

Selectable

Whether the circle can be selected to filter or cross-highlight other visuals, or to trigger drill down or drill through functionality.

Z-Index

Determines the order that this layer appears vs other layers. The higher the number, the nearer the forefront this layer will be.

EPSG (Coordinate Reference System)

Allows you to specify a specific reference system for your coordinates. The default used is EPSG:4326 / WGS84 and expects longitude and latitude coordinates. You can use other coordinate systems by specifying the relevant EPSG number. For example, to use British National Grid coordinates, enter 27700. Other EPSG codes can be found here.

EPSG

Clustered Circles Configuration

Enabling this option clusters nearby circles into a single circle, with a number representing how many circles have been consumed. Clusters are color coded into three categories representing the amount of circles consumed. Hovering over the the cluster will show a polygon representing the extent of the consumed circles.

Clustered circles

A new formatting card is shown with the following options:

  • Text color - the color of text in the clustered circles
  • Small Cluster Inside Color - the fill color of the clusters with the smallest number of consumed circles
  • Small Cluster Outside Color - the outline color of the clusters with the smallest number of consumed circles
  • Medium Cluster Inside Color - the fill color of the clusters with the middle number of consumed circles
  • Medium Cluster Outside Color - the outline color of the clusters with the middle number of consumed circles
  • Large Cluster Inside Color - the fill color of the clusters with the largest number of consumed circles
  • Large Cluster Outside Color - the outline color of the clusters with the largest number of consumed circles
  • Include Polygon - whether to show the polygon representing the extent of the consumed polygons
  • Polygon Color - the color of the polygon
  • Polygon Outline Width - the width of the polygon outline

Circle Formatting Options

Formatting options

The following options are available for formatting circles. All options are configurable through Power BI conditional formatting if required.

Outline

  • Outline Color - the color of the circle outlines.
  • Outline Transparency - a number between 0 and 100 representing the transparency of the outline.
  • Outline Width - the number of pixels wide to draw the outline. This can be a decimal number.
  • Dash Array. The dash array determines the pattern used for the line. It consists of a series of space separated numbers. Each value represents the length along the line that should be painted (the dash) and then not painted (the gap). Eg:
    4 4

Fill

  • Fill Color - the color of the circle fill.
  • Fill Transparency - a number between 0 and 100 representing the transparency of the circle fill.
  • Fill Style - Whether to use a solid fill, or hatched. Selecting hatched displays the following options:
    • Hatch Angle
    • Hatch Width

Hatched options