Datacake Docs
  • Welcome
  • Get Started
  • Changelog
  • Best practices
    • Best practices: Getting started
    • Best practices: Resolution (Timeframe)
    • Best practices: Dashboards
    • Best practices: Reports
    • Best practices: Grouping Devices
  • Datacake LNS
    • Getting Started
    • Gateways
      • Milesight LoRaWAN Gateway - UG6x
      • RAKwireless WisGate Edge Light 2
    • Devices
    • Add Devices without Gateway
  • Device
    • Product
    • Configuration
    • Claiming
    • Historical Data
    • Database
      • Configuration Fields
      • Fields
        • Manual input
        • Field Roles
        • Formulas
        • Mapping Fields
      • Data retention & Datapoints
      • Examples
        • Mapping 4-20mA Signals
        • Converting Units
  • Dashboards
    • Global Dashboards
      • Setting Homepage
    • Device Dashboards
    • Multi-Device Dashboards
    • Widgets
      • Value Widget
      • Chart Widget
      • Image Map
      • Map Widget
      • Text Widget
      • SOS Widget
      • Boolean Widget
      • iFrame Widget
      • Downlink Widget
      • Set Value Widget
      • Measurement List Widget
      • Heatmap Widget
      • Table Widget
      • Image Widget
  • Portal
    • Multi-Tenancy (Workspaces)
    • Reports
      • Energy Report
    • Administrators
    • Members
      • API Users
    • Security & Privacy
    • Billing
      • Support Packages
      • VAT Exemption / Tax ID
      • SMS Credits
      • Access Invoices
      • Unused time and Remaining time in Invoices (Prorations)
      • Codes
    • White Label
    • Rules
      • Legacy Rule Engine
        • Sending notifications via Telegram
      • New Rule Engine
        • Rule Engine Table Overview
        • Copy/Paste and Template Functionality
        • Advanced Rule Engine E-Mail and Webhook Templates
        • Time Restrictions
    • Zones
  • Cake Red
    • Get Started
    • Overview
  • LoRaWAN
    • Get Started
      • CSV Import
      • Custom LoRaWAN Device
    • Configuring LNS
      • The Things Stack (TTN / TTI) Automated Setup
      • The Things Stack (TTN / TTI) Manual Setup
      • Loriot
      • Kerlink Wanesy
      • Helium
      • ChirpStack
      • Tektelic
      • Actility ThingPark
      • Senet
      • Milesight Gateway
      • KPN
    • Downlinks (LoRaWAN)
      • Set Time Frame
    • Securing Webhooks
    • Payload Decoders
      • Location and GPS
      • Access Gateway Metadata
      • Access Measurements
      • Global Variables
    • Using Cayenne LPP
    • Converting Payload
  • Generic API Devices
    • HTTP Downlinks
  • Integrations
    • MQTT
    • Particle
      • Get Started
      • Adding Integrations
      • Decoding Payloads
      • Calling Functions
      • Templates
        • Particle Tracker One
    • Incoming Webhooks
    • Outgoing Webhooks
      • Securing Outgoing Webhooks in Datacake
    • Golioth
    • Blues Wireless Notecard
    • Sigfox
    • Swarm Asset Tracker
    • Grandcentrix Modbus Cloud Connect
    • YuDash LYNX IoT Gateway
    • Dragino NB-IoT
      • Changing NB-IoT Bands
    • Hardwario CHESTER
    • 1NCE OS
  • API
    • Exporting Data
    • Record Measurements via API
    • Node RED to Datacake
    • Generate Access Token
    • Internal MQTT
      • Get Started
      • MQTT Documentation
      • MQTT over WebSocket
      • Example Code
    • GraphQL API
      • Using GraphQL
      • Device Creation
      • Tutorials
        • Read Group via Tags
  • Guides
    • Python
    • Send Slack Notifications
    • Forward Data to Cake Red
    • Multiple Data Feeds
    • Automated Dynamic Downlinks
    • Ingesting JSON Data into Datacake API Devices
    • Working with Default HTTP Decoder on API Devices and Code Examples
    • Accessing Measurements in Decoders
    • Connecting Datacake to Notion Using Zapier
    • How to set up and use location on non-GPS devices
    • How to integrate with AWS IoT Core
    • How to Schedule Mass-Downlinks (Multicast) using Datacake Rule Engine
    • How to Map Sensor Values to Ranges or Booleans, Strings using Mapping Fields
    • Understanding Internal vs. External MQTT Brokers on Datacake
    • Sending UDP Messages between 1NCE OS and Datacake
    • Concepts of LoRaWAN Payload Decoders on Datacake
    • How to check if a value stays above or below limits for given time
Powered by GitBook
On this page
  • Overview
  • Basics
  • Title
  • Upload Image
  • Delete or Change Image
  • Add Sensors or Devices
  • Choose Device
  • Select Field
  • Set Label
  • Set Unit
  • Edit Position
  • Edit Appearance
  • Appearance
  • Change Colors
  • Public Dashboards
  • Full Height Images

Was this helpful?

  1. Dashboards
  2. Widgets

Image Map

Place your sensors on floor plans and other images.

Last updated 9 months ago

Was this helpful?

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

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.

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:

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.

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.

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.

Change Colors

You can override the default colors.

Text Color

Sets an individual color for the text of an icon.

This is not valid for Boolean Fields. Colors you set on boolean appearance will override these settings.

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.

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.

How to Add Sensors to Image Map Widget