# Image Map

## Overview

The Image Map widget allows you to put your sensors on images, such as:

* Floor Plans
* Industrial Flow Charts
* Any other kind of map or plan

![](https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2Fz8O5mqENZxemPYbjTeCW%2FBildschirmfoto%202022-06-08%20um%2017.40.49.png?alt=media\&token=56eee8fb-2c38-4732-8340-8b2b2ae7ff04) ![](https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2F7MR2U3sDBpfURtsDZXy1%2FBildschirmfoto%202022-06-08%20um%2017.40.58.png?alt=media\&token=8bcef96e-fb58-4d71-b7c6-da3267d135ee) ![](https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2FUybTzRl3kvM9sxewpged%2FBildschirmfoto%202022-06-08%20um%2017.40.53.png?alt=media\&token=d2633c6f-6a70-40fe-8dcc-1d8de619d362)

## Basics

### Title

You can set a custom title for your image map widget.

### Upload Image

By clicking on the change button of an image map widget you can upload a custom image into the widget.

![](https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2FMSBED4X4BBkfHDpmQbfG%2FBildschirmfoto%202022-06-01%20um%2009.09.03.png?alt=media\&token=056a9d02-0a7d-4411-a2ac-f63f3f86f8a5)

#### Supported Images

* JPG
* PNG

### Delete or Change Image

Simply upload a new image to override the existing one.

## Add Sensors or Devices

In order to add your Datacake Devices to an Image Map Widget you need to navigate into the "Data" tab.

We have created a short video that shows you how you can add Sensors to your images. Please have a look at the following video:

{% embed url="<https://www.loom.com/share/088a783c913540ada23f9a7533e9d8c8>" %}
How to Add Sensors to Image Map Widget
{% endembed %}

### Choose Device

Using a drop-down you can select one of the devices from your current workspace.

### Select Field

Next, you have to select the field which you want to display.&#x20;

#### Supported Types

Currently, we support the following field types:

* Integer, Float (Numerical)
* String
* Boolean States

### Set Label

You can also set a custom label which will be shown when you hover over an icon on the image map widget. Default is set to Field Name.

### Set Unit

Optionally you can also provide a unit to the value.

### Edit Position

In order to place an icon on the map, you have to click on the "Edit Position" Button.&#x20;

![](https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2F4AjsYbimel9zTVonef8n%2FBildschirmfoto%202022-06-01%20um%2009.26.27.png?alt=media\&token=2782a01e-91b6-4477-94c0-9d5fac9db442)

This will open up another view of the image where you can drag the icon to any position within the image map widget.

#### Icon Size

In the position editor, you also find a slider that allows you to change the size of the device widget on the map.

### Edit Appearance

#### Numerical Values

By enabling the option "Marker color based on state" you can define a value range and color for the icon. The icon border is colorized based on the colors you define here.

#### Boolean

When the selected field is of type "Boolean" you can set a text and color for either the True or False state of that field.

## Appearance

The Image Map Widget supports overriding a few of the default appearance settings.

![](https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2FP3cPqJj2Xv2xXFqmVurq%2FBildschirmfoto%202022-06-01%20um%2009.02.54.png?alt=media\&token=bbaaf4af-1372-4f22-a194-973c08cfe0e7)

### Change Colors

You can override the default colors.

#### Text Color

Sets an individual color for the text of an icon.

{% hint style="info" %}
This is not valid for Boolean Fields. Colors you set on boolean appearance will override these settings.
{% endhint %}

#### Icon Color

Sets an individual color for the icon background color. The default is black. You might want to use brighter colors for darker images and vice versa.

### Public Dashboards

By enabling the "Show Device Details on public Dashboards" option, you allow Device Icons on Images to be clickable on a publically shared Dashboard.

### Full Height Images

By enabling this your Image Map Widget will always scale to the maximum height possible, no matter which height you have set on the dashboards designer.

{% hint style="warning" %}
Please make sure you don't place any widgets below the Image Map when enabling this option as they would be covered by the full height option.
{% endhint %}