page no. 

Start Release No : 7.0.500.20240905-11 / Update Release No : 7.0.500.20240905-11

작성자 :  이동진, 황송희  / 검수자 :  검수자가 작성


  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. 보고서 화면
  • 기술연구소 내부 타일 서버: https://streetmap.bimatrix.co.kr/
    - 지도를 확인하실 때는 마우스로 중심 위치를 이동한 후, 스크롤로 확대/축소하시면 됩니다.
  • GeoMap 컴포넌트의 타일 서버는 OpenStreetMap 지리 데이터를 기반으로 구축하였기에, OpenStreetMap의 ODbL(Open Database License) 을 따릅니다.
  • 대한민국 및 북한 지역 데이터만 구축되어 있으며, 해당 범위 내 지도만 표시됩니다.
  • 다국어 기능을 지원하지 않고 있습니다.


  • 제약 사항
    • 지도 확대(Zoom) 레벨과 이미지 캐시
      • 지도 Zoom 레벨은 0 ~ 19 단계를 제공합니다.
      • 0레벨 ~ 14레벨: 미리 생성된 이미지 캐시를 기본 제공
      • 15레벨 이상부터는 최초 로딩 시, 실행 중(runtime)에 이미지 캐시를 생성합니다. 따라서 처음 로딩할 때 약간의 지연이나 버벅임이 발생할 수 있습니다.


기능 정보
  • API Open
  • UI Open
  • Read Only
  • Not Use
  • Hidden
  • Not Recommend
  • 해당 없음
시작 버전 정보
  • i-AUD: 7.3.500.0-202409061036





(BCRM#E2968) [GeoMap > AudMap] 지도 컴포넌트 내부망에서 사용 가능한 배경지도 제공을 위한 타일 서버 구축 및 연결
추가 이슈 처리가 있을 경우 표 뒤에 행 추가 한 다음 작성 합니다.