Icon Map Pro documentation

Icon Map Pro is a map visual for Power BI. It draws your report data as circles, images, heatmaps, cells, 3D columns, lines and shapes, over a basemap of your choice, with reference layers for context. These pages show you how to build a map and explain every setting.

An Icon Map Pro map in a Power BI report with circles sized by sales, a boundary layer and a legend — One visual, many layer types: data layers over a basemap, with reference layers for context

Start here

How it worksThe basemap, data layers and reference layers, and how each row of your data finds its layer. Build your first mapA step-by-step tutorial with sample data, from an empty visual to a finished map. Choose a layer typeEvery layer type, what it shows and the fields it needs.

This documentation covers the Modern engine

Icon Map Pro has two map engines, Modern and Legacy. New maps use Modern, and these pages describe Modern only. If your map uses the Legacy engine, or you use version 1.1.0.9 or earlier, see the documentation for 1.1.0.9 and earlier. To find out which engine a map uses, see Modern and Legacy engines.

Browse by topic

Get startedAdd the visual to a report, learn the concepts and build a first map. Data layersCircles, images, clusters, heatmaps, cells, 3D columns, lines, routes, shapes, vector tiles, ArcGIS and catalog layers. Basemaps and the map viewBasemap styles and providers, zoom, tilt, globe, terrain and lighting. Reference layersFiles and feeds, tiles and WMS, ArcGIS layers, weather, traffic and map labels. Labels, tooltips and legendLabel your data, choose what tooltips show and add a legend. Interactivity and controlsSelection, cross-filtering, highlighting and the controls on the map. Settings and referenceThe Format pane card by card, the field wells, conditional formatting, API keys and languages. Licensing and purchasingLicense types, the free developer license, license keys and how to buy. HelpTroubleshooting, frequently asked questions, support and release notes.

Versions and languages

Use the version menu at the top of any page to match the documentation to the version of Icon Map Pro in your report. The version number is shown on the page you see when the visual has no fields, and in Format pane > Icon Map Pro once it has data. What's new lists the main changes in each version.

Icon Map Pro is available in English, German, Spanish, French and Portuguese. See Languages.