Icon Map

Usage & Instructions

This section provides instructions and guidance on how to use the various features of Icon Map. The ambition is to include a video and downloadable example for each scenario.



Field configuration

To relate items in your dataset to the shapes in a GeoJSON file, it is necessary to specify provide the 'Category' and 'Size' fields. The value in the 'Category' field should relate to one of the property values in your dataset. Eg:

{"type":"FeatureCollection", "features": [
{"type":"Feature","geometry":{"type":"Polygon","coordinates":[[[-0.0855554,51.519815], ... ,[-0.085555,51.5198157]]]},
"properties":{"LAD13CD":"E09000001","LAD13NM":"City of London"},"id":"E09000001"},

Support is currently being added for the shape id field.

The value in the size field is used in relation with the Fill Color Start & End settings to generate a color gradient for each shape. Specific color values for each shape fill and outline can be provided by using the 'Circle / WKT / GeoJSON Fill Color' and 'Circle / WKT / GeoJSON Outline Color' field. #RRGGBB, #RRBBBBAA, rbg (r,g,b) and rgb(r,g,b,a) formats are supported.

If you have longitude and latitude fields specified due to have other types of map object, these must have null values to relate these rows to a GeoJSON shape.

Download example report

GeoJSON Settings

To display a GeoJSON layer, set the switch to on to enable the GeoJSON settings.

Number of Levels

Icon Map supports up to 5 levels of drill-down to GeoJSON layers. Use this setting to set the number of GeoJSON layers to load. Each layer corresponds to a layer within the drilldown hierarchy. It is not possible to show more than one GeoJSON layer at the same time.


This is the URL of the boundary data or shapes to display on the map. A box will appear for each of the number of levels selected above. It should be in GeoJSON format and include at least one code or description property against each shape that you can relate to the "Category" field in your data. IconMap scans each of the property fields against the data in the category field to look for matches.

Eg: https://iconmap.azurewebsites.net/mapresources/lad.json

If IconMap is unable to access the file, an error message will be displayed. Note: Some webservers will not allow the file to be accessed from another website, due to CORS. If you have control of the web server this can be resolved by adding the Access-Control-Allow-Origin: * response header.

Whilst the file is loading, an icon will be displayed in the top right hand corner of the map. Larger files will take longer to load. It is recommended to simplify your shapes to reduce the file size using a service such as MapShaper.

In order for the layer to appear in the Power BI Service, it must be served from an HTTPS address.

Include GeoJSON shapes in auto zoom

On: The map will include GeoJSON shapes when auto-zooming the map to available data items.

Off: The map will ignore GeoJSON shapes when auto-zooming the map. This is useful if you're using a GeoJSON layer as a background layer in conjunction with other map objects such as circles or images.

Zoom to selected shape

On: the map will zoom to the selected shape when you click on it.

Off: the map will not adjust the current zoom when you click on a shape.

Known issue: The map does not zoom to shapes selected using the lasso.

Show tooltips

Toggle whether to show tooltips for GeoJSON shapes.

Allow selecting GeoJSON shapes

Toggles whether GeoJSON shapes can be selected.

Known issue: Currently the lasso does not take account of this setting.

Line Color

Color of the shape outlines. If you have a field in the 'Circle / Line / WKT / GeoJSON Outline Color' fieldwell, then this setting is ignored, and will instead take the value from this field.

Line Width

With of the shape outlines

Line Opacity

Opacity of the shape outlines. 0 = completely transparent. 100 = completely opaque.


Opacity of the shape fill. 0 = completely transparent. 100 = completely opaque.

Inactive Fill Color

Shape fill color when there is not corresponding data item in the category field. This may occur when you have more shapes than are referenced in your dataset, or if you filter the category field via a filter, slicer or selection on another visual in your report.

Fill Color - Start & Fill Color - End

The start and end colors to form the color gradient based on the value in the size field. If you have a field in the 'Circle / WKT / GeoJSON Fill Color' fieldwell, then this setting is ignored, and will instead take the value from this field.

Further examples

Drill-down with dynamic labels

Download example report

Drill-down through GeoJSON to circles

Download example report

Drill-down through GeoJSON to circles and images

Download example report