다음을 통해 공유


IconOptions interface

SymbolLayer에서 아이콘을 사용자 지정하는 데 사용되는 옵션

Extends

속성

allowOverlap

기호 아이콘이 지도에서 다른 기호를 오버레이할 수 있는지를 지정합니다. true 이전에 그린 다른 기호와 충돌하더라도 아이콘이 표시되는 경우 팁: 부드러운 렌더링을 위해 기호에 애니메이션 효과를 주는 경우 true로 설정합니다. 기본값은 false입니다.

anchor

아이콘의 어느 부분이 맵의 아이콘 앵커 위치에 가장 가까이 배치되도록 지정합니다.

'"center"': 아이콘의 중심이 앵커에 가장 가깝게 배치됩니다.

'"left"': 아이콘의 왼쪽이 앵커에 가장 가깝게 배치됩니다.

'"오른쪽"': 아이콘의 오른쪽이 앵커에 가장 가깝게 배치됩니다.

'"top"': 아이콘의 위쪽이 앵커에 가장 가깝게 배치됩니다.

'"bottom"': 아이콘의 아래쪽이 앵커에 가장 가깝게 배치됩니다.

'"왼쪽 위"': 아이콘의 왼쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다.

'"오른쪽 위"': 아이콘의 오른쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다.

'"왼쪽 아래"': 아이콘의 왼쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다.

'"오른쪽 아래"': 아이콘의 오른쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다.

기본값 '"bottom"'입니다.
ignorePlacement

다른 기호가 이 기호와 겹칠 수 있는지를 지정합니다. true이면 아이콘과 충돌하더라도 다른 기호를 볼 수 있습니다. 기본값은 false입니다.

image

아이콘을 그리는 데 사용할 지도의 이미지 스프라이트에 있는 이미지의 이름입니다. 사용 가능한 기본 제공 이미지는 다음과 marker-darkbluepin-darkbluepin-redpin-bluepin-round-redmarker-bluepin-round-darkbluemarker-redpin-round-bluemarker-yellow같습니다. marker-black 기본값은 "marker-blue"입니다.

offset

아이콘의 앵커에서 픽셀 단위로 오프셋 거리를 지정합니다. 양수 값은 오른쪽과 아래쪽을 나타내고 음수 값은 왼쪽과 위쪽을 나타냅니다. 각 구성 요소에 크기 값을 곱하여 최종 오프셋을 픽셀 단위로 가져옵니다. 회전과 결합하면 오프셋은 회전된 방향이 위로 있는 것처럼 표시됩니다. 기본값은 [0, 0]입니다.

opacity

아이콘을 그릴 불투명도를 나타내는 0에서 1 사이의 숫자입니다. 기본값은 1입니다.

optional

기호 아이콘을 숨길 수 있지만 다른 기호와 겹치는 경우 해당 텍스트가 표시되는지 지정합니다. true이면 아이콘이 다른 기호와 충돌하고 텍스트가 충돌하지 않으면 해당 아이콘 없이 텍스트가 표시됩니다. 기본값은 false입니다.

padding

기호 충돌을 감지하는 데 사용되는 아이콘 경계 상자 주위의 추가 영역 크기입니다. 기본값은 2입니다.

pitchAlignment

지도가 투구될 때 아이콘의 방향을 지정합니다.

'"auto"': 'rotationAlignment'의 값과 자동으로 일치합니다.

'"map"': 아이콘이 지도의 평면에 맞춰집니다.

'"viewport"': 아이콘이 뷰포트의 평면에 맞춰집니다.

기본값 '"auto"'
rotation

아이콘을 시계 방향으로 회전할 크기(기본값 0)입니다.

rotationAlignment

SymbolLayerOptions의 배치 속성과 함께 아이콘의 회전 동작을 결정합니다.

'"auto"': 배치가 "point"이면 "viewport"에 해당합니다. 배치가 "선"인 경우 이는 "map"에 해당합니다.

'"map"': 배치가 "point"이면 아이콘을 동서로 맞춥니다. 배치가 "선"인 경우 아이콘의 x축을 선에 맞춥니다.

'"viewport"': 아이콘' x축은 뷰포트의 x축에 맞춰 정렬됩니다.

기본값 '"auto"'입니다.
size

제공된 요소에 따라 아이콘의 원래 크기를 조정합니다. 0보다 크거나 같아야 합니다. 기본값은 1입니다.

속성 세부 정보

allowOverlap

기호 아이콘이 지도에서 다른 기호를 오버레이할 수 있는지를 지정합니다. true 이전에 그린 다른 기호와 충돌하더라도 아이콘이 표시되는 경우 팁: 부드러운 렌더링을 위해 기호에 애니메이션 효과를 주는 경우 true로 설정합니다. 기본값은 false입니다.

allowOverlap?: boolean

속성 값

boolean

anchor

아이콘의 어느 부분이 맵의 아이콘 앵커 위치에 가장 가까이 배치되도록 지정합니다.

'"center"': 아이콘의 중심이 앵커에 가장 가깝게 배치됩니다.

