IconOptions interface
SymbolLayer에서 아이콘을 사용자 지정하는 데 사용되는 옵션
- Extends
속성
allow |
기호 아이콘이 지도에서 다른 기호를 오버레이할 수 있는지를 지정합니다.
|
anchor | 아이콘의 어느 부분이 맵의 아이콘 앵커 위치에 가장 가까이 배치되도록 지정합니다. '"center"': 아이콘의 중심이 앵커에 가장 가깝게 배치됩니다. '"left"': 아이콘의 왼쪽이 앵커에 가장 가깝게 배치됩니다. '"오른쪽"': 아이콘의 오른쪽이 앵커에 가장 가깝게 배치됩니다. '"top"': 아이콘의 위쪽이 앵커에 가장 가깝게 배치됩니다. '"bottom"': 아이콘의 아래쪽이 앵커에 가장 가깝게 배치됩니다. '"왼쪽 위"': 아이콘의 왼쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다. '"오른쪽 위"': 아이콘의 오른쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다. '"왼쪽 아래"': 아이콘의 왼쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다. '"오른쪽 아래"': 아이콘의 오른쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다. 기본값 '"bottom"'입니다. |
ignore |
다른 기호가 이 기호와 겹칠 수 있는지를 지정합니다.
true이면 아이콘과 충돌하더라도 다른 기호를 볼 수 있습니다.
기본값은 |
image | 아이콘을 그리는 데 사용할 지도의 이미지 스프라이트에 있는 이미지의 이름입니다.
사용 가능한 기본 제공 이미지는 다음과 |
offset | 아이콘의 앵커에서 픽셀 단위로 오프셋 거리를 지정합니다.
양수 값은 오른쪽과 아래쪽을 나타내고 음수 값은 왼쪽과 위쪽을 나타냅니다.
각 구성 요소에 크기 값을 곱하여 최종 오프셋을 픽셀 단위로 가져옵니다.
회전과 결합하면 오프셋은 회전된 방향이 위로 있는 것처럼 표시됩니다.
기본값은 |
opacity | 아이콘을 그릴 불투명도를 나타내는 0에서 1 사이의 숫자입니다.
기본값은 |
optional | 기호 아이콘을 숨길 수 있지만 다른 기호와 겹치는 경우 해당 텍스트가 표시되는지 지정합니다.
true이면 아이콘이 다른 기호와 충돌하고 텍스트가 충돌하지 않으면 해당 아이콘 없이 텍스트가 표시됩니다.
기본값은 |
padding | 기호 충돌을 감지하는 데 사용되는 아이콘 경계 상자 주위의 추가 영역 크기입니다.
기본값은 |
pitch |
지도가 투구될 때 아이콘의 방향을 지정합니다. '"auto"': 'rotationAlignment'의 값과 자동으로 일치합니다. '"map"': 아이콘이 지도의 평면에 맞춰집니다. '"viewport"': 아이콘이 뷰포트의 평면에 맞춰집니다. 기본값 '"auto"' |
rotation | 아이콘을 시계 방향으로 회전할 크기(기본값 |
rotation |
SymbolLayerOptions의 배치 속성과 함께 아이콘의 회전 동작을 결정합니다. '"auto"': 배치가 "point"이면 "viewport"에 해당합니다. 배치가 "선"인 경우 이는 "map"에 해당합니다. '"map"': 배치가 "point"이면 아이콘을 동서로 맞춥니다. 배치가 "선"인 경우 아이콘의 x축을 선에 맞춥니다. '"viewport"': 아이콘' x축은 뷰포트의 x축에 맞춰 정렬됩니다. 기본값 '"auto"'입니다. |
size | 제공된 요소에 따라 아이콘의 원래 크기를 조정합니다.
0보다 크거나 같아야 합니다.
기본값은 |
속성 세부 정보
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-darkblue
pin-darkblue
pin-red
pin-blue
pin-round-red
marker-blue
pin-round-darkblue
marker-red
pin-round-blue
marker-yellow
같습니다. marker-black
기본값은 "marker-blue"
입니다.
image?: string | DataDrivenPropertyValueSpecification<string>
속성 값
string | DataDrivenPropertyValueSpecification<string>
offset
아이콘의 앵커에서 픽셀 단위로 오프셋 거리를 지정합니다.
양수 값은 오른쪽과 아래쪽을 나타내고 음수 값은 왼쪽과 위쪽을 나타냅니다.
각 구성 요소에 크기 값을 곱하여 최종 오프셋을 픽셀 단위로 가져옵니다.
회전과 결합하면 오프셋은 회전된 방향이 위로 있는 것처럼 표시됩니다.
기본값은 [0, 0]
입니다.
offset?: 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>