Supported environments and limits
Icon Map Slicer runs wherever Power BI shows custom visuals. This page lists each environment and the license it needs, what the machine displaying the map must support, and the network addresses the visual connects to.
Environments and licenses
| Environment | Supported | License that works there |
|---|---|---|
| Power BI Desktop | Yes | User license, license key, or the free developer license |
| The Power BI service, editing a report | Yes | User license, license key, or the free developer license |
| The Power BI service, reading a report | Yes | User license or license key. The developer license is not valid here |
| Power BI Embedded | Yes | License key. Power BI cannot provide user licenses here |
| Publish to web | Yes | License key |
| Power BI Report Server | Yes | License key. See Power BI Report Server (on-premises) |
| US government (GCC) and regional clouds | Yes | License key. Microsoft's licensing service cannot validate AppSource purchases in these clouds |
| Power BI mobile apps, dashboards, and exports to PDF and PowerPoint | Treated as the Power BI service for licensing | The license that covers the report in the service |
A report that uses the developer license shows an "Unsupported Environment" message to readers in the Power BI service, in Embedded and in Publish to web. See Free trial and developer license and License types.
Where Power BI does not allow interaction with a visual, such as in an export, tooltips and selection are inactive, so the map cannot filter the report.
Graphics: WebGL 2
Icon Map Slicer draws the whole map with WebGL 2, so the browser or Power BI Desktop on the machine that displays the report must provide it. Current browsers do when hardware acceleration is on.
WebGL 2 can be missing on virtual desktops (VDI, Citrix, RDP) and on machines with no GPU acceleration. Icon Map Slicer has no fallback for this: the map is not drawn, and the visual shows the message "WebGL 2 is not available in this environment." with the reason. The rest of the report keeps working.
To make WebGL 2 available:
- Enable hardware acceleration in your browser settings.
- Update your graphics drivers.
- On a virtual desktop, ask your IT administrator about enabling GPU passthrough.
- Try a different browser.
WebGL 2 is required from version 1.1.0.11.
Power BI settings the visual depends on
| Power BI setting | Why it matters |
|---|---|
| Custom visuals allowed in your tenant | Icon Map Slicer is not a certified visual. If your organization blocks uncertified visuals, an administrator must add it as an organizational visual. See Security and certification |
| Edit interactions on the report page | Selecting on the map filters the other visuals through Power BI's interactions. If an interaction is set to None for a visual, that visual is not filtered |
| Local storage for custom visuals | Optional. Used to remember a person's ArcGIS sign-in between sessions. Without it, people sign in again more often |
Network access
Icon Map Slicer loads its basemaps and other resources over the internet. If a firewall or proxy server blocks an address the map needs, the usual result is a blank or gray map, a layer that never appears, or a selection tool that does nothing.
Access is needed from the machine that displays the report: the report author's and each reader's computer. On Power BI Report Server, the server needs access too.
Microsoft
Needed to validate and load the visual from Microsoft AppSource.
| Address | Used for |
|---|---|
pbivisuals.powerbi.com |
Validating and importing the visual |
appsource.powerbi.com |
Validating and importing the visual |
Icon Map
| Address | Used for | Needed when |
|---|---|---|
styles.iconmappro.com |
Icon Map basemap styles, map tiles, fonts, hillshade and terrain, map labels, the road data for travel time selection, and the place index of the Search control | You use an Icon Map basemap, hillshade, terrain, Map Labels, Isochrone Select or Search |
iconmappropublictiles.blob.core.windows.net |
The icon library, and a fallback basemap style | You use icons from the icon library |
validate.iconmappro.com |
License key validation. Developer license and trial requests | The report uses a license key, or you request a developer license or trial |
validate2.iconmappro.com |
License key validation over a second route, tried when the first cannot be reached | The report uses a license key |
catalogapi.icon-map.com |
Icon Map Catalog search | You browse the Icon Map Catalog or use its layers |
catalog.icon-map.com |
Icon Map Catalog layers: tiles and data | You use Icon Map Catalog layers |
api.iconmap.ai |
Your organization's Icon Map catalog in Microsoft Fabric. Only used with Icon Map for Fabric | You browse your organization's catalog |
proxy.icon-map.com |
The Icon Map proxy | A proxy option is on. See ArcGIS sign-in and the proxy |
uksouth-1.in.applicationinsights.azure.com |
Feature usage telemetry | Opt out of telemetry is off. The map works without it |
api.iconmap.ai is also used by Sign in with ArcGIS, to pass the result of the sign-in back to the visual.
License validation tries both validation addresses in turn, because some corporate networks block one route and some the other. Allow both.
User licenses bought through AppSource are checked by Power BI itself, not through an Icon Map address.
Travel time selection is worked out inside the visual from road data it downloads. No report data and no clicked location is sent anywhere to compute it.
ArcGIS
Contacted only when the map uses ArcGIS.
| Provider | Addresses |
|---|---|
| ArcGIS Online | www.arcgis.com, basemapstyles-api.arcgis.com, static.arcgis.com, elevation3d.arcgis.com, and the servers of the ArcGIS services you add |
| ArcGIS Enterprise | Your own portal and servers |
Your own servers
Any file, tile, WMS, WFS, style or image link you add is fetched from the server in the link. That server must be reachable from the machine displaying the report, and must allow requests from Power BI custom visuals (CORS). See Troubleshooting.
Networks with no internet access
Turn on Airgapped Environment and host the basemaps yourself. See Power BI Report Server (on-premises).
Limits
| Limit | Value |
|---|---|
| Rows Power BI sends by default | 30,000 |
| Maximum rows, with Maximum data rows raised | 480,000, loaded in steps of 30,000 |
| Items that one selection can filter the report by | Set by Max Selections: 5,000 by default, up to 100,000. Items beyond the limit are left out of the filter |
| Text Power BI can hold in one value, which caps a WKT or GeoJSON shape held in your data | 32,766 characters |
| Map projections | Web Mercator and globe. Tile services must use Web Mercator tiles |
| Languages | English, German, Spanish, French, Portuguese. See Languages |
More on rows and performance is in Data rows and limits.