[i-AUD] GeoMap 컴포넌트 권역별 데이터 조회 기능

GeoMap 컴포넌트의 권역별 데이터 조회 방식과 이에 따른 수정 시 처리 방법에 대한 안내 가이드입니다.

권역별 데이터 표시 기능

GeoMap 컴포넌트는 배경 지도 위에 혹은 배경 지도 없이 권역별 지리 데이터를 다양하게 표시할 수 있습니다.

예시:

1) 기본 지도

2) 세계 지도

3) Drill To Detail 샘플

기능 사용 방법은 가이드에 안내되어 있습니다.

참조 테이블

GeoMap 컴포넌트는 권역별 지리 데이터 표시 기능을 제공하기 위해 레파지토리의 아래 테이블을 참조합니다.
대용량의 데이터가 필요하기 때문에, 권역별 지리 데이터 표시 기능을 사용하기 위해서는 우선 데이터를 적재하셔야 합니다. 신규 설치라 하더라도 테이블은 존재하나 데이터는 존재하지 않습니다.
아래 테이블에 데이터를 적재하는 방법은 가이드를 참고 바랍니다. 가이드:

테이블 목록

GeoMap 컴포넌트 권역별 지리 데이터가 적재된 테이블

테이블 명	테이블 설명	Row 개수
MAP_GEO_0	국가별 0레벨 전 세계 국가 데이터	263
MAP_GEO_1	국가별 1레벨 구역 데이터(시도)	17
MAP_GEO_2	국가별 2레벨 구역 데이터(시군구)	264
MAP_GEO_3	국가별 3레벨 구역 데이터(읍면동)	5,066
MAP_GEO_4	국가별 3레벨 구역 데이터(리)	15,161
MAP_GEO_DOMESTIC_CODE	대한민국 지리정보체계 코드 데이터(행정동 및 법정동)	21,676
MAP_GEO_COUNTRY_CODE	전 세계 지리정보체계 코드 데이터(ISO Alpha3, ISO Alpha2, ISO Numeric)	263
MAP_GEO_LANGUAGE	지역명 다국어 데이터	20,771

데이터 출처
- 세계 지리 데이터: GADM v4.1. (2022년도 7월)
- 국내 지리 데이터: 주소기반산업지원서비스 도로명주소 DB의 행정구역도 기반 (2025년도 1월)
- 국내 지리 코드표: 행정안전부>업무안내>주민등록,인감 최신일자(등록일 2024.12.23) 게시판
- 세계 지리 코드표: 공공데이터 포털 > 외교부_국가표준코드 (수정일 2024-07-17)

캐시 파일

권역별 지리 데이터를 조회하는 경우, 대용량 데이터 처리를 고려하여 실행되는 쿼리문을 기준으로 개별로 캐시파일을 생성합니다. 동일한 쿼리문이 재실행될 경우, 데이터를 조회하지 않고 해당 캐시파일을 참조하여 지도 데이터를 컴포넌트 view에 표시합니다.

캐시파일이 생성되는 경로는 REPORT_PATH\GEO_JSON 폴더 하위입니다.

해당 경로의 폴더가 없거나 하위에 파일이 없는 경우

사용하고 있는 UserComponent 보고서의 ServerScript > MAP_SERVICE 스크립트를 확인하시면 경로를 확인하실 수 있습니다.

하위 버전 혹은 커스텀되어 있는 경우 경로가 다를 수 있습니다.

따라서 데이터가 수정되었다 하더라도, 실행되는 쿼리문이 동일한 경우 수정된 데이터가 표시되지 않고 해당 캐시파일을 바라보기 때문에 캐시파일을 삭제해 주셔야합니다.

삭제 방법: admin 가이드의 삭제 버튼 활용 혹은 수동으로 서버에서 삭제

기타 FAQ