Interactions
Last updated
Was this helpful?
Last updated
Was this helpful?
Builder interactions allow you to configure various UI options to display the attributes associated with a layer. Interactions are disabled by default but can be enabled for each individual layer using the toggle button. Once enabled, you can choose from the following options:
Click: Users can extract insights by clicking on a feature rendered on the map.
Hover: Users can extract insights by hovering over a feature on the map.
For vector sources, features that are clicked or hovered over will be highlighted in a distinct style, provided the source includes a column named geoid (serving as a unique identifier) or is of a spatial index type.
Interactions can be displayed in two formats:
Pop-up windows: Click and hoover-type interactions can be styled in various themes, such as light, dark ,etc.
Info panel: Click-type interactions can also appears in the right-side panel with a default style.
Interactions can be customized either manually or through custom HTML code, with support for properties in vector layers and both properties and custom expressions in raster layers:
Adding Properties Manually: For vector layers, users can set labels and customize formats for their properties. For raster layers, users can configure bands (properties) and also define custom expressions to enhance data visualization and analysis.
Using HTML Custom Code: This method offers flexibility for both vector and raster layers. While vector layers allow users to design tailored interaction layouts using properties, raster layers support both properties and custom expressions for advanced configurations.
Interactions make it easy to explore and understand your map data by showing details about features. You can use pop-ups, which appear next to a selected or hovered feature, or info panels, which display detailed information on the right side of the map.
There are two primary types of interactions available:
Click Interactions: Retrieve information when you click on a feature in the map.
Hover Interactions: Display information when you hover over a feature in the map.
Non-aggregated layers
How it works: Information is retrieved directly from the server when you click on points, lines, or polygons.
Highlighting: Features are automatically highlighted when clicked.
Aggregated layers
How it works: Information is calculated on your computer for aggregated data (e.g., spatial indexes, cluster, etc.).
Aggregation operation: You’ll need to specify how data is aggregated (e.g., totals, averages).
Non-aggregated layers
How it works: Information is retrieved on your computer for individual points, lines, or polygons when you hover over them.
Highlighting: Requires a unique identifier column named geoidto enable highlighting.
Limitations:
Up to 5 columns of information can be displayed.
Column character values are limited to 150.
Aggregated layers
How it works: Information is calculated on your computer for grouped data when you hover over it.
Aggregation operation: You’ll need to specify how data is aggregated (e.g., totals, averages).
You can use the menu to choose between a pop-up window (displayed next to the feature on the map) or an info panel (added to the right-side panel).
You can add attributes by including them as a list or customize pop-ups to meet your specific requirements using HTML. With HTML customization, you can add images, modify styles, and more to create tailored user experiences.
