---
title: "symbol.MTSymbolLayer | Mobile sdk | Mobile sdk android | Android"
description: "MTSymbolLayer"
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# symbol.MTSymbolLayer

@Serializable

class [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/) : [MTLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer/-m-t-layer/)

The symbol style that layer renders icon and text labels at points or along lines on a map.

MembersMembers & Extensions

## Constructors

[MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/-m-t-symbol-layer/)

constructor(identifier: [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html), sourceIdentifier: [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html))

constructor(identifier: [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html), sourceIdentifier: [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html), icon: [Bitmap](https://developer.android.com/reference/kotlin/android/graphics/Bitmap.html))

constructor(identifier: [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html), sourceIdentifier: [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html), maxZoom: [Double](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-double/index.html), minZoom: [Double](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-double/index.html), sourceLayer: [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html))

constructor(identifier: [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html), sourceIdentifier: [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html), maxZoom: [Double](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-double/index.html), minZoom: [Double](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-double/index.html), sourceLayer: [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html), icon: [Bitmap](https://developer.android.com/reference/kotlin/android/graphics/Bitmap.html), visibility: [MTLayerVisibility](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer/-m-t-layer-visibility/))

## Properties

[icon](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/icon/)

@Transient

var [icon](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/icon/): [Bitmap](https://developer.android.com/reference/kotlin/android/graphics/Bitmap.html)?

Icon to use for the layer.

[iconAllowOverlap](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/icon-allow-overlap/)

var [iconAllowOverlap](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/icon-allow-overlap/): [Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)?

If true, the icon will be visible even if it collides with other symbols. Defaults to style spec default (false) when not set.

[iconIgnorePlacement](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/icon-ignore-placement/)

var [iconIgnorePlacement](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/icon-ignore-placement/): [Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)?

If true, the icon will be visible and will not affect placement of other symbols. Defaults to style spec default (false) when not set.

[identifier](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/identifier/)

@SerialName(value = "id")

open override var [identifier](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/identifier/): [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)

Unique layer identifier.

[maxZoom](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/max-zoom/)

@SerialName(value = "maxzoom")

open override var [maxZoom](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/max-zoom/): [Double](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-double/index.html)?

The maximum zoom level for the layer.

[minZoom](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/min-zoom/)

@SerialName(value = "minzoom")

open override var [minZoom](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/min-zoom/): [Double](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-double/index.html)?

The minimum zoom level for the layer.

[sourceIdentifier](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/source-identifier/)

@SerialName(value = "source")

open override var [sourceIdentifier](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/source-identifier/): [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)

Identifier of the source to be used for this layer.

[sourceLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/source-layer/)

@SerialName(value = "source-layer")

open override var [sourceLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/source-layer/): [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)?

Layer to use from a vector tile source.

[textAllowOverlap](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-allow-overlap/)

var [textAllowOverlap](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-allow-overlap/): [Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)?

If true, the text will be visible even if it collides with other symbols. Defaults to style spec default (false) when not set.

[textAnchor](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-anchor/)

var [textAnchor](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-anchor/): [MTTextAnchor](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-text-anchor/)?

Anchor position of the text relative to the symbol anchor. For example, use [MTTextAnchor.TOP](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-text-anchor/-t-o-p/) with a positive Y [textOffset](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-offset/) to render text below the icon.

[textColor](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-color/)

var [textColor](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-color/): [StyleValue](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.dsl/-style-value/)?

Text color (constant or expression), written under paint as text-color.

[textField](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-field/)

var [textField](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-field/): [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)?

Label text to render for each feature, e.g. "{point\_count\_abbreviated}" for clusters.

[textFont](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-font/)

var [textFont](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-font/): [List](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html)<[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)\>?

Text fonts as style-spec family names.

[textIgnorePlacement](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-ignore-placement/)

var [textIgnorePlacement](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-ignore-placement/): [Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)?

If true, the text will be visible and will not affect placement of other symbols. Defaults to style spec default (false) when not set.

[textOffset](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-offset/)

var [textOffset](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-offset/): [MTPoint](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.types/-m-t-point/)?

Amount to offset the text from its anchor in ems. X is right, Y is down. Example: 0.0, 1.2 with [textAnchor](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-anchor/) = [MTTextAnchor.TOP](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-text-anchor/-t-o-p/) places text under the icon.

[textSize](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-size/)

var [textSize](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/text-size/): [Double](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-double/index.html)?

Label text size in pixels.

[type](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/type/)

@EncodeDefault(mode = EncodeDefault.Mode.ALWAYS)

open override var [type](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/type/): [MTLayerType](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer/-m-t-layer-type/)

Type of the layer.

[visibility](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/visibility/)

var [visibility](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/visibility/): [MTLayerVisibility](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer/-m-t-layer-visibility/)

Enum controlling whether this layer is displayed.

## Functions

[setFilterHas](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/set-filter-has/)

fun [setFilterHas](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/set-filter-has/)(field: [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html))

Sets filter to "has", field.

[setFilterNotHas](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/set-filter-not-has/)

fun [setFilterNotHas](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/set-filter-not-has/)(field: [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html))

Sets filter to \["!", "has", field\].

[textAllowOverlap](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-allow-overlap/)

fun [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/).[textAllowOverlap](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-allow-overlap/)(value: [Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)): [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/)

[textAnchor](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-anchor/)

fun [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/).[textAnchor](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-anchor/)(value: [MTTextAnchor](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-text-anchor/)): [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/)

[textColorConst](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-color-const/)

fun [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/).[textColorConst](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-color-const/)(color: [Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)): [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/)

[textColorExpr](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-color-expr/)

fun [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/).[textColorExpr](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-color-expr/)(expr: [PropertyValue](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.dsl/-property-value/)): [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/)

[textField](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-field/)

fun [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/).[textField](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-field/)(token: [MTTextToken](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.dsl/-m-t-text-token/)): [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/)

fun [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/).[textField](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-field/)(value: [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)): [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/)

[textFont](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-font/)

fun [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/).[textFont](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-font/)(value: [List](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html)<[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)\>): [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/)

[textSize](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-size/)

fun [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/).[textSize](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/text-size/)(value: [Double](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-double/index.html)): [MTSymbolLayer](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/)

[withFilter](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/with-filter/)

fun [withFilter](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.layer.symbol/-m-t-symbol-layer/with-filter/)(expr: [PropertyValue](https://docs.maptiler.com/mobile-sdk/android/api/-map-tiler-s-d-k/com.maptiler.maptilersdk.map.style.dsl/-property-value/))