Icon Map


FAQs

  1. Can Icon Map be a certified visual?

    Unfortunately, Icon Map cannot be certified by Microsoft as one of the criteria for a certified visual is that a visual doesn’t access any external services.

    Accessing external services or resources. For example, no HTTP/S or WebSocket requests can go out of Power BI to any services.

    See more information on the criteria described in the Microsoft documentation.

    As Icon Map accesses the following external resources, it doesn’t meet these criteria. The following external resources can be accessed by Icon Map:

    • Map background tiles.

      Map background tiles (images containing the map itself) are shown as you move around the map and zoom in or out. These are requested based on the location of the area you are viewing and specific data points or longitude and latitude coordinates are not sent to the mapping provider. It possible to specify your own mapping provider or server.

    • Map overlay tiles.

      Similar to background tiles, overlay tiles are images with a transparent background that are shown overlayed on top of the map background tiles. Icon Map supports a number of pre-defined layers, or you can specify your own provider or server. Again these are requested based on the location of the area you are viewing and specific data points or longitude and latitude coordinates are not sent to the mapping provider.

    • WMS Layers

      Whilst a different protocol, WMS layers provide a similar capability to the map overlay tiles. Icon Map provides no pre-configured options so you must specify your own server or provider. Requests are based on the location of the area you are viewing and specific data points or longitude and latitude coordinates are not sent to the mapping provider.

    • Vector Tile Layers

      Vector tile layers work in the same way as the overlay tiles. The only difference is the format – these tiles are sent in Protobuf format and are formatted by Icon Map once retrieved. They are requested based on the location of the area you are viewing and specific data points or longitude and latitude coordinates are not sent to the mapping provider.

    • GeoJSON Layers

      These layers are read in their entirety from the URL specified by the report author. The URL specified will be called. No additional parameters are added by the map, so unless specifically configured by the report author using DAX based expressions, no data is sent from the data model.

    • Images

      Icon map has the ability to place images on the map based on a URL. URLs are specified using DAX based expressions by the report author. No additional information from the data model is sent via Icon Map.

    Geocoding

    Unlike some other map visuals for Power BI, Icon Map has no ability to geocode your data – eg take a place name or address and convert it to a longitude and latitude to determine where to place it on the map. Therefore, no information from the data model is sent to external services for this purposes. All data to display on the map must already have appropriate coordinates specified.

    Requests for the map resources above are made directly from the visual to the map providers’ servers. Icon Map runs within the report viewers web browser, so all requests come from the user’s web browser, not via the Power BI service.

    Licences

    Icon Map is a provided with a MIT licence. It makes use of a number of open source libraries detailed here: https://icon-map.com/licences.html

  2. Why do some of my WKT shapes not appear?

    If you have some WKT shapes that are not displaying on the map, but others do, in most cases this is due to invalid WKT caused by the text being truncated. The maximum length of a text value that the Power Query engine can load into a single cell in a table in a dataset is 32766 characters. If you attempt to load more than that, it won't error, but will be truncated.

    There are a number of approaches that we can take to work around this:

    1. Reduce the complexity of the WKT shapes by reducing the number of points. Tools like QGIS or MapShaper allow you to reduce the complexity of your shapes. Fewer points will mean shorter text which will more likely fit in a Power BI cell.
    2. Reduce the precision of the longitude and latitudes in your shapes. Some tools will export shapes with longitude and latitudes to 10 decimal places. This is often more precision than required for your map in Power BI. If you can reduce the number of decimal places, this can have a large impact across the whole of your polygons.
    3. Split your shapes into multiple columns or multiple rows when loading them with Power Query, and then combine them using a DAX measure. There are a number of blog posts and videos with different strategies for this. For example Chris Webb's Blog. This relates to images, but the principal is the same for WKT.