PivotMapChartOptions

피벗 맵차트 패널 옵션.

Options

mapUrl: string (opens in a new tab)

맵차트가 사용할 지도 소스(geojson 등)의 url.
맵차트는 지도 없이 그릴 수 없으므로 반드시 지정해야 한다.

default: undefined

mapName: string (opens in a new tab)

지도 소스의 이름. series가 참조한다.

default: 'map'

mapKeys: [string (opens in a new tab) | string (opens in a new tab)]

지도 area와 데이터포인트를 연결할 키. [지도 area 속성, 데이터포인트 속성].
예) ['name', 'id'] 는 지도 area의 'name' 속성과 데이터포인트의 'id' 속성을 매칭한다.

default: ['name', 'id']

coordKey: string (opens in a new tab)

선택 지역 핀의 좌표를 찾을 때, 포인트의 area와 매칭할 지도 area 속성.
이 속성이 없으면 area의 'name'으로 폴백한다(세계지도 등 동명 지역이 없는 지도 대응).

default: 'rm-fullname'

mapExclude: Array (opens in a new tab)<string (opens in a new tab)>

지도에서 제외할 area id 목록.
예) 남극을 빼려면 ['ATA']. 좁은 패널에서 불필요한 영역이 공간을 차지하는 것을 막는다.

default: undefined

colorScale: RealMap.ChartConfiguration['colorScale'] | 'heatmap' | 'none' | { [measure: string]: PivotMapColorScale }

area 색상 스케일. 측정값마다 다르게 주려면 { 측정값이름: ... } 맵으로 지정한다.
측정값별로 다음 우선순위로 결정된다:

1. ColorScale 객체 → 그대로 사용(오버라이드)
   
2. 'heatmap'(또는 생략) → 그 측정값의 피벗 히트맵 설정에서 자동 도출(히트맵이 없으면 기본 스케일)
   
3. 'none' → 색칠 안 함
   색 외 옵션(nullStep 등)만 담은 객체를 주면 도출 결과에 병합된다.

default: undefined

projection: ProjectionType

지도 좌표 투영 방식. 위경도(geojson) 지도는 'mercator'로 투영해야 화면에 맞게 배치된다.

default: 'mercator'

axis: MapAxisOptions

지도 축(경위도 격자선 등) 설정. 지정하지 않으면 격자선만 표시한다({ grid: { visible: true } }).
좁은 지역(예: 대한민국)은 기본 격자 step이 커서 선이 어색하게 한두 개만 그려질 수 있으므로, { grid: { line: { step: 1 } } }처럼 step을 줄이거나 { grid: false }로 끌 수 있다.

default: undefined

xAxis: 'column' | 'row'

차트의 x축(범주)에 피봇테이블의 행/열 중 무엇을 매핑할지.

default: 'row'

pin: { style: SVGStyleOrClass; }

선택 지역 핀의 스타일. 예제마다 핀 배경색·외곽선을 다르게 주고 싶을 때 사용한다.
style은 기본 핀 스타일(파란 배경 #3b82f6 + 검정 외곽선)에 병합되므로, 일부만 지정하면(예: { fill: 'red' }) 나머지 기본값은 유지된다.

default: undefined