Mapsourceoptions

MapSourceOptions

맵차트의 기준이 될 지도 소스 설정 모델.
ChartConfiguration의 map 속성에 지정하며, 배열로 둘 이상의 맵을 지정할 수 있다.

Options

alignArctic: `boolean` (opens in a new tab)

부극 취고위까지 지도에 포함되면 90도까지 그려진 것으로 간주한다.
명시적 false로 지정하면 계산된 영역까지만 포함한다.

default :undefined

areas: `Array` (opens in a new tab)<`string` (opens in a new tab) | `object` (opens in a new tab)>

기준 지도(source 또는 url)에 추가할 영역들의 GeoJson 목록.
문자열로 지정하면 해당 url에서 GeoJson을 가져온다. (문자열 url은 RealMap.createChartAsync()로 생성할 때만 사용할 수 있다.)
추가된 영역(feature)의 속성에 parentKey에 해당하는 값이 있으면, 그 값을 id로 갖는 기준 지도 영역에서 추가된 영역의 경계만큼을 빼서(subtract) 두 영역이 겹치지 않게 표시한다.
ex) 시도 지도에 '강릉시'를 추가하면 '강원특별자치도'는 강릉시를 제외한 영역이 된다.

default :undefined

borders: [{ border: `MapBorderSource`,closed: `boolean` (opens in a new tab),name: `string` (opens in a new tab) }]

접경선 목록.

default :undefined

bounds: [`number` (opens in a new tab), `number` (opens in a new tab), `number` (opens in a new tab), `number` (opens in a new tab)]

지도의 표시 경계를 수동으로 지정한다.
[최소 경도, 최소 위도, 최대 경도, 최대 위도] 형태로 지정한다.

bounds와 지도(url/source) 모두 지정되면 bounds가 경계가 된다. (지도가 작으면 덜 그려지고, 더 크면 clip됨)
bounds만 지정되고 지도가 없으면 bounds가 경계가 된다.
둘 다 지정하지 않으면 지도 폴리곤에서 자동 계산된 경계를 사용한다.

주의: Orthographic Projection을 사용하는 경우, 해당 옵션은 무시된다.

default :undefined

dokdo: `number` (opens in a new tab) | `MapCoord`

지도에 독도에 대한 meta 정보가 있는 경우, 독도와 울릉도 사이의 거리를 지정한 비율만큼으로 줄이거나 늘여서 표시한다.
0 ~ 1 사이의 값으로 원래 간격에 대한 상대 거리를 지정한다. 0 이하의 값으로 지정하면 dokdo를 표시하지 않는다. [lon, lat] 형식으로 지정할 수도 있다.

default :undefined

enabled: `boolean` (opens in a new tab)

명시적 false로 지정하면 맵차트에서 맵으로 사용되지 않는다.

default :true

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

맵차트 맵 모델을 구성할 때 제외시킬 영역들의 id 목록.

default :undefined

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

내부 경계선에서 제외할 영역 목록.

default :undefined

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

내부 경계선에서 제외할 영역 목록.

default :undefined

idKey: `string` (opens in a new tab)

맵 모델의 area를 구성할 때 area id로 사용할 소스의 속성 이름.

default :undefined

insets: `Array` (opens in a new tab)<`string` (opens in a new tab) | `MapInset`>

맵 인셋 목록을 지정한다.
이름을 문자열로 지정하면 라이브러기가 기본 제공하는 인셋들이 사용된다. 또, 이름앞에 '-'를 추가하면 visible이 false로 설정된다.

default :undefined

map: `any` (opens in a new tab)

⚠️ Deprecated

default :undefined

name: `string` (opens in a new tab)

맵 이름.
맵차트에 여러 개 맵이 지정될 수 있으며, 맵차트 시리즈 등에서 맵을 참조할 때 사용된다.

default :undefined

nameKey: `string` (opens in a new tab)

맵 모델의 area를 구성할 때 area name으로 사용할 소스의 속성 이름.
지정하지 않으면 차트의 locale에 따라 이름 속성이 결정된다.

default :undefined

needExternal: `boolean` (opens in a new tab)

외부 경계선 정보를 별도로 생성할 지 여부.

default :undefined

needInternal: `boolean` (opens in a new tab)

내부 경계(internal boundary)선 정보를 별도로 생성할 지 여부.

default :undefined

padding: `string` (opens in a new tab) | `number` (opens in a new tab)

맵 상하좌우 주변에 추가할 영역의 크기를 도(°) 단위로 지정한다.
css padding이나 margin 지정 방식과 동일하게 지정한댜.
상하좌우가 같은 값이면 숫자로 지정할 수 있다.

default :undefined

parentKey: `string` (opens in a new tab)

영역에서 부모 영역의 id를 찾을 때 사용할 속성 이름.
areas로 추가된 영역의 subtract 대상 부모를 찾을 때와, drilldown.scope가 'selected'일 때 하위 영역을 찾을 때 사용한다.

default :'rm-parent'

showDummies: `boolean` (opens in a new tab)

dummy 영역들을 표시할지 여부.

default :undefined

source: `any` (opens in a new tab)

영역들의 정보가 포함된 지도 데이터 소스.

default :undefined

unions: `Array` (opens in a new tab)<`MapUnion`>

병합할 영역들의 설정 목록.
각 항목의 members에 나열된 영역들이 하나의 영역으로 병합된다. 병합된 영역의 id와 속성, 중심 좌표는 멤버에서 승계하지 않고 항목에 지정한 값으로 결정된다.
병합은 기준 지도에 areas가 추가되고 subtract가 적용된 다음, 목록에 지정된 순서대로 실행된다. 따라서 앞에서 병합된 영역의 id를 뒤 항목의 멤버로 지정할 수 있다.

unions: [{ 
    members: ['24', '36'],
    properties: { name: '광주전남' },   
    center: [126.9, 34.85]    
}] // 광주광역시와 전라남도를 '광주전남' 영역 하나로 병합한다.

default :undefined

url: `string` (opens in a new tab)

외부 source를 가져올 위치.

default :undefined

MapSeriesOptions MapWidgetBackgroundOptions