The shapes: a GeoJSON Geometry, Feature or FeatureCollection, in longitude and latitude on a map. Feature properties are columns for the channels.
geometrycolumn
A geometry column of the enclosing data, instead of data: a FeatureCollection given as a Plot's or Data's table has one named "geometry".
feature_keystring
The feature property that joins each feature to a row of the enclosing table, matched against data_key; "$id" uses feature.id.
data_keycolumn
The column of the enclosing table matched against feature_key; each key may appear once.
heightchannel
Each feature's extrusion: a number, or a property or column mapped through height_scale. Only polygons extrude, in 3D views. Default: 0.
height_scalescale
A continuous() scale from heights to extrusions: its domain (by default [0, 1]) maps onto its range (by default [0, 1], nonnegative and increasing); heights outside the domain clamp. The map is linear: a transform, a midpoint or a "symmetric" domain is an error.
plane"xy" | "xz"
In a Cartesian 3D plot, "xz" lays the features on the horizontal ground plane and extrudes them upward. Default: "xy".
fitboolean
On a 2D map, zoom to the features (a city's districts fill the plot, not a speck in a world map); a Plot's own viewport wins. False keeps the whole map. Default: True.
Appearance
fillchannel
The fill of regions and points: a CSS color, or a property or column mapped to colors. null (Python None) draws only lines and polygon boundaries, using color and width. Default: "#718b9b".
colorchannel
The color of LineString features and, with fill=null, polygon boundaries: a CSS color, or a property or column mapped to colors. Default: the fill.
sizechannel
The size of Point features: a number, or a property or column mapped to sizes. Default: 8 px.
widthchannel
The width of LineString features and, with fill=null, polygon boundaries: a number, or a property or column mapped to widths. Default: 1 px.
opacitychannel
The opacity, 0 to 1: a number, or a column (categories map through opacity_scale). Default: 1.
outline_colorchannel
The color of region and point outlines. Default: "#f4f2ed".
outline_opacitychannel
Border opacity from 0 to 1: a number, numeric column, array or expression. Fades the border over the fill; mark opacity still applies to both. Missing values hide the border. Default: 1.
outline_widthchannel
The width of region and point outlines; 0 draws none. Default: 0.7 px.
Scales
fill_scalescale
The fill's scale, which marks can share: continuous({domain, colormap, transform}) for numbers, categorical({domain, range}) or ordinal() for categories.
color_scalescale
A scale for color that marks can share.
colormapstring | color[] | object
The colormap of a numeric fill or color: a name, a list of colors, or {colors, space, positions}. Default: the theme's (Viridis).
size_scalescale
The size's scale, which marks can share: continuous({domain, range, transform}) for numbers (without a range, the automatic one), or categories with a numeric range.
width_scalescale
A scale for width that marks can share, as size_scale.
outline_color_scalescale
A categorical() scale from the outline_color column's categories to colors.
opacity_scalescale
A categorical() scale from the opacity column's categories to opacities, 0 to 1.
Display
labelstring
The mark's name in the legend and the settings pane.
legendboolean
Whether the mark has a legend entry. Default: True.
How the mark mixes with what is drawn under it; any mode but normal draws it transparent, and SVG and PDF exports draw additive and subtractive as an image. Default: "normal".
glownumber
How much the mark glows: its own color times glow blooms around it in the plot's presentation (0 does not glow); the Plot's bloom effect sets the bloom's strength and radius. SVG and PDF exports draw the whole plot as an image. Default: 0.
shadeShadeSpec
A plugin's shade (registerPlugin): { kind, ...parameters }, as { kind: "hatch", spacing: 6 } (Python hm.shade("hatch", spacing=6)), recolors each fragment the mark draws; picking, tooltips, domains and legends are unchanged. SVG and PDF exports draw a shaded mark as an image.
optionsstring[]
The settings the settings pane shows for this mark, by name.
namestring
The mark's name in the settings pane, and the name facet.endpoint() and partition.endpoint() find it by.
Interaction
hoverboolean | selection | object
Mark the row under the pointer as @hovered (a whole series for Line, Area), without fading the others: true uses its data's hover, or give a selection(). input("focus").set("series") writes an input instead: while the pointer is on a row the input shows its series (or .set(literal(v)), a constant), then its committed value again (a hover that would change this mark's own rows is an error).
tooltipboolean | field[] | object
Show the nearest row's values in a box by the pointer: true, a list of fields, or {fields, radius, content}. Default: the Plot's.
Which interaction states fade this mark's other rows to selection_opacity; "hovered" fades them while hovering, "nearest" while a row is nearest. Default: the states it sets, except hover and nearest.
selection_opacitynumber
The opacity of the rows outside the selection while one is active. Default: 0.25.
Animation
animationboolean
Animate changes to the mark's values. Default: False.
animation_durationnumber
How long an animated change takes. Default: 300 ms.
This mark's own z transform, instead of its frame's. Default: its frame's.
z_invertbooleansetting
Reverse this mark's z direction. Default: False.
zbounds[number, number]setting
The z extent this mark maps, instead of its frame's domain (an image's or a grid's extent). Default: its frame's.
zrange[number, number]setting
Where this mark's z extent lands, in its frame's world units. Default: its frame's.
Shading
litbooleansetting
Shade the mark with the plot's lights. Default: False.
transparentbooleansetting
Draw the mark in the transparent pass, blended in depth order with other transparent marks. Default: False.
Map settings
missing_colorcolorsetting
The color of the features the data has no value for: no joined row, or a missing (NaN) value. Default: the fill scale's missing, else the theme's (#92989f in the default theme).
Usage
Accept data as Geometry/Feature/FeatureCollection, or geometry from a Data scope. Feature properties are fields; featureKey/dataKey joins measurements. A numeric fill maps through fillScale (by default over the values’ extent, as on other marks) or the colormap; a numeric line color through colorScale. Height is per feature, mapped through heightScale, a continuous() scale from its domain (by default [0, 1]) onto its range (by default [0, 1]), clamped at its ends; polygons alone extrude. Longitude/latitude are degrees even when the plot uses other angular units.
Set fill={null} (Python fill=None) to draw only LineStrings and polygon boundaries,
without filling or triangulating polygons. This replaces GeoJSONLine. color and width style all those strokes, including property columns and colorScale; the default stroke is #425669, one pixel wide. Feature joins and picking work as for filled regions. Changing fill switches between filled regions and boundaries on the same component.
Set tooltip to true or a list of feature-property/joined-column names, as on other marks;
the Plot’s tooltip is the default. hover marks the whole feature, including every polygon
part, boundary and point. Add respond="hovered" to fade other features, with selectionOpacity (Python selection_opacity) setting their opacity. Joins and geometry
columns share their enclosing table’s row identity, so hover coordinates with other marks;
unmatched features do not mark a table row. Raw GeoJSON owns feature rows of its own.
Brush and drag are not GeoJSON producers.
A GeoJSONHandle has getLegendSource(), whenSettled() (once its geometry is prepared and drawn) and getDiagnostics() (features, instances and geometry bytes).