The Map Widget Node provides a geospatial visualization interface that plots device locations using real-time or historical latitude and longitude values. It supports Google Maps, clustering, geofencing, conditional icon logic and more.
What It Does
The widget renders a map with markers representing each UID/device using GPS coordinates. It supports hover panels, tooltip displays, clustering behavior, and condition-based styling (icons or colors) using JSON key inputs.
Step-by-Step: How to Configure the Map Widget
-
Add the widget to your workflow
-
Drag the Map Widget from the Widgets section to your canvas.
-
-
Connect to data
-
Make sure upstream nodes provide valid latitude and longitude JSON keys per UID.
-
-
Configure base settings
-
Choose map source, default zoom, marker style, and toggle optional layers.
-
-
Assign geolocation keys
-
Define which JSON keys to use for device coordinates.
-
-
Set optional logic and overlays
-
Use conditional logic for icon switching, enable geofences, or add KMZ layers.
-
-
Add to an interface
-
Attach the widget to one or more interfaces and group it per label if needed.
-
Configuration Fields
General Settings
| Field | Requirement | Description |
|---|---|---|
| Widget Name* | Required | Title of the widget displayed in the interface. |
| Widget Subtitle | Optional | Appears under the widget name for context. |
| Widget Header | Optional | Toggle to show or hide the widget’s title/header bar. |
| Map Source | Required | Choose Google Map (default). |
| Show UID / Label Name | Optional | Display the device name or label on the marker. |
Default Map Settings
| Field | Requirement | Description |
|---|---|---|
| Default Map Type | Optional | Choose from standard map types (e.g., Map, Satellite). |
| Default Latitude/Longitude | Optional | Map’s starting center point. |
| Use Default Settings | Optional | Enables the above lat/lon as initial viewport. |
| Default Zoom Level (0–22) | Optional | Initial zoom level of the map. |
| Show Places of Interest | Optional | Displays nearby labeled POIs (Google Maps only). |
| Enable Auto Zoom | Optional | Adjusts zoom based on plotted marker spread. |
| Show Clusters | Optional | Group nearby markers into clusters. |
| Default Map Icon | Optional | Upload or choose a marker icon from the library. |
Location Data Settings
| Field | Requirement | Description |
|---|---|---|
| UID Latitude JSON Key | Required | Payload key containing latitude. |
| UID Longitude JSON Key | Required | Payload key containing longitude. |
| Zoom Factor | Optional | Adjusts auto-zoom scaling per label/group. |
Geofence Options
| Field | Requirement | Description |
|---|---|---|
| Hide Geofence Editing | Optional | Prevent user from modifying geofences in UI. |
| Hide Geofence Name in Tooltip | Optional | Hides geofence label in marker hover. |
| Display Geofence Border | Optional | Renders geofence shapes on the map. |
Icon Logic Based on JSON Key
Use condition-based logic to change marker icons dynamically.
| Field | Description |
|---|---|
| Input Data Field | JSON key to evaluate. |
| Operator | e.g., =, <, >, != |
| Value | Target value to compare against. |
| Then Show (Icon) | Select or upload icon if condition is met. |
| Cluster Color | Set the cluster color under matching conditions. |
Multiple rules can be defined.
Heatmap
| Field | Description |
|---|---|
| Enable Heatmap | Show intensity of events/metrics as a heatmap layer. |
Indoor Layout / KMZ Layer
| Field | Description |
|---|---|
| Layer Field Name | JSON key used to determine which layer to show. |
| Upload Layer | Add indoor floorplans or layout images. |
| KMZ File | Upload KML/KMZ format for boundary overlays. |
Hover Panel
| Field | Description |
|---|---|
| Hover Panel Name | Name displayed on hover panel title. |
| Include Primary UID in Name | Appends UID to panel title. |
| Show Last Payload Timestamp | Appends last seen timestamp in hover. |
| Hover Panel Data (key-value pairs) | Add rows: Label (e.g., Battery) + JSON Key (e.g., battery_level) |
Link To Interface (Drill-Down)
| Field | Description |
|---|---|
| Allow Drill Down by Label | Enables redirection based on selected label. |
| Interface to Link To | Choose destination interface for drill-down. |
Refresh and Tooltip Settings
| Field | Description |
|---|---|
| Refresh | Force update widget data. |
| Tooltip | Toggle to show hover help. |
| Enable Tooltip | Display additional field info on hover. |
Display Options
| Field | Description |
|---|---|
| Number of Widgets to Display | One per label or one unified map. |
| Select Label | Choose label for grouping widgets. |
Best Practices
-
Use label grouping for one map per region, site, or category.
-
Enable clustering for dense marker areas to improve readability.
-
Use icon logic to visually distinguish asset status or type.
-
Keep zoom level and center tuned to relevant geography.
-
When using geofencing, validate coordinates and radius in test mode.
Use Cases
-
Plot live vehicle, drone, or asset locations
-
Visualize sensor data by position across geographic zones
-
Show presence or movement of field teams on a map
-
Use heatmaps or layers to highlight areas of interest (e.g., temperature zones, production density)
FAQ
Q: Can I show multiple types of icons on one map?
A: Yes — use Icon Logic Using JSON Key to change icon styles dynamically.
Q: Does the widget support offline tiles or custom map sources?
A: No, only Google Maps is supported at this time.
Q: How are hover panels different from tooltips?
A: Tooltips show quick info; hover panels display structured data like battery level, timestamp, etc.
Step by Step section for Geofence
- In order to create your geofences on the map, you will need to log into your Rayven’s dashboard account.
- Go to the selected map you wish to have the geofence on.
- Click on the expand icon to open the pop up window to the map.
- You are able to select the different geofence shapes; circle, rectangle, and polygon.
- Then, you can draw freely on the map to create various geofences.
- After drawing the geofence, right click on the geofence. You are able to enter a unique name for the geofence created by selecting “Enter Fence Name”.
- You can also enter the fence zone distance (which is in KM si unit) by selecting “Define fence zone”.
- You can also enter the buffered zone distance (which is in KM si unit) by selecting “Define Buffer Zone”.
- To remove the geofence, select “Remove this fence”.
- You can also change the color of the geofence by selecting the pre-selected colors from the drop down menu.
- After setting up your geofence, click on the save icon to save your geofence on the map.