[i-AUD] GeoMap 컴포넌트 (지도, 맵) > AudMap 오프라인 배경 지도(타일 서버) 사용 가이드

page no.  121471109

1. 기능 설명
   1. 외부 인터넷에 연결할 수 없는 환경에서 GeoMap 컴포넌트 > AupMap 배경 지도를 사용할 수 있습니다.

   2. 별도의 타일 서버(Tile Server) 를 구축하고, 지도에 필요한 타일 이미지를 해당 서버에서 직접 불러오는 방식으로 동작합니다.

      타일 서버 구축

      타일 서버는 지도 이미지 전용 서버이므로, 단독 서버로 운영하는 것을 전제로 합니다.
      
      

      1. 타일 서버 상세 스펙
         1. CPU: 8Core 이상
         2. Memory: 32GB 이상
         3. Disk: 10TB 이상
         4. OS: Ubuntu 24.04 LTS 권장
      2. Docker 설치
         1. 아래의 버전에 해당하는 도커가 기본 설치 되어있어야 합니다.
         2. 상세 정보
            1. Docker Engine: v27 이상
            2. Docker Compose: v2 이상
      3. HTTPS 인증서 준비
         1. AUD Framework를 이용하여 HTTPS로 서비스를 하고 있는 환경의 경우, 타일 서버도 HTTPS 서비스를 위한 인증서 파일(*.pem)이 필요합니다.
      4. 방화벽 설정
         1. 타일 서버는 사용자 PC(Browser)에서 직접 접근하는 구조입니다.
         2. 사용자 PC → 타일 서버(WEB) 방화벽이 열려있어야 합니다.
2. 사용 방법
   1. ADMIN
      1. 시스템 운영관리 > 제품 별 옵션 설정 > i-AUD 모듈 > 신규로 타일 서버 사용 옵션에 관한 row를 아래와 같이 추가하시면 됩니다.
         
         

      2. 옵션 설명은 다음과 같습니다.

         옵션명	옵션 설명
         GEOMAP_KEY.AUDMAP_TILE_SERVER	내부 타일 서버 URL (ex) https://abc.bimatrix.co.kr

   2. i-AUD
      1. GeoMap Component 생성 시 보고서 스크립트로 initOption의 UseOSM을 true로 설정합니다.
         
      2. 설정 방법은 rnd 사이트 에서 다양한 샘플 보고서를 통해 확인하실 수 있습니다.

      3. 스크립트 예시

         코드 예시  원본 펼치기

          var mapMaster; // 지도 마스터 객체
         
         
         /**************************************
          * 문서 로드 된 후 AutoRefresh 수행 전에 발생합니다.
          * 초기 지도 세팅 및 이벤트를 등록합니다.
         **************************************/
         var OnDocumentLoadComplete = function (sender, args) {
             // Map 객체 초기화
             mapMaster = new Map('MAP'/*UserCompopnent 컨트롤*/);   
         }
         
         /**************************************
          * MAP Controller
          * 지도 생성, 오버레이 추가/제거, 이벤트 등록을 관리합니다.
          **************************************/
         function Map(mapContainer) {
             this.map = null;            // 지도 객체
             this.mapContainer = null;   // UserCompopnent 컨트롤
         
             // 지도 초기화
             this.initMap = function () {
                 var closure = this;
                 this.mapContainer = Matrix.getObject(mapContainer);
                 if(this.mapContainer) {
                     this.mapContainer.OnLoaded = function (s, e) {
                         e.ScriptObject.initGeomap({
                                 libraryType: 0 /* AudMap */,
                                 useOSM: true
                             }, function (map) {
                             closure.map = map;
                             closure.showMap();
                         });
                     }
                 }
             }
         
             // 지도 표시
             this.showMap = function () {
                 Matrix.AddGlobalParams('VS_GID_0', 'KOR', 0);
                 Matrix.AddGlobalParams('VS_GID_1', 'KOR.16_1', 0);  // 서울시
                 this.map.addDomesticGeoJson(true);
             }
         
             this.initMap(); // 생성 시 지도 초기화 호출
         }

3. 적용 예
   1. 보고서 화면