Images and icons

The Images / Icons layer places a picture at each longitude and latitude. The picture can come from your data, from one image link, from the built-in icon library, or it can be a short piece of text or an emoji drawn as a badge.

What you need

These fields must be empty on an image's rows: Circle Size, Destination Longitude, Destination Latitude, Feature Reference, Heatmap Weight and Cell (H3/S2/A5/Geohash) Weight.

Add images to the map

1. Add fields to * ID (required), Longitude (X) and Latitude (Y). Set the coordinates to Average.
2. If your data holds an image for each row, add that field to Image / WKT / GeoJSON.
3. If the panel What kind of map are you making? is showing, select the Images & icons tile. It turns the layer on and opens the Layer Manager on it. Otherwise, in the Format pane expand Layer Manager, switch on Open Layer Manager, and select Add a layer, Data layer, Images & icons.
4. Under Images come from, choose where the pictures come from, and set the Width and Height.
5. If you are adding the layer, select Add to map. Then select Apply changes.

The Layer Manager offers these settings. To change them later, open the Layer Manager and select the Images & icons row.

The icon library browser, rotation, offsets and conditional formatting (fx) are in Format pane > Data Layers > Images - Configuration, and the other cluster settings in Cluster - Configuration.

Where the image comes from

Image Source has three options.

URL from data

Each row carries its own image in the Image / WKT / GeoJSON field. The value can be:

Links must use https://. A link starting with http:// is not treated as an image. The server that hosts the images must allow them to be read from other sites (CORS), otherwise they cannot be drawn. Data URIs and SVG text are held in your data, so they need no server.

Custom URL

One image link for every point, entered in Image URL. Rows need nothing in the Image / WKT / GeoJSON field. Image URL has an fx button, so a measure or rule can still choose a different link per row.

Icon Library

Icons from the built-in library of Material Design icons, in five styles, each on its own tab: Filled, Outlined, Round, Sharp and Two tone.

1. Set Image Source to Icon Library.
2. Switch on Show Icon Library. A dialog opens.
3. Choose a style tab, type in the Search box and select an icon. The dialog shows the first 200 matches, so refine the search if you do not see the icon you want.
4. Select OK. The icon's name is written to Icon Name / Text.

An icon name looks like material-design-icons/filled/home. Because Icon Name / Text has an fx button, you can hold icon names in a column or return them from a measure, and show a different icon for each row. Set the icon's color with Icon / Background Color, which also takes fx. A library icon is square: Image Width sets both its width and height.

Text and emoji badges

With Image Source set to Icon Library, any value in Icon Name / Text that is not a library icon name is drawn as text on a rounded badge. Emoji work too.

• The badge is as tall as Image Width and as wide as the text needs.
• Icon / Background Color and Icon Background Transparency set the badge.
• Icon Text Color sets the text.

You can also set the text color in the value itself with a prefix:

The named colors are white, black, red, amber, orange, yellow, green, blue and gray.

Settings

All of these are in Format pane > Data Layers > Images - Configuration, shown when the Images / Icons switch is on.

Offset overlapping images

When several rows share a location, for example three assets at one site, their images sit exactly on top of each other. Turn on Offset Overlapping Images to lay them out in a horizontal row centered on the location, Offset Gap (pixels) apart. Raise Offset Tolerance (meters) to treat images within that distance as being at the same place. Offsets apply to images that are not in a cluster.

Selection, tooltips and labels

• Selection. Select an image to cross-filter or cross-highlight the report page. Images you did not select fade, using the transparency values in the Interactivity card. See Selection, cross-filtering and highlighting.
• Tooltips. With no fields in Tooltips, the tooltip shows the ID. Add fields to Tooltips to show those instead. See Tooltips.
• Labels. Images can carry data labels at the center, above, below, left or right of the image. See Data labels.
• Legend. Images appear in the legend as Icons. See Legend.

Tips and limits

• An image is anchored at its center. For a pin whose tip should touch the location, use an image with empty space below the tip so that the tip is at the center.
• Images never hide each other. Where they overlap, all of them are drawn.
• Images have their own position in the drawing order, set by the Images Z Index. The default, 410, draws them above Lines (409) and Circles (405). Their data labels stay with the other data labels, above the images.
• For images hosted on a web server, check that every link opens over https:// and that the server allows cross-origin requests.
• Text badges and SVG values that repeat are drawn once and reused, so a few distinct values across many rows stay fast. Thousands of different remote images are slower: prefer small files, or library icons colored with fx.
• If your network blocks external sites, library icons can be served from your own server. See Power BI Report Server (on-premises).

Related

• Circles
• Clusters
• Conditional formatting
• Combine several layers in one map
• Data layers overview