'"left"': 아이콘의 왼쪽이 앵커에 가장 가깝게 배치됩니다.

'"오른쪽"': 아이콘의 오른쪽이 앵커에 가장 가깝게 배치됩니다.

'"top"': 아이콘의 위쪽이 앵커에 가장 가깝게 배치됩니다.

'"bottom"': 아이콘의 아래쪽이 앵커에 가장 가깝게 배치됩니다.

'"왼쪽 위"': 아이콘의 왼쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다.

'"오른쪽 위"': 아이콘의 오른쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다.

'"왼쪽 아래"': 아이콘의 왼쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다.

'"오른쪽 아래"': 아이콘의 오른쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다.

기본값 '"bottom"'입니다.
anchor?: PositionAnchor | DataDrivenPropertyValueSpecification<PositionAnchor>

속성 값

PositionAnchor | DataDrivenPropertyValueSpecification<PositionAnchor>

ignorePlacement

다른 기호가 이 기호와 겹칠 수 있는지를 지정합니다. true이면 아이콘과 충돌하더라도 다른 기호를 볼 수 있습니다. 기본값은 false입니다.

ignorePlacement?: boolean

속성 값

boolean

image

아이콘을 그리는 데 사용할 지도의 이미지 스프라이트에 있는 이미지의 이름입니다. 사용 가능한 기본 제공 이미지는 다음과 marker-darkbluepin-darkbluepin-redpin-bluepin-round-redmarker-bluepin-round-darkbluemarker-redpin-round-bluemarker-yellow같습니다. marker-black 기본값은 "marker-blue"입니다.

image?: string | DataDrivenPropertyValueSpecification<string>

속성 값

string | DataDrivenPropertyValueSpecification<string>

offset

아이콘의 앵커에서 픽셀 단위로 오프셋 거리를 지정합니다. 양수 값은 오른쪽과 아래쪽을 나타내고 음수 값은 왼쪽과 위쪽을 나타냅니다. 각 구성 요소에 크기 값을 곱하여 최종 오프셋을 픽셀 단위로 가져옵니다. 회전과 결합하면 오프셋은 회전된 방향이 위로 있는 것처럼 표시됩니다. 기본값은 [0, 0]입니다.

offset?: Pixel | DataDrivenPropertyValueSpecification<Pixel>

속성 값

Pixel | DataDrivenPropertyValueSpecification<Pixel>

opacity

아이콘을 그릴 불투명도를 나타내는 0에서 1 사이의 숫자입니다. 기본값은 1입니다.

opacity?: number | DataDrivenPropertyValueSpecification<number>

속성 값

number | DataDrivenPropertyValueSpecification<number>

optional

기호 아이콘을 숨길 수 있지만 다른 기호와 겹치는 경우 해당 텍스트가 표시되는지 지정합니다. true이면 아이콘이 다른 기호와 충돌하고 텍스트가 충돌하지 않으면 해당 아이콘 없이 텍스트가 표시됩니다. 기본값은 false입니다.

optional?: boolean

속성 값

boolean

padding

기호 충돌을 감지하는 데 사용되는 아이콘 경계 상자 주위의 추가 영역 크기입니다. 기본값은 2입니다.

padding?: number | DataDrivenPropertyValueSpecification<number>

속성 값

number | DataDrivenPropertyValueSpecification<number>

pitchAlignment

지도가 투구될 때 아이콘의 방향을 지정합니다.

'"auto"': 'rotationAlignment'의 값과 자동으로 일치합니다.

'"map"': 아이콘이 지도의 평면에 맞춰집니다.

'"viewport"': 아이콘이 뷰포트의 평면에 맞춰집니다.

기본값 '"auto"'
pitchAlignment?: "auto" | "map" | "viewport"

속성 값

"auto" | "map" | "viewport"

rotation

아이콘을 시계 방향으로 회전할 크기(기본값 0)입니다.

rotation?: number | DataDrivenPropertyValueSpecification<number>

속성 값

number | DataDrivenPropertyValueSpecification<number>

rotationAlignment

SymbolLayerOptions의 배치 속성과 함께 아이콘의 회전 동작을 결정합니다.

'"auto"': 배치가 "point"이면 "viewport"에 해당합니다. 배치가 "선"인 경우 이는 "map"에 해당합니다.

'"map"': 배치가 "point"이면 아이콘을 동서로 맞춥니다. 배치가 "선"인 경우 아이콘의 x축을 선에 맞춥니다.

'"viewport"': 아이콘' x축은 뷰포트의 x축에 맞춰 정렬됩니다.

기본값 '"auto"'입니다.
rotationAlignment?: "auto" | "map" | "viewport"

속성 값

"auto" | "map" | "viewport"

size

제공된 요소에 따라 아이콘의 원래 크기를 조정합니다. 0보다 크거나 같아야 합니다. 기본값은 1입니다.

size?: number | DataDrivenPropertyValueSpecification<number>

속성 값

number | DataDrivenPropertyValueSpecification<number>