Type alias MarkerOptions

MarkerOptions: {
    anchor?: PositionAnchor;
    className?: string;
    clickTolerance?: number;
    color?: string;
    draggable?: boolean;
    element?: HTMLElement;
    offset?: PointLike;
    opacity?: string;
    opacityWhenCovered?: string;
    pitchAlignment?: Alignment;
    rotation?: number;
    rotationAlignment?: Alignment;
    scale?: number;
}

The Marker options object

Type declaration

  • Optional anchor?: PositionAnchor

    A string indicating the part of the Marker that should be positioned closest to the coordinate set via Marker#setLngLat. Options are 'center', 'top', 'bottom', 'left', 'right', 'top-left', 'top-right', 'bottom-left', and 'bottom-right'.

    Default Value

    'center'
    
  • Optional className?: string

    Space-separated CSS class names to add to marker element.

  • Optional clickTolerance?: number

    The max number of pixels a user can shift the mouse pointer during a click on the marker for it to be considered a valid click (as opposed to a marker drag). The default is to inherit map's clickTolerance.

    Default Value

    0
    
  • Optional color?: string

    The color to use for the default marker if options.element is not provided. The default is light blue.

    Default Value

    '#3FB1CE'
    
  • Optional draggable?: boolean

    A boolean indicating whether or not a marker is able to be dragged to a new position on the map.

    Default Value

    false
    
  • Optional element?: HTMLElement

    DOM element to use as a marker. The default is a light blue, droplet-shaped SVG marker.

  • Optional offset?: PointLike

    The offset in pixels as a PointLike object to apply relative to the element's center. Negatives indicate left and up.

  • Optional opacity?: string

    Marker's opacity when it's in clear view (not behind 3d terrain)

    Default Value

    1
    
  • Optional opacityWhenCovered?: string

    Marker's opacity when it's behind 3d terrain

    Default Value

    0.2
    
  • Optional pitchAlignment?: Alignment

    map aligns the Marker to the plane of the map. viewport aligns the Marker to the plane of the viewport. auto automatically matches the value of rotationAlignment.

    Default Value

    'auto'
    
  • Optional rotation?: number

    The rotation angle of the marker in degrees, relative to its respective rotationAlignment setting. A positive value will rotate the marker clockwise.

    Default Value

    0
    
  • Optional rotationAlignment?: Alignment

    map aligns the Marker's rotation relative to the map, maintaining a bearing as the map rotates. viewport aligns the Marker's rotation relative to the viewport, agnostic to map rotations. auto is equivalent to viewport.

    Default Value

    'auto'
    
  • Optional scale?: number

    The scale to use for the default marker if options.element is not provided. The default scale corresponds to a height of 41px and a width of 27px.

    Default Value

    1