CircleLayer is a style layer that renders one or more filled circles on the map.
Prop | Type | Default | Required | Description |
---|---|---|---|---|
style | CircleLayerStyleProps |
none |
false |
Customizable style attributes |
sourceID | FIX ME UNKNOWN TYPE |
MapLibreGL.StyleSource.DefaultSourceID |
false |
FIX ME NO DESCRIPTION |
circleSortKey
visibility
circleRadius
circleColor
circleBlur
circleOpacity
circleTranslate
circleTranslateAnchor
circlePitchScale
circlePitchAlignment
circleStrokeWidth
circleStrokeColor
circleStrokeOpacity
Sorts features in ascending order based on this value. Features with a higher sort key will appear above features with a lower sort key.
- Type
-
number
- Expression Parameters
zoom, feature
Whether this layer is displayed.
- Type
-
enum
- Default Value
visible
- Supported Values
-
-
visible
: The layer is shown. -
none
: The layer is not shown.
-
Circle radius.
- Type
-
number
- Default Value
5
- Units
pixels
- Minimum
0
- Expression Parameters
zoom, feature, feature-state
The transition affecting any changes to this layer’s circleRadius property.
- Type
-
{ duration, delay }
- Units
-
milliseconds
- Default Value
-
{duration: 300, delay: 0}
The fill color of the circle.
- Type
-
color
- Default Value
#000000
- Expression Parameters
zoom, feature, feature-state
The transition affecting any changes to this layer’s circleColor property.
- Type
-
{ duration, delay }
- Units
-
milliseconds
- Default Value
-
{duration: 300, delay: 0}
Amount to blur the circle. 1 blurs the circle such that only the centerpoint is full opacity.
- Type
-
number
- Default Value
0
- Expression Parameters
zoom, feature, feature-state
The transition affecting any changes to this layer’s circleBlur property.
- Type
-
{ duration, delay }
- Units
-
milliseconds
- Default Value
-
{duration: 300, delay: 0}
The opacity at which the circle will be drawn.
- Type
-
number
- Default Value
1
- Minimum
0
- Maximum
1
- Expression Parameters
zoom, feature, feature-state
The transition affecting any changes to this layer’s circleOpacity property.
- Type
-
{ duration, delay }
- Units
-
milliseconds
- Default Value
-
{duration: 300, delay: 0}
The geometry's offset. Values are [x, y] where negatives indicate left and up, respectively.
- Type
-
array
- Default Value
[0,0]
- Units
pixels
- Expression Parameters
zoom
The transition affecting any changes to this layer’s circleTranslate property.
- Type
-
{ duration, delay }
- Units
-
milliseconds
- Default Value
-
{duration: 300, delay: 0}
Controls the frame of reference for circleTranslate
.
- Type
-
enum
- Default Value
map
- Supported Values
-
-
map
: The circle is translated relative to the map. -
viewport
: The circle is translated relative to the viewport.
-
- Requires
circleTranslate
- Expression Parameters
zoom
Controls the scaling behavior of the circle when the map is pitched.
- Type
-
enum
- Default Value
map
- Supported Values
-
-
map
: Circles are scaled according to their apparent distance to the camera. -
viewport
: Circles are not scaled.
-
- Expression Parameters
zoom
Orientation of circle when map is pitched.
- Type
-
enum
- Default Value
viewport
- Supported Values
-
-
map
: The circle is aligned to the plane of the map. -
viewport
: The circle is aligned to the plane of the viewport.
-
- Expression Parameters
zoom
The width of the circle's stroke. Strokes are placed outside of the circleRadius
.
- Type
-
number
- Default Value
0
- Units
pixels
- Minimum
0
- Expression Parameters
zoom, feature, feature-state
The transition affecting any changes to this layer’s circleStrokeWidth property.
- Type
-
{ duration, delay }
- Units
-
milliseconds
- Default Value
-
{duration: 300, delay: 0}
The stroke color of the circle.
- Type
-
color
- Default Value
#000000
- Expression Parameters
zoom, feature, feature-state
The transition affecting any changes to this layer’s circleStrokeColor property.
- Type
-
{ duration, delay }
- Units
-
milliseconds
- Default Value
-
{duration: 300, delay: 0}
The opacity of the circle's stroke.
- Type
-
number
- Default Value
1
- Minimum
0
- Maximum
1
- Expression Parameters
zoom, feature, feature-state
The transition affecting any changes to this layer’s circleStrokeOpacity property.
- Type
-
{ duration, delay }
- Units
-
milliseconds
- Default Value
-
{duration: 300, delay: 0}