Use styling to control the visualization of the data contained in your map's layers. By editing attributes like color, size, stroke width, and more, you can highlight key attributes of your data and create maps that help you understand patterns or identify outliers in your geospatial data.
Edit styling for a layer by using the edit styling button in the Layers panel:
This list contains styling options that are used across different layers, but the options available for each layer vary based on the kind of data contained within the layer. For example the Fill polygons option only appears when the styler being configured render as a polygon. Within each option, the available modes also vary by the layer type: property, function, and measure based styling are only available on object layers, while fixed styling is available on every layer type.
Use the Color section to control the coloring for objects in the layer. The Color by dropdown contains the various modes that can be used for coloring:
When coloring by a function, property, or time series that has numeric values, use the gradient editor to map values to output colors. The colors used in the gradients can be edited by selecting points the gradient bar. The numerical range (min/max) for the color gradient is automatically inferred, but this can be toggled off to set the range manually.
When coloring by a function, property, or time series that has string values, the Color mapping dropdown contains methods for mapping values to colors:
Use the Opacity section to control the transparency for objects in the layer.
The Value from dropdown contains the various ways you can specify opacity:
Fixed: Select a single opacity that uniformly applies to all objects in the layer.
By time: When rendering tracks or objects that are events, control their opacity based on the global time selection.
The Value from dropdown and By time opacity options will only appear when styling tracks or objects with event data.
Use the Zoom levels section to control the visibility range of the objects in the layer. The caret symbol indicates your current zoom level.
When the viewport is at a zoom level within the active range, the corresponding geometry will be rendered on the map. When outside the range, the corresponding geometry will be hidden.
The zoom level configuration only applies to layers that are toggled to be visible.
Use the Stroke width section to control the width used when rendering lines.
Use the Stroke style section to control the dash pattern used when rendering lines. The available options are:
Solid
Dashed
Dotted
For line segments, use the stroke style section to optionally display arrows, as pictured below.
When Fill polygons is enabled, polygons render with a minimal stroke and their interior filled with the specified color. When disabled, the polygon is instead only stroked, using the styling configuration in Stroke width and Stroke style.
When configuring an icon styler, use the Icon section to configure the icon that is rendered for each object. The Icon source dropdown contains the modes that can be used for assigning icons:
When configuring an icon styler, use the Marker shape section to configure the shape of the marker that the icon is rendered within. The available options are:
Circle
Pin
None
By default, when coloring a layer by property, function, or measure, a legend will display the color mapping to help you interpret the colors when viewing your map. You can remove the legend by disabling the Include in legend toggle. Similarly, when coloring by a fixed color, you can opt-in to showing a legend entry by turning Include in legend on.
There are two optional toggles related to labels and tooltips:
Show labels: Controls whether a label appears on the map for each item in the layer. Show tooltips: Controls whether items in the layer will show a pop-up with contextual information when hovered.
For object-backed layers, labels and tooltips may contain the following:
Properties or series can also be added from the selection panel using the … menu that appears when hovering on a property or series, as pictured below.
Each object in an object layer can render in multiple ways on the map by specifying multiple stylers. For example, an object with a geohash
type property could be rendered as both a pin marker and a circle.
Edit the stylers for an object layering by opening the layer's styling panel. Expand any individual styler to edit its styling options (color, opacity, and so on), or add a new styler using the Add styler button:
The add styler menu contains two sections:
The advanced styler types that you can explicitly configure for an object layer are:
When the geometry source used in a styler is a track--a position that changes over time--there are additional options that configure how the map selects the point location to use given the track and the temporal cursor.
Saved styles allow you to save multiple different stylings of your map and switch between them. Providing many styles with one map can help you or consumers of your map understand many different dimensions of the data being visualized without needing to manually edit layer styles.
Create a saved style using the New style button, and give it a name that will help users understand what that style helps them visualize:
Then switch between styles using the Saved styles dropdown: