Skip to main content

Interface: VisualizationLayer

Defined in: spec/types.ts:377

Properties​

activeLegendId?​

optional activeLegendId?: string

Defined in: spec/types.ts:390

Id of the currently active legend from legends[].

click?​

optional click?: LayerClickConfig

Defined in: spec/types.ts:457

Spec-driven click reaction. When present, <GeoVisProvider> invokes click.onSelect for features clicked on this layer — without the consumer placing a component or calling useGeoVisClick() in the tree. Declaring click also opts the layer into click tracking, so activeLegendId is not required. Typed via a type-only import so the data-only spec layer keeps no runtime dependency on React (mirrors hoverTooltip).

clickAnchor?​

optional clickAnchor?: object

Defined in: spec/types.ts:414

Spec-driven click marker. When present, geovis automatically places a visual indicator on the clicked feature without requiring a <GeoVisMarker> component. Three rendering modes — see field descriptions.

color?​

optional color?: string

Accent colour for the built-in SVG pin. Applied when iconImage is not set. Default: '#3FB1CE'. For a custom HTML/React element, use <GeoVisMarker> instead.

iconImage?​

optional iconImage?: string

MapLibre sprite icon name. Renders a feature-state-driven companion symbol layer at the polygon label point.

iconSize?​

optional iconSize?: number

Scale factor for the sprite icon. Default: 1.

latKey?​

optional latKey?: string

Feature property key holding the latitude. Paired with lngKey, geovis reads the pin position from feature.properties instead of the tile geometry to avoid drift at high zoom.

lngKey?​

optional lngKey?: string

Feature property key holding the longitude. Must be paired with latKey.

offset?​

optional offset?: [number, number]

Pixel offset [x, y] applied to the DOM marker.

filter?​

optional filter?: LayerFilter

Defined in: spec/types.ts:482

Declarative predicate that hides features not matching it, compiled to the engine's native filter expression (dispatch({ type: 'set-filter' }), PRD-002). Reads feature.properties[property] — the same direct-access path propertyName uses above, not the mapData-joined feature-state value. Gated by CapabilitySet.dataFeatures.filter per source type.

geometry​

geometry: GeoVisGeometryType

Defined in: spec/types.ts:380

hoverPaint?​

optional hoverPaint?: object

Defined in: spec/types.ts:402

Paint applied via MapLibre setFeatureState({ hover: true }) when the pointer enters a feature. When present, the adapter adds a companion line layer (<id>-hover-outline) driven by feature-state expressions.

lineColor?​

optional lineColor?: string

lineWidth?​

optional lineWidth?: number

hoverTooltip?​

optional hoverTooltip?: HoverTooltipConfig

Defined in: spec/types.ts:448

Spec-driven hover tooltip. When present, <GeoVisProvider> automatically renders a <GeoVisHoverTooltip> for features hovered on this layer — without requiring the component to be placed in the tree. Mirrors GeoVisHoverTooltipProps (render, formatValue, style, offset, emptyValueLabel, className). An empty object ({}) opts in to the default tooltip layout. Typed via a type-only import so the data-only spec layer keeps no runtime dependency on React.

id​

id: string

Defined in: spec/types.ts:378

legends?​

optional legends?: LegendSpec[]

Defined in: spec/types.ts:388

Optional alternative legend definitions presented as runtime toggles.

mapDataId?​

optional mapDataId?: string

Defined in: spec/types.ts:396

Optional reference to an entry in spec.mapData. When present, the layer can be styled/queried by per-feature values coming from the dataset (joined via feature.id or mapData.joinKey).

maxzoom?​

optional maxzoom?: number

Defined in: spec/types.ts:385

minzoom?​

optional minzoom?: number

Defined in: spec/types.ts:384

paint?​

optional paint?: LayerPaint

Defined in: spec/types.ts:386

propertyName?​

optional propertyName?: string

Defined in: spec/types.ts:474

GeoJSON feature property name for direct data access without mapData.

When set (and mapDataId is absent), the proportional circles expression reads values directly from feature.properties[propertyName] via MapLibre's ['get', propertyName] syntax — no feature-state join needed.

When mapDataId is also set, this field is ignored in favour of the standard feature-state resolution.

selectedPaint?​

optional selectedPaint?: object

Defined in: spec/types.ts:408

Paint applied via MapLibre setFeatureState({ selected: true }) when a feature is clicked. When present, the adapter adds a companion line layer (<id>-selected-outline) driven by feature-state expressions.

lineColor?​

optional lineColor?: string

lineWidth?​

optional lineWidth?: number

sizeBy?​

optional sizeBy?: SizeBy

Defined in: spec/types.ts:463

Proportional symbol configuration. When present on a point layer, circle-radius is driven by a data expression instead of a static value. Ignored on non-point geometries.

sourceId​

sourceId: string

Defined in: spec/types.ts:379

sourceLayer?​

optional sourceLayer?: string

Defined in: spec/types.ts:381

title?​

optional title?: string

Defined in: spec/types.ts:382

transition?​

optional transition?: LayerTransition

Defined in: spec/types.ts:500

Opt-in animated transition applied when this layer's source data changes between two specs. Only honoured for point (circle) layers backed by a geojson source; ignored otherwise. When declared, the adapter fades the OLD points out while the NEW points fade in, instead of swapping data instantly. Omit it to keep the instant setData behaviour.

Example​

const layer: VisualizationLayer = {
  id: 'stores',
  sourceId: 'stores-src',
  geometry: 'point',
  transition: { kind: 'crossfade', durationMs: 600, easing: 'ease-in-out' },
};

visible?​

optional visible?: boolean

Defined in: spec/types.ts:383