엔티티 지도 (Entity Map)
Entity Map은 위치 정보(좌표)를 가진 엔티티를 지도 위에 시각화하는 기능입니다. 매장, 센서, 시설물 등 공간 데이터를 직관적으로 탐색할 수 있습니다.
개요
온톨로지에서 정의한 엔티티가 위도·경도 속성을 포함하고 있으면, 해당 엔티티의 데이터를 지도 위에 마커로 표시할 수 있습니다. 이를 통해 데이터의 지리적 분포와 패턴을 한눈에 파악할 수 있습니다.
접근 경로
사이드바에서 온톨로지 → 엔티티 선택 → 지도 탭으로 이동하거나, URL /ontology/entities/:entityId/map으로 직접 접근할 수 있습니다.
엔티티 매핑
지도에 엔티티를 표시하려면, 데이터셋 컬럼을 엔티티 속성에 올바르게 매핑해야 합니다.
매핑 절차
- 온톨로지 빌더에서 대상 엔티티를 선택합니다.
- Data Source 탭에서 데이터셋을 연결합니다.
- 엔티티 속성 중 위도와 경도에 해당하는 컬럼을 각각 매핑합니다.
- 매핑 완료 후 Sink를 실행하여 그래프 데이터베이스에 데이터를 적재합니다.
매핑 예시
| 엔티티 속성 | 데이터셋 컬럼 | 설명 |
|---|---|---|
latitude | lat | 위도 (WGS84) |
longitude | lng | 경도 (WGS84) |
name | store_name | 마커 라벨에 표시될 이름 |
address | full_address | 상세 주소 |
좌표 데이터 요구사항
지도 시각화가 정상 동작하려면 좌표 데이터가 아래 조건을 충족해야 합니다.
| 항목 | 조건 |
|---|---|
| 좌표계 | WGS84 (EPSG:4326) |
| 위도 범위 | -90 ~ 90 |
| 경도 범위 | -180 ~ 180 |
| 데이터 타입 | float 또는 double |
| NULL 처리 | 위도·경도 중 하나라도 NULL이면 해당 행은 지도에 표시되지 않음 |
좌표계 확인
국내 데이터의 경우 KATEC, TM, UTM-K 등 다른 좌표계를 사용하는 경우가 있습니다. 지도에 표시하려면 반드시 WGS84 좌표로 변환한 뒤 매핑하세요.
지도 인터랙션
기본 조작
| 동작 | 방법 |
|---|---|
| 확대/축소 | 마우스 휠 스크롤 또는 +/- 버튼 |
| 이동 (팬) | 지도 위에서 마우스 드래그 |
| 마커 클릭 | 엔티티 상세 정보 팝업 표시 |
| 팝업 닫기 | 팝업 외부 영역 클릭 또는 × 버튼 |
마커 팝업
마커를 클릭하면 해당 엔티티의 주요 속성이 팝업으로 표시됩니다.
- 엔티티 이름: 매핑된 이름 속성
- 속성 목록: 엔티티에 정의된 속성과 값
- 관계 요약: 해당 노드에 연결된 관계 수
클러스터링
동일 영역에 마커가 밀집된 경우, 자동으로 클러스터(묶음) 마커로 표시됩니다. 확대하면 개별 마커로 분리됩니다.
활용 예시
- 매장 분포 분석: 전국 매장의 지리적 분포를 확인하고 밀집 지역 파악
- IoT 센서 모니터링: 센서 설치 위치를 지도에서 관리하고 상태 확인
- 물류 네트워크 시각화: 창고·배송 거점 간 위치 관계 파악
다른 기능과 연계
Entity Map에서 파악한 공간 패턴을 Graph Explorer의 Cypher 쿼리와 결합하면, 특정 지역의 엔티티와 연결된 관계를 심층 분석할 수 있습니다.