Map 위젯
Map 위젯은 객체 집합(Object set)을 지도에 표시하고 선택, 도형과 시간을 Workshop 변수에 연결합니다. Map 애플리케이션과 주요 지도 기능을 공유합니다.
MapboxGL로 렌더링하므로 WebGL이 필요하며 데스크톱 브라우저에 맞춰져 있습니다. 모바일과 WebGL을 사용할 수 없는 환경에는 Map Legacy를 사용합니다.
레이어 구성
| 레이어 | 역할 |
|---|---|
| Base map / Base layer | 배경 지도 영상입니다. |
| Object layer | 객체를 점이나 도형으로 표시합니다. |
| Overlay layer | 여러 지도에서 재사용하도록 구성한 지리 데이터셋의 표시입니다. |
Local configuration은 Workshop 편집기에서 내용과 스타일을 직접 관리하는 권장 방식입니다. Import map template은 기존 지도 템플릿을 선택하고 입력 매개변수에 변수를 매핑합니다. 템플릿을 사용하는 절차는 Map의 Workshop 연동을 따릅니다.
객체 레이어
Add object layer를 선택하고 새 레이어의 Input object set에 기존 객체 집합 변수를 연결하거나 새 변수를 만듭니다.
| 설정 | 동작 |
|---|---|
| Label | 레이어 표시 이름을 바꿉니다. |
| Selected objects | 양방향 객체 집합 변수입니다. 외부에서 선택을 바꾸거나 사용자가 지도에서 선택한 객체를 받을 수 있습니다. |
| Layer visibility | 정적값 또는 Boolean 변수로 레이어 내용을 보이거나 숨깁니다. |
| Lock layer | 잠긴 레이어의 객체는 사용자가 선택할 수 없습니다. |
| Style | 기본 색상, 불투명도, 레이블과 툴팁을 정합니다. |
| Geometry | 객체의 지리적 표현을 추가하고 각 표현의 스타일을 정합니다. |
| Legend visibility | 기본적으로 표시되는 레이어 전체 또는 개별 지리적 표현을 범례에서 숨길 수 있습니다. |
객체의 지리적 표현은 Add geometry로 추가합니다. 레이블 왼쪽을 끌어 순서를 바꾸고 항목에 마우스를 올렸을 때 보이는 휴지통으로 삭제합니다. 지원하는 표현 유형에는 Beta 객체 로딩 방식도 설정할 수 있습니다.
객체 유형의 Geoshape 속성을 지리적 표현으로 지정하면 위젯이 자동으로 값을 읽어 렌더링합니다. 큰 Geoshape는 로딩 성능에 영향을 줄 수 있으므로 큰 속성의 표시 조건을 함께 확인합니다. 표현과 스타일의 상세 항목은 Map의 객체 스타일을 따릅니다.
오버레이와 배경
오버레이는 Map Layer Editor에서 만든 레이어를 추가합니다. Base layer picker로 기본 배경을 지정하고 Show base layer picker를 켜면 사용자도 위젯 안에서 배경을 바꿀 수 있습니다.
도형과 공간 상호작용
| 설정 | 동작 |
|---|---|
| Draw options | 도구 모음에 제공할 그리기 도구를 고릅니다. |
| Drawn shape colors / opacity | 그린 도형의 색상과 불투명도를 지정합니다. |
| Shape output type | 그린 도형과 선택 도형의 GeoJSON 문자열을 feature 또는 geometry collection 표현으로 지정합니다. |
| Drawn shapes | 그린 도형의 GeoJSON을 주고받는 양방향 String 변수입니다. |
| On drawn shape | 도형을 그렸을 때 Workshop 이벤트를 실행합니다. |
| Enable single draw mode | 새 도형을 그리면 기존 도형을 지워 한 개만 유지합니다. |
| Clear shapes after operation | 교차 객체 선택, 객체 검색 또는 track 검색에 사용한 도형을 작업 후 지웁니다. |
| Enable splitting on antimeridian | 경도 180도선을 가로지르는 도형을 별도 다각형으로 나눕니다. |
| Selected shapes | 선택된 도형의 GeoJSON을 주고받는 양방향 String 변수입니다. |
공간 도구는 다음 범위를 구분합니다.
- Enable shaped-based selection은 지도 위 객체 중 도형과 교차하는 대상을 선택합니다.
- Enable geospatial object search는 온톨로지에서 도형과 교차하는 객체를 검색합니다.
- Enable shape-based track tools는 교차하는 track을 온톨로지에서 검색하거나 지도에 표시된 breadcrumbs를 도형으로 필터링합니다.
- Enable shape editing tools는 그린 도형을 수정할 수 있게 합니다.
거리와 면적
Enable measurements를 켜고 표시할 측정을 선택합니다. Enable polygon perimeter는 각 변 또는 전체 둘레 길이, Enable polygon area는 도형 중앙의 면적, Enable line measurements는 선의 각 구간 또는 전체 길이를 표시합니다. 단위는 지도 설정의 값을 사용하며 별도 설정이 없으면 조직의 기본값을 따릅니다.
시간과 재생
| 설정 | 동작 |
|---|---|
| Enable timeline | 지도 하단에 타임라인 열기 버튼을 표시합니다. |
| Allow user to change selected time | 타임라인에서 사용자가 선택 시각을 바꾸게 합니다. 이 아래 Enable user facing live mode toggle은 View latest 옵션을 제공합니다. |
| Open timeline by default | 열기 버튼을 누르지 않아도 타임라인을 펼칩니다. |
| Selected time | Timestamp 또는 Date 변수로 선택 시각을 제어합니다. |
| Time window | 시작과 끝을 Timestamp 또는 Date 변수 두 개로 연결합니다. |
| Time zone | Local 또는 UTC를 사용합니다. Local에서는 Time format을 12-hour, 24-hour 또는 Local로 지정합니다. |
| Playback state | Boolean 변수로 재생과 일시정지를 제어합니다. |
| Playback position | 현재 재생 시각을 밀리초 단위 Number 변수에 출력합니다. |
| Auto pause at | Timestamp array 변수에 지정한 시각에서 자동으로 재생을 멈춥니다. |
화면과 지도 이동
Legend는 범례 패널 표시 여부, Collapse legend panel은 최초 표시 때 접힌 상태인지, Panel size는 전체 또는 compact 크기를 정합니다.
Enable search around는 도구 모음과 문맥 메뉴에서 연결 객체 탐색을 허용합니다. Enable advanced selection tools는 고급 선택 도구를 제공하고 Show selection panel은 선택 객체 목록 또는 한 객체의 세부 정보를 패널에 표시합니다.
| Viewport 설정 | 동작 |
|---|---|
| Viewport auto zoom: Object set | 지정한 객체 집합을 중심에 배치합니다. |
| Viewport auto zoom: All objects | 위젯에 추가한 모든 객체를 중심에 배치합니다. |
| Only update if outside viewport | 대상 객체가 현재 보이는 범위 밖에 모두 있을 때에만 자동 확대를 갱신합니다. |
| Viewport bounds | 현재 보이는 범위의 GeoJSON을 주고받는 양방향 String 변수입니다. |
| Viewport follow object set | 선택 시각에 따라 객체 위치가 달라질 때 해당 객체 집합을 화면 중심에 유지합니다. |
Enable transition to full Map application을 켜면 사용자가 현재 상태로 전체 Map 애플리케이션을 열 수 있습니다.