다음을 통해 공유


SymbolLayerOptions interface

SymbolLayer에서 기하 도형을 렌더링할 때 사용되는 옵션입니다.

Extends

속성

iconOptions

기호의 아이콘을 사용자 지정하는 데 사용되는 옵션입니다.

기본값은 IconOptions를 참조하세요.

lineSpacing

선을 따라 두 기호 앵커 사이의 거리(픽셀)입니다. 1보다 크거나 같아야 합니다. 기본값은 250입니다.

placement

기하 도형을 기준으로 레이블 배치를 지정합니다.

'"point"': 기하 도형이 있는 지점에 레이블이 배치됩니다.

'"line"': 레이블이 기하 도형의 선을 따라 배치됩니다. LineString 및 Polygon 기하 도형에서만 사용할 수 있습니다.

'"line-center"': 레이블은 기하 도형 선의 가운데에 배치됩니다. 'LineString' 및 'Polygon' 기하 도형에서만 사용할 수 있습니다.

기본값 '"point"'.
sortKey

이 값에 따라 기능을 오름차순으로 정렬합니다. 정렬 키가 낮은 기능이 그려지고 먼저 배치됩니다. 기본값은 undefined입니다.

source

계층이 렌더링할 데이터 원본의 ID 또는 인스턴스입니다.

sourceLayer

계층의 원본이 VectorTileSource인 경우 필요합니다. 벡터 원본에는 여러 계층이 있을 수 있으며, 이 계층에서 렌더링할 레이어를 식별합니다. 다른 모든 유형의 원본에 대해 금지됩니다.

textOptions

기호의 텍스트를 사용자 지정하는 데 사용되는 옵션입니다.

기본값은 TextOptions를 참조하세요.

zOrder

동일한 계층의 겹치는 기호가 데이터 원본에 표시되는 순서대로 렌더링되는지 또는 뷰포트를 기준으로 y 위치에 의해 렌더링되는지 여부를 결정합니다. 그렇지 않으면 기호의 순서 및 우선 순위를 제어하려면 를 사용합니다 sortKey.

'"auto"': 설정된 경우 기호를 'sortKey'로 정렬합니다. 그렇지 않으면 '"viewport-y"'와 같이 동작합니다.

'"viewport-y"': 'allowOverlap'이 'true'이거나 'ignorePlacement'가 'false'인 경우 기호를 y 위치로 정렬합니다.

'"source"': 설정된 경우 기호를 'sortKey'로 정렬합니다. 그렇지 않으면 기호가 원본 데이터와 동일한 순서로 렌더링됩니다. 기본값 '"auto"'

상속된 속성

filter

원본 기능에 대한 조건을 지정하는 식입니다. 필터와 일치하는 기능만 표시됩니다.

maxZoom

레이어를 렌더링할 최대 확대/축소 수준을 지정하는 정수입니다. 이 값은 배타적입니다. 즉, 계층이 에 maxZoom > zoom >= minZoom표시됩니다. 기본값은 24입니다.

minZoom

레이어를 렌더링할 최소 확대/축소 수준을 지정하는 정수입니다. 이 값은 포함됩니다. 즉, 계층이 에 maxZoom > zoom >= minZoom표시됩니다. 기본값은 0입니다.

visible

레이어가 표시되는지 여부를 지정합니다. 기본값은 true입니다.

속성 세부 정보

iconOptions

기호의 아이콘을 사용자 지정하는 데 사용되는 옵션입니다.

기본값은 IconOptions를 참조하세요.

iconOptions?: IconOptions

속성 값

lineSpacing

선을 따라 두 기호 앵커 사이의 거리(픽셀)입니다. 1보다 크거나 같아야 합니다. 기본값은 250입니다.

lineSpacing?: number | PropertyValueSpecification<number>

속성 값

number | PropertyValueSpecification<number>

placement

기하 도형을 기준으로 레이블 배치를 지정합니다.

'"point"': 기하 도형이 있는 지점에 레이블이 배치됩니다.

'"line"': 레이블이 기하 도형의 선을 따라 배치됩니다. LineString 및 Polygon 기하 도형에서만 사용할 수 있습니다.

'"line-center"': 레이블은 기하 도형 선의 가운데에 배치됩니다. 'LineString' 및 'Polygon' 기하 도형에서만 사용할 수 있습니다.

기본값 '"point"'.
placement?: "point" | "line" | "line-center"

속성 값

"point" | "line" | "line-center"

sortKey

이 값에 따라 기능을 오름차순으로 정렬합니다. 정렬 키가 낮은 기능이 그려지고 먼저 배치됩니다. 기본값은 undefined입니다.

sortKey?: number | DataDrivenPropertyValueSpecification<number>

속성 값

number | DataDrivenPropertyValueSpecification<number>

source

계층이 렌더링할 데이터 원본의 ID 또는 인스턴스입니다.

source?: string | Source

속성 값

string | Source

sourceLayer

계층의 원본이 VectorTileSource인 경우 필요합니다. 벡터 원본에는 여러 계층이 있을 수 있으며, 이 계층에서 렌더링할 레이어를 식별합니다. 다른 모든 유형의 원본에 대해 금지됩니다.

sourceLayer?: string

속성 값

string

textOptions

기호의 텍스트를 사용자 지정하는 데 사용되는 옵션입니다.

기본값은 TextOptions를 참조하세요.

textOptions?: TextOptions

속성 값

zOrder

동일한 계층의 겹치는 기호가 데이터 원본에 표시되는 순서대로 렌더링되는지 또는 뷰포트를 기준으로 y 위치에 의해 렌더링되는지 여부를 결정합니다. 그렇지 않으면 기호의 순서 및 우선 순위를 제어하려면 를 사용합니다 sortKey.

'"auto"': 설정된 경우 기호를 'sortKey'로 정렬합니다. 그렇지 않으면 '"viewport-y"'와 같이 동작합니다.

'"viewport-y"': 'allowOverlap'이 'true'이거나 'ignorePlacement'가 'false'인 경우 기호를 y 위치로 정렬합니다.

'"source"': 설정된 경우 기호를 'sortKey'로 정렬합니다. 그렇지 않으면 기호가 원본 데이터와 동일한 순서로 렌더링됩니다. 기본값 '"auto"'

zOrder?: "auto" | "viewport-y" | "source"

속성 값

"auto" | "viewport-y" | "source"

상속된 속성 세부 정보

filter

원본 기능에 대한 조건을 지정하는 식입니다. 필터와 일치하는 기능만 표시됩니다.

filter?: Expression

속성 값

LayerOptions.filter에서 상속됨

maxZoom

레이어를 렌더링할 최대 확대/축소 수준을 지정하는 정수입니다. 이 값은 배타적입니다. 즉, 계층이 에 maxZoom > zoom >= minZoom표시됩니다. 기본값은 24입니다.

maxZoom?: number

속성 값

number

LayerOptions.maxZoom에서 상속됨

minZoom

레이어를 렌더링할 최소 확대/축소 수준을 지정하는 정수입니다. 이 값은 포함됩니다. 즉, 계층이 에 maxZoom > zoom >= minZoom표시됩니다. 기본값은 0입니다.

minZoom?: number

속성 값

number

LayerOptions.minZoom에서 상속됨

visible

레이어가 표시되는지 여부를 지정합니다. 기본값은 true입니다.

visible?: boolean

속성 값

boolean

LayerOptions.visible에서 상속됨