page no. 127336473
지도 미리보기
| GeoMap | |||
| AudMap | KakaoMap | MapboxMap | VWorldMap |
|---|---|---|---|
(*UseOSM:true) |
|
|
|
| OpenLayers. GeoMap 컴포넌트 기본 제공 | 카카오 지도 API. API 연결 필요 | Mapbox GL. API 연결 필요 | 브이월드 오픈 API. API 연결 필요 |
📌 관련 문서 항목
[i-AUD] GeoMap 컴포넌트 권역별 데이터 조회 방식 안내 🧩 주요 내용
|
[i-AUD] GeoMap 컴포넌트 (지도, 맵) > AudMap 오프라인 배경 지도(타일 서버) 사용 가이드 🧩 주요 내용
|
[i-AUD] GeoMap 컴포넌트 (지도, 맵) 샘플 보고서 모음 🧩 주요 내용 샘플 사이트 지도 컴포넌트 기반 샘플 보고서 모음 |
이전 버전 사용 안내
최신 버전의 AUD Platform을 사용하고 있지 않은 경우, 아래의 가이드를 참고하세요.
| 현재 가이드 제품 버전 | 이전 가이드 제품 버전 | |
|---|---|---|
| 7.0.500.20240627-11 ~ | 국내 지도 | 7.0.400.20230517 ~ 7.0.500.20240613 |
| 타사 상용 | 7.0.500.20240329 ~ 7.0.500.20240613 | |
국내지도 가이드: https://audp.bimatrix.co.kr/pages/viewpage.action?pageId=68128104
타사 상용 혹은 무료 API 연결지도 가이드: https://audp.bimatrix.co.kr/pages/viewpage.action?pageId=79410815
이전 버전에서 최신 버전으로 패치하신 경우, 아래 내용을 참고하세요.
최신 버전 패치 시 아래와 같이 수정해주세요.
1. UserComponent 보고서 파일을 아래 샘플 보고서 사용하기의 보고서 파일로 변경합니다.
2. Viewer 보고서의 스크립트를 아래와 같이 수정합니다.
Source 보고서 최신 버전 사용 안내
Source 보고서 내부 스크립트가 아래 이슈 처리를 위해 변경되었습니다. 아래 버전 이상의 제품을 사용하시는 경우, Source 보고서를 최신으로 다시 다운로드 받으시거나 아래 변경 내용을 참고하시어 직접 수정하여 사용하셔야 합니다.
관련 이슈: (BCRM#E3653) Script API 별 내부 실행 스크립트 내 오류 발생 시 오류 메세지 출력 기능 신규 개발
릴리즈 버전: 7.0.500.20250227-11
i-AUD 버전: 7.3.500.0-202502261136
- 변경 내용
- JScript > initGeomap 함수 내 코드 변경
- GeoMap 컴포넌트에서 제공하는 이벤트의 argument 객체 갯수 변경
| 변경 전 | 변경 후 |
|---|---|
라이센스 안내
타사의 상용 맵 API 연결은 BI MATRIX가 아닌 타사의 라이센스 계약이 필요합니다.
이 과정에서 별도로 비용이 요구될 수 있으며 API Key에 대한 사용 기간, 발급 방법 등에 대한 내용은 각 라이브러리의 사이트를 참고하세요.
- 기능 설명
- i-AUD의 Add-In 컨트롤의 GeoMap 컴포넌트로, 지도를 편집하고 수정할 수 있습니다.
- 자사의 권역별 데이터를 이용하고 그 데이터를 배경지도 위에 표시할 수 있습니다.
- 마커와 라인등의 feature를 지도 컴포넌트 위에 올릴 수 있습니다.
- GeoJson 구조의 데이터를 추가로 배경지도 위에 표시할 수 있습니다.
- 사용 방법
GeoMap 데이터 및 이미지 리소스 추가하기
ADMIN > 시스템 관리 > 지도 컴포넌트 관리 화면을 이용해서 데이터를 추가하시면 됩니다.
복원 기능 - 초기화(기본 제공 지리 데이터로 복원) 기능을 이용하세요.
7.0.500.20241212-11 이전 버전
7.0.500.20241212-11 이전 버전의 사이트의 경우, 아래를 참고하여 데이터를 추가하세요.
Repository 테이블 점검하기
iMgt > 시스템 운영관리 > Repository 테이블 점검 화면을 실행하여, GeoMap 컴포넌트 사용에 필요한 테이블이 존재하는지 확인한 후 사용하시기 바랍니다.
※ GeoMap 컴포넌트 사용에 필요한 테이블 목록은 페이지 최하단 참고사항의 #데이터 목록 을 확인하세요.
- GeoMap 사용을 위해 필요한 테이블이 존재하는지 확인합니다.
테이블에 데이터를 추가하려면 아래 첨부된 파일(MAP_GEO_DATA.zip)을 다운로드합니다.
첨부 파일(7.0.500.20241114-11 버전 이하) : MAP_GEO_DATA.zip
첨부 파일(7.0.500.20241114-11 버전 이상 7.0.500.20241212-11 이전) : MAP_GEO_DATA_7.0.500.20241114-11.zip지리 데이터 정보
지리 데이터 구성은 세계 국가별 경계 데이터와, 국내의 경우 시도, 시군구,읍면동, 리 까지의 경계 데이터를 제공합니다.
압축을 해제하지 않고 , iMgt > 백업/복원 > 시스템 백업/복원 화면으로 이동하여 우측 상단의 '업로드' 버튼을 클릭하여 첨부 파일을 업로드합니다.
- 리스트에서 해당 항목의 좌측 체크 박스(
)를 더블 클릭하여 '시스템 복원'을 선택합니다. 
7.0.500.20241212-11 이전 버전
※ 시스템 백업/복원 기능을 통해 테이블에 데이터를 추가하는 과정에서 '시스템 복원' 안내 메시지가 표시될 수 있습니다. 이 메시지와 관계없이, 해당 첨부 파일은 지도 데이터만 포함하고 있으므로 시스템에 영향을 주지 않습니다. 테이블에 데이터가 올바르게 적재되었는지 확인합니다.
백업/복원 기능 사용 시 오류가 나는 경우
시스템 백업/복원 기능 사용 과정에서 테이블이 없다는 오류가 발생하는 경우, 버전에 따라 해당 테이블이 존재하지 않을 수 있습니다.
최신 버전으로 패치를 진행하시거나, 그럴 수 없는 경우 위에서 내려받은 MAP_GEO_DATA.zip 압축파일을 수정하셔야 합니다.
MAP_GEO_DATA.zip > sql 폴더 하위에 존재하지 않는 테이블 이름의 json을 삭제하신 후 다시 위의 작업을 진행하시면 됩니다.
배포 정책
7.0.500.20250529-11 이후의 릴리즈부터는 이미지가 해당 경로에 포함되어 자동으로 배포되므로, 별도의 추가 작업 없이 사용이 가능합니다.
이미지 경로: reports/WEB_IMAGES/geomap/7.0.500.20250529-11 이전의 버전을 사용하는 경우
※ 이미지 리소스가 기본포함되기 이전이므로, 아래의 절차에 따라 수동으로 이미지를 업로드하는 과정이 필요합니다.
※ 필요 시 기존 폴더를 백업한 뒤 진행하시기 바랍니다.
- 첨부된 파일 ( WEB_IMAGES.zip ) 을 다운로드합니다.
- 압축을 해제하고, 아래의 경로에 해당 파일들을 복사하여 덮어씌웁니다.
▪ 경로 : ~Report 경로~/WEB_IMAGES/
▪ Report 경로 확인 방법: iMgt > 시스템 옵션 > REPORTPATH 항목을 확인하세요.- 압축 해제
- 붙여넣기(패치)
- 압축 해제
해당 가이드는 사용자들이 간단하고 빠르게 Add-In 컴포넌트인 GeoMap을 사용할 수 있도록 UserComponent 보고서와 Viewer 보고서를 샘플로 제공합니다. 샘플 보고서 사용을 숙지 후 자유롭게 GeoMap 컴포넌트를 이용하세요.
간단하고 빠르게 해당 기능을 사용할 수 있도록 샘플 보고서를 제공합니다. [i-AUD] GeoMap 컴포넌트 (지도, 맵) 샘플 보고서 모음 에서 확인하실 수 있습니다.
샘플 보고서 안내
샘플 보고서- File DB 사용 주의
샘플 보고서 다운로드 하신 후 사용하실 때 DB Connection 오류 발생 시, 보고서 내 데이터소스의 File DB Connection을 연결해주세요.
: 해당 샘플 보고서는 메인 Viewer 보고서 1개, UserComponent 보고서 2개, Overlay 보고서 2개로 구성되어 있습니다.
최초 샘플 보고서 사용 시에는 아래 목록의 보고서를 모두 다운로드 받으셔야 합니다.
보고서 분류 보고서 명 보고서 설명 다운로드(Click) 혹은 연결 URL Viewer 보고서 [UC] MAP_VIEWER(지도, 맵) UserComponent 보고서를 사용하여 간단하게 GeoMap 컴포넌트를 사용할 수 있음을 보여줍니다. UserComponent 사용 가이드는 반드시 UserComponent 기본 사용 가이드 를 참고하세요. URL: https://rnd.bimatrix.co.kr/aud7/extention/portal/SimpleSSO_Con.jsp?reportCode=REPD8B00FD132AD4E9288E0957F7497185B
보고서 위치: 1. 샘플 보고서 > 1.1. i-AUD > UserComponent > GeoMap> [UC] MAP_VIEWER(지도, 맵)UserComponent 보고서 [GeoMap] Source AddIn Control인 GeoMap 컴포넌트를 감싼 보고서입니다. 인터페이스는 스크립트에 정의되어 있습니다. 추가 기능이 신규로 생길 경우, 해당 보고서가 수정됩니다. [GeoMap] Popup AudMap의 CreateTooltip 기능 외에 보고서를 툴팁 기능처럼 사용하기 위한 보고서입니다. Overlay 보고서 [GeoMap] Overlay_popup GeoMap 컴포넌트 의 addOverlay 메소드 사용 시, i-AUD 보고서를 Overlay할 수 있습니다. 해당 메소드를 위한 샘플 보고서입니다. 스크립트로 파라미터 전달 방법을 확인하세요. 샘플 보고서의 "서울, 대전, 부산 overlay 올리기" 기능에 사용됩니다. [GeoMap] Overlay_chart GeoMap Component의 addOverlay 메소드 사용 시, i-AUD 보고서를 Overlay할 수 있습니다. 해당 메소드를 위한 샘플 보고서입니다. 스크립트로 파라미터 전달 방법을 확인하세요. 샘플 보고서의 "서울, 울산, 전라남도 chart 올리기" 기능에 사용됩니다. 
1 지도 생성 시 필요한 Option 값을 적용할 수 있습니다.
InitOption 설명
libraryType: 0:AudMap, 1:KakaoMap, 2:MapboxMap, 3:VWorldMap
zoom: 확대 수준
center: 중심 좌표
useOSM: AudMap 기준 UseOSM 사용 유무 #AudMap-UseOSM
showZoomControls: AudMap 기준 Zoom 버튼 사용 유무
showUndoRedoControls: AudMap 기준 Undo/Redo 버튼 사용 유무
2 간단한 지도 기본 기능을 확인할 수 있습니다. #Component 인터페이스 3 Overlay 기능을 확인할 수 있습니다. 해당 기능 사용을 위해선 아래를 참고해주세요.
Overlay 기능 사용하기
1. Overlay 보고서를 모두 다운로드받으신 후, 서버에 저장하세요.
2. 저장한 후 보고서 코드를 복사합니다.
3. Viewer보고서의 JScript에서 createReport, createChartReport의 reportCode 변수에 보고서 코드를 붙여넣기합니다.
Overlay_popup// popup 으로 보고서 올리기.. this.createReport = function(){ var coords = [ [126.9780, 37.5665], // 서울 [127.7237, 36.9931], // 대전 [129.0411, 35.1604], // 부산 ]; var reportCode = 'REP1849A3E7C7AB47FEBD719BEAE0D1ED51'; // [GeoMap] Overlay_popup 보고서 reportCode 붙여넣기 for(var i=0; i<coords.length; i++){ var el = createReportElement(); var popup = closure.map.addOverlay({ element: el, position: coords[i], reportCode: reportCode , // [GeoMap] Overlay_popup params: { 'coordinate' : coords[i] }, callback: function(param){ alert(param); } }); closure.popupArr.push(popup); } function createReportElement(){ var el = document.createElement('div'); el.style.width = '150px'; el.style.height = '45px'; return el; } }Overlay_chart// 데이터셋을 실행해서 chart 를 지도 위에 표시한다 this.createChartReport = function(){ Matrix.Execute('DS_CHART_DATA', function(p){ if(p.Success == false){ Matrix.Alert(p.Message); return; } var ds = p.DataSet; var dt = p.DataTable; dt.Rows.forEach(function(row){ var label = row.GetValue('LABEL'); closure.map.util.getCenterPoint(function(datas){ // 중심 좌표를 구하는 함수 var centerCoord = datas.filter(function(data){ return data.name === label; // 원하는 지역의 정보만 반환한다 }).map(function(data){ return data.lonLat; }); if(centerCoord.length > 0){ var param = { male: row.GetValue('MALE'), female: row.GetValue('FEMALE'), label: label }; addPopup(createReportEle(), centerCoord[0], param); } }); }); }); // overlay 추가하기 function addPopup(element, coords, param){ var reportCode = 'REP89D189615CF941F697AC8E1BF4878816' // [GeoMap] Overlay_chart 보고서 reportCode 붙여넣기 var popup = closure.map.addOverlay({ element: element, position: coords, reportCode: 'REP89D189615CF941F697AC8E1BF4878816', // [GeoMap] Overlay_chart params: param }); closure.chartArr.push(popup); } // report element 생성하기 function createReportEle(){ var el = document.createElement('div'); el.style.width = '150px'; el.style.height = '150px'; return el; } }
4 17개 시도별 중심 좌표 찾기 기능을 이용해서 마커로 표현할 수 있습니다. 자세한 사항은 #17개 시도별 중심 좌표 찾기 기능 을 참고하세요. 5 AudMap 기준 UseOSM false일 때 사용 가능한 기능들을 확인할 수 있습니다. 자세한 사항은 #Component-AudMap 인터페이스 을 참고하세요. 6 AudMap 기준 Feature 의 LABEL 에 개행 문자(\n) 를 삽입하는 방법을 확인할 수 있습니다. 자세한 사항은 을 참고하세요. GeoMap 컴포넌트가 제공하는 Property, Method, Event 목록은 아래를 참고하세요.
AudMap만 추가로 제공하는 Property, Method 목록과 추가기능은 아래를 참고하세요.
Component Property
Property 명
Property 설명 Source - Map의 source
Features - Map의 모든 Feature객체 정보
UseHighlightStyle - feature mouseover시의 하이라이트 기능 사용 유무. (default:false)
HighlightStyle - feature mouseover시의 하이라이트 기능의 style 객체
변경 가능한 속성: stroke(color, width), fill(color)
DefaultMapStyle Map의 기본 style 객체
변경 가능한 속성: stroke(color, width), fill(color), font(color,size)
UseOSM OpenStreetMap의 타일 레이어를 배경 지도로 사용 유무를 설정합니다.
UseOSM 참고 사항
OpenStreetMap의 타일 서버 서비스를 이용하여 배경 지도를 표시합니다.
인터넷(외부 네트워크) 연결이 가능한 경우에만 사용 가능합니다.
참고 URL: https://openlayers.org/en/latest/apidoc/module-ol_source_OSM-OSM.html※ 인터넷 연결이 제한되어 있으나 배경 지도를 반드시 사용해야 하는 경우, CS사이트로 문의해주시길 바랍니다.
Component Method
Method 명
Method 설명 getFeature(featureLabelName) 매개 변수 featureLabelName과 feature 객체의 LABEL 속성값과 일치하는 feature를 반환합니다.
- setStyleProperty(propertyName, propertyValue): 해당 객체의 style 속성을 설정합니다. 설정한 style 속성값은 Update() 실행 후 반영됩니다.
- 변경 가능한 속성: FILL_COLOR, FONT_COLOR, FONT_SIZE, FONT_WEIGHT,LINE_COLOR
- ex1) feature.setStyleProperty("FILL_COLOR","#C2C2C5");
- ex2) feature.setStyleProperty("FONT_SIZE","8px");
속성값 예약어 하위호환성
릴리즈 버전 ~7.0.500.20241017-21까지의 속성값 예약어: FILLCOLOR, FONTCOLOR, FONTSIZE, FONTWEIGHT
타사 상용 API 연결 지도 스타일 속성 변경시의 예약어와 통일을 위해 변경되었으나, 하위호환성을 위해 기존 예약어도 사용 가능합니다.
적용 화면 예시) 강원특별자치도 영역 스타일 변경
setFeaturesStyleProperties(dataTable) 매개 변수 dataTable의 각 row의 'LABEL' column의 data와 자신의 LABEL 속성값과 일치하는 featrue의 style 속성을 변경, 설정합니다.
변경 가능한 속성은 setStyleProperty와 동일합니다.
createTooltip() 지도 위의 특정 feature 위에 마우스를 올리면 해당 위치에 Tooltip을 생성하고 Tooltip객체를 반환합니다. Tooltip에는 feature의 'label' 정보가 표시됩니다.
SetBackgroundColor Map 의 배경색을 지정합니다.
예제 코드map.SetBackgroundColor('#F3F3F7');- setStyleProperty(propertyName, propertyValue): 해당 객체의 style 속성을 설정합니다. 설정한 style 속성값은 Update() 실행 후 반영됩니다.
좌측 상단에 기본으로 컨트롤 위젯을 제공합니다.
기능 이미지 기능 명 기능 설명 
Zoom in / Zoom out 현재 지도의 View의 Zoom을 +1 확대 / -1 축소 합니다. 
Undo / Redo 이전 지도에 표시되었던 지리 데이터와 Center, Zoom을 기억하고 표시합니다. 커서 위치에 따른 커스텀 팝업 설정이 필요한 경우에는 아래 가이드를 참고합니다.
GeoMap 컴포넌트 커스텀 팝업 설정 가이드
해당 개선 작업으로 아래와 같이 추가되었습니다.
- 툴팁: Geomap 컴포넌트에서 기본으로 제공하는 기능입니다.
- 사용 방법은 위 createTooltip() 메소드 설명을 참고해주세요.
- 툴팁은 Geomap 컴포넌트의 viewport 내에서만 움직입니다.
- 간단한 style 변경이 가능합니다.
- 팝업: 툴팁보다 다양한 UI를 원하는 사용자들을 위한 기능입니다.
- Geomap 컴포넌트의 event마다 전달해주는 pointEvent의 위치를 이용합니다.
- AUD의 UserComponent를 이용한 샘플 보고서와 아래 가이드를 참고해주세요.
- 가이드:
- 뷰어 보고서의 스크립트 가이드
팝업 기능 사용을 위한 객체 정의
this.popup = { report: Matrix.getObject('RPT_POPUP'), showPopup: function(point, code){ if(!this.report.Visible){ this.report.Visible = true; } var position = this.report.getScriptObject().ShowPOPUP(point, code); this.report.Left = position.x; this.report.Top = position.y; }, hidePopup: function(){ if(this.report.Visible){ this.report.Visible = false; } }, Resize: function(viewerSize){ this.report.getScriptObject().SetMySizeToPOPUP(viewerSize); } }
1에서 정의한 함수 사용 예시
// Geomap의 이벤트 this.map.OnFeatureMouseOver = function(e){ var point = e.point; var feature = e.feature; var logText = "map Feature Hover:: point.X:" + point.X + " / point.Y:" + point.Y; if(feature){ logText += ",feature:" + feature.getProperties().LABEL; if(closure.tooltip){ //아래와 같이 Tooltip의 style, text등을 변경할 수 있습니다. var label = feature.get('LABEL'); switch(label){ case '서울특별시': var text = label + '<br>개행 사용 예시'; closure.tooltip.setText(text); closure.tooltip.Style.BackgroundColor = '#fae7ef'; closure.tooltip.Style.Color = '#413434'; break; case '제주특별자치도': closure.tooltip.Style.Width = 500; break; case '경기도': closure.tooltip.Style.Size = 18; closure.tooltip.Style.Color = '#151a27'; closure.tooltip.Style.BackgroundColor = '#ffcc80'; break; } if(closure.tooltip.IsHide) closure.tooltip.show(); }else if(closure.popup){ if(point){ closure.popup.showPopup(point, feature.get('GID_1')); } } } console.log(logText); } this.map.OnFeatureMouseOut = function(e){ var point = e.point; var feature = e.feature; var logText = "map Feature MouseOut:: point.X:" + point.X + " / point.Y:" + point.Y; if(feature){ logText += ",feature:" + feature.getProperties().LABEL; } if(closure.popup){ closure.popup.hidePopup(); } console.log(logText); } /************************************** * 뷰어의 사이즈가 변경될 때 발생합니다. * * arguments : * double Width (Readonly:False) : 뷰어의 넓이 * double Height (Readonly:False) : 뷰어의 높이 **************************************/ var OnViewerSizeChanged = function(sender, args){ var size = { Width: args.Width, Height: args.Height } main.resize(size); };
- 팝업 샘플 보고서의 스크립트 안내
- 해당 보고서는 샘플 보고서이며, 스크립트 수정으로 사용자가 원하는 대로 사용할 수 있습니다.
- UI는 VIEW class에서, 내용은 CONTENT class에서 관리합니다.
VIEW class에서 팝업 보고서 자신의 위치 조정
var VIEW_CONTROLLER = function(){ this.RECT = { Width: 0, Height:0, Left: 0, Top: 0 }; this.PARENT_SIZE = { Width: 0, Height: 0 }; this.setPosition = function(point){ var position = { x: 0, y: 0 }; var gap = 10; //기본 position.x = this.RECT.Left + point.X + gap; position.y = this.RECT.Top + point.Y - this.RECT.Height - gap; //오른쪽으로 튀어나가는 경우 왼쪽으로 자리를 옮겨준다 if(position.x + this.RECT.Width > this.PARENT_SIZE.Width ){ position.x = this.RECT.Left + point.X - this.RECT.Width - gap; } //위쪽으로 튀어나가는 경우 아래쪽으로 자리를 옮겨준다 if(Math.max(position.y,0) == 0){ position.y = this.RECT.Top + point.Y + gap; } return position; }; }CONTENT class에서 표시해주는 데이터 설정
var CONTENT_CONTROLLER = function(){ this.CODE = ""; this.GRD_INFO = null; this.LBL_TITLE = null; this.LBL_SUBTITLE = null; this.IMG_CONTENT = null; this.LBL_AREA = null; this.LBL_POPULATION = null; this.LBL_DENSITY = null; this.LBL_DISTRICT = null; this.init = function(){ this.GRD_INFO = Matrix.getObject('GRD_INFO'); this.LBL_TITLE = Matrix.getObject('LBL_TITLE'); this.LBL_SUBTITLE = Matrix.getObject('LBL_SUBTITLE'); this.IMG_CONTENT = Matrix.getObject('IMG_CONTENT'); this.LBL_AREA = Matrix.getObject('LBL_AREA'); this.LBL_POPULATION = Matrix.getObject('LBL_POPULATION'); this.LBL_DENSITY = Matrix.getObject('LBL_DENSITY'); this.LBL_DISTRICT = Matrix.getObject('LBL_DISTRICT'); } this.Update = function(code){ if(this.CODE === code){ return; } for(var i = 0; i < this.GRD_INFO.GetRowCount(); i++){ var row = this.GRD_INFO.GetRow(i); if(code === row.GetValue('CODE1') || code === row.GetValue('CODE2')){ this.CODE = code; this.LBL_TITLE.Text = row.GetValue('NAME'); this.LBL_SUBTITLE.Text = row.GetValue('DESCRIPTION'); this.LBL_AREA.Text = row.GetValue('AREA'); this.LBL_POPULATION.Text = row.GetValue('POPULATION'); this.LBL_DENSITY.Text = row.GetValue('DENSITY'); this.LBL_DISTRICT.Text = row.GetValue('DISTRICT'); this.IMG_CONTENT.ImageBase64Text = 'data:image' + row.GetValue('IMAGE_TEXT'); return; } } } this.init(); }
- 뷰어 보고서의 스크립트 가이드
타사 상용 또는 무료 맵 API를 연결하는 경우, 아래 내용을 참고하세요.
지원 API 목록 : Mapbox gl, Kakao 지도, V-world 지도
라이센스 안내
해당 기능은 타사의 상용 맵 API 연결을 지원하는 것이므로, 아래 샘플 처럼 타사의 맵을 이용하기 위해서는 BI MATRIX가 아닌 타사 와의 라이센스 계약이 필요합니다.
이 과정에서 별도로 비용이 요구될 수 있으며 API Key에 대한 사용기간, 발급 방법 등에 대한 내용은 각 라이브러리의 사이트를 참고하세요.필수 옵션 안내
시스템 운영관리 > 제품 별 옵션 설정 > i-AUD 모듈 > 신규로 외부 맵의 appkey 옵션에 관한 row를 아래와 같이 추가하시면 됩니다.
옵션 설명은 다음과 같습니다.
옵션명 외부 API명 appkey 발급 가이드 GEOMAP_KEY.MAPBOX Mapbox gl https://docs.mapbox.com/help/glossary/access-token/ GEOMAP_KEY.KAKAO Kakao 지도 https://apis.map.kakao.com/web/guide/ GEOMAP_KEY.VWORLD V-world 지도 https://www.vworld.kr/dev/v4dv_apikey_s001.do (로그인 시 진입가능) 옵션 미설정 시에는 다음과 같은 메세지가 뜹니다.
각 API의 다른 기능 사용하기
AudMap에서 제공하지 않는 각 API의 다른 기능을 사용하고 싶은 사용자들을 위해, 아래와 같이 객체를 제공합니다. 해당 객체 사용은 각 API 사이트를 참고하세요.
AupMap KakaoMap MapboxMap VWorldMap openlayer kakao mapbox vworld 코드 예시var newMap = new geomap.component.openlayer.Map();
그 외의 추가 기능은 아래를 참고하세요.
feature에 style 추가하기
LoadMap 에서 geojson 을 이용하여 feature 를 생성할 때, 지역별로 스타일 속성(Fill, Line) 을 추가할 수 있습니다.
사용 예제
▶ 메인 보고서 Script
데이터 테이블을 매개변수로 전달합니다. loadMap 함수를 아래와 같이 수정합니다.
예제 코드/* geoJson 레이어 추가 */ this.loadMap = function(level){ if(!level){ var gidValue = []; if(Matrix.getObject('CheckBox').Checked){ gidValue.push(Matrix.getObject('CheckBox').CheckedValue); } if(Matrix.getObject('CheckBox1').Checked){ gidValue.push(Matrix.getObject('CheckBox1').CheckedValue); } Matrix.SetGlobalParams("VS_GID_1" ,gidValue.toString()); }else { Matrix.SetGlobalParams("VS_GID_1" ,''); } Matrix.SetGlobalParams("VS_GID_0" ,'KOR'); addGeoJsonWithStyle(); // 스타일 속성을 가진 데이터소스를 실행한 뒤에 addDomesticGeoJson 호출 function addGeoJsonWithStyle(){ Matrix.Execute('DS_COLOR', function(p){ if(p.Success == false){ Matrix.Alert(p.Message); return; } var ds = p.DataSet; var dt = p.DataTable; closure.map.addDomesticGeoJson(Matrix.getObject('CheckBox2').Checked, dt); }); } }▶ 스타일 데이터 구조
데이터 테이블은 아래의 구조를 가집니다.
Column 명 Data Type Default Value Description GID_CODE string 스타일을 적용할 지역 코드 FILL_COLOR string '#b1c3f9' feature 의 배경색상 FILL_OPACITY number (between 0 and 1) 0.4 feature 의 배경 투명도 LINE_COLOR string '#7e9bf6' feature 의 border 색상 LINE_OPACITY number (between 0 and 1) 0.8 feature 의 border 투명도 LINE_WIDTH number 1 feature 의 border 두께 
예제 코드-- DataSource 명 : DS_COLOR SELECT GID_1 AS GID_CODE , LABEL AS GEO_NAME , '#FF8FAB' AS FILL_COLOR , 0.6 AS FILL_OPACITY , '#FB6F92' AS LINE_COLOR , 1 AS LINE_WIDTH , 0.8 AS LINE_OPACITY FROM MAP_GEO_1 WHERE 1=1 AND LABEL IN ('서울특별시', '충청북도', '부산광역시')▶ UserComponent 보고서 Script
addProperty() 함수에서 geojson 의 feature에 스타일 속성을 추가합니다.
아래의 예제 코드는 GID_1 과 매핑하고 있습니다. 필요에 따라 수정해서 사용하실 수 있습니다.
예제 코드addDomesticGeoJson: function(isFit, options){ Matrix.RunScript("" ,"MAP_SERVICE" ,function(p){ if(p.Success == false){ Matrix.Alert(p.Message); Matrix.DebugWrite('GeoMap', 'refreshMap::'+ p.Message); return; } var geoJson = p.DataSet; var lastLevel = Matrix.GetGlobalParamValue('VS_G_LAST_FEATURE_LEVEL'); Matrix.RemoveGlobalParams('VS_G_LAST_FEATURE_LEVEL'); if(geoJson.features.length > 0) { if(options) geoJson = addProperty(geoJson, options); // geoJson 에 속성을 추가해서 전달합니다 IGeoMapComponent.LoadMap(geoJson, isFit); Matrix.DebugWrite('GeoMap', 'LoadMap::'); }else { alert('마지막 Level입니다.'); return; } }); /* geoJson 의 Property 에 overlay style 속성을 추가하고 geoJson 을 반환합니다. @params property DataTable 의 형태로 GID_CODE, FILL_COLOR, FILL_OPACITY, LINE_COLOR, LINE_WIDTH, LINE_OPACITY 의 Column 을 가진다 */ function addProperty(geoJson, property){ property.Rows.map(function(row){ // geoJson 을 돌면서 속성을 추가합니다. geoJson.features.forEach(function(feature){ if (feature.properties.GID_1 === row.GetValue('GID_CODE')) { // GID_1 과 매핑 feature.properties.GID_CODE = row.GetValue('GID_CODE'); feature.properties.FILL_COLOR = row.GetValue('FILL_COLOR'); feature.properties.FILL_OPACITY = row.GetValue('FILL_OPACITY'); feature.properties.LINE_COLOR = row.GetValue('LINE_COLOR'); feature.properties.LINE_WIDTH = row.GetValue('LINE_WIDTH'); feature.properties.LINE_OPACITY = row.GetValue('LINE_OPACITY'); } }); }); return geoJson; } },▶ 최종 화면 예시
아래의 예시 화면은 KakaoMap 을 이용하였으며, 현재 지원하는 기타 상용 지도(MapboxMap, VWorldMap) 에서도 동일한 결과를 확인할 수 있습니다.
shp 파일 형식 변환 및 좌표계 변환 기능
shp 파일의 형식을 geoJson 으로 바꾸고 AUD 에서 제공하는 지도의 좌표계(WGS84)와 다른 경우에는 좌표계의 변환을 수행합니다.
더욱 자세한 코드를 확인하시려면 geoTools service 불러오기.mtsz를 참고해주세요. (샘플 보고서에서는 mapbox 지도를 사용하고 있습니다.)
제약 사항
- 패치 필요 : 해당 서비스를 이용하기 위해서는 서버에 패치가 필요합니다.
- JDK 11 환경에서 서비스 : 해당 서비스는 JDK 11 환경에서 서비스됩니다. JDK 11 이상의 버전이 아닌 다른 버전에서는 서비스가 제대로 작동하지 않을 수 있습니다.
패치 방법
- geomap-1.0.jar을 [CONTEXT_ROOT]/WEB-INF/lib/ 에 위치시켜 주세요.
- 샘플 보고서의 server script 에서 환경에 맞는 경로로 filePath를 수정해 주세요.
사용 예제
Client Script 예제/* 서버에서 shp 파일을 geoJson 형식으로 변환하고 좌표계를 WGS84 로 변경하는 함수 */ function convertSHPfile(){ Matrix.RunScript('', 'CONVERT_COORDS', function(p){ if(p.Success == false){ Matrix.Alert(p.Message); return; } var ds = p.DataSet; closure.map.LoadMap(ds, true); // 변환된 geoJson을 지도에 표시합니다. }); }Server Script 예제/* 서버에서 jar 파일을 실행 */ var req = Matrix.getRequest(); /* request */ var res = Matrix.getResponse(); /* response */ var session = Matrix.getSession(); /* session */ var util = Matrix.getUtility(); /* utility */ var fso = Matrix.getFileSystemObject(); /* file access */ try{ Matrix.WriteCustomLog('geoTools', '===== shell command [시작] ====='); // shp file path var inputFilePath = req.getParam('VS_SHP_PATH'); // geoJson file path var filePath = 'C:/AUDPlatform_7/matrix/reports/_TEMP_/'; var fileName = util.getUniqueKey('GEO') + '.json'; var outputFilePath = fso.PathCombine(filePath, fileName); // target 좌표계 var epsgCode = req.getParam('VS_EPSG_CODE'); Matrix.WriteCustomLog('geoTools', '===== shell command [inputFilePath] ===== ' + inputFilePath); Matrix.WriteCustomLog('geoTools', '===== shell command [outputFilePath] ===== ' + outputFilePath); /* jar 실행시 필요한 파라미터 */ var cmdArray = [ "C:\\Program Files\\Java\\jdk-11\\bin\\java.exe", // jdk 11 실행 경로 "-jar", // jar 파일 실행 명령어 "C:\\AUDPlatform_7\\matrix\\WEB-INF\\lib\\geomap-1.0.jar", // geomap-1.0.jar 파일 위치 inputFilePath, // .shp 파일의 위치 outputFilePath, // .json 파일의 위치 epsgCode // target 좌표계 ]; var result = util.ShellExecute(cmdArray, true); Matrix.WriteCustomLog('geoTools', '===== shell command [완료] ====='); if(fso.Exists(outputFilePath)){ Matrix.WriteCustomLog('geoTools', '===== read geoJson [시작] ====='); res.WriteResponseTextFile(outputFilePath) fso.DeleteFile(outputFilePath); Matrix.WriteCustomLog('geoTools', '===== read geoJson [완료] ====='); } }catch(e){ Matrix.WriteCustomLog('geoTools', '===== CONVERT_COORDS Error ===== ' + e); }화면 예시
Feature 의 LABEL 에 개행문자(\n) 삽입
AudMap 에서 테이블을 조회하여 지도에 정보를 표시할 때, 개행 문자 \n) 를 지원합니다.
제약 사항
- 패치 필요 : Source.sc 보고서의 패치가 필요합니다.
- \n 문자만 지원합니다 ( OpenLayers에서는 개행 처리를 위해 \n 문자만 지원 )
사용 예제 (Source.sc 보고서)
Client Script 예제/** * 전달받은 geoJson 데이터대로 Layer 위에 표시합니다. isFit이 true일 경우 Bound를 Set합니다. * @param {JSON} geoJson * @param {boolean} isFit */ LoadMap:function(geoJson, isFit, ){ var resultJson = ReplaceValues(geoJson, '\\n', '\n'); this.component.LoadMap(resultJson, isFit); }, /** * object, array, string 값에서 특정 문자열을 찾아 지정한 문자열로 치환하는 유틸 함수 * * @param obj - 탐색 대상 (object, array, string, etc.) * @param target - 치환 대상 문자열 (예: '\\n') * @param replacement - 바꿀 문자열 (예: '\n') * @returns target 문자열이 치환된 새로운 JSON 구조 * * ⚠ 이 함수는 재귀 구조를 가지므로, 대용량 또는 깊은 JSON에서는 브라우저 응답 지연이 발생할 수 있습니다. */ function ReplaceValues(obj, target, replacement) { // 1. 문자열인 경우: target 포함 여부 확인 후 치환 if (typeof obj === 'string') { if (obj.indexOf(target) !== -1) { return obj.split(target).join(replacement); } return obj; } // 2. 배열인 경우: 각 항목을 재귀적으로 처리 else if (Array.isArray(obj)) { var resultArr = []; for (var i = 0; i < obj.length; i++) { resultArr.push(ReplaceValues(obj[i], target, replacement)); } return resultArr; } // 3. 객체인 경우 : 각 속성 재귀 처리 else if (typeof obj === 'object' && obj !== null) { var resultObj = {}; for (var key in obj) { if (obj.hasOwnProperty(key)) { resultObj[key] = ReplaceValues(obj[key], target, replacement); } } return resultObj; } // 4. 숫자, 불린, null 등은 그대로 반환 else { return obj; } }화면 예시
참고 사항
기타 사용 오픈소스 라이브러리
- Client
- Point 좌표계 변환 - proj : https://github.com/OSGeo/PROJ
- 곡선 생성 - turf : https://github.com/Turfjs/turf
- 중심 좌표 반환 - SGIS : https://sgis.kostat.go.kr/developer/html/newOpenApi/api/dataApi/addressBoundary.html
- Server
- 문서 좌표계 변환 - GeoTools : https://github.com/geotools/geotools
- Client
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,680 MAP_GEO_COUNTRY_CODE 전 세계 지리정보체계 코드 데이터(ISO Alpha3, ISO Alpha2, ISO Numeric) 263 MAP_GEO_LANGUAGE 지역명 다국어 데이터 20,771
- 데이터 출처
- 세계 지리 데이터: GADM v4.1. (2022년도 7월)
- 국내 지리 데이터: 주소기반산업지원서비스 도로명주소 DB의 행정구역도 기반 (2026년도 1월)
- 국내 지리 코드표: 행정안전부>업무안내>주민등록,인감 최신일자(등록일 2025.12.22) 게시판
- 세계 지리 코드표: 공공데이터 포털 > 외교부_국가표준코드 (수정일 2024-07-17)
- 권역별 지리 데이터 표시 기능을 사용하기 위해서는 지리 정보가 포함된 참조 테이블과 그 하위 데이터가 모두 필요합니다.
- 데이터 적재 방법: GeoMap 컴포넌트 어드민 사용 가이드
- GeoMap 좌표계 : EPSG:4326
주의 사항
해당 기능은 ie11에서 사용 불가능합니다.
| 기능 정보 |
|
|
|
|
|
|
|
|---|---|---|---|---|---|---|---|
| 시작 버전 정보 |
| ||||||
| 버전 | 날짜 | 댓글 |
|---|---|---|
| 현재 버전 (v. 45) | 2026-02-11 05:36 |
AUD팀: [2026.02.11] 지도 샘플 보고서 모음 페이지 링크 추가 |
| v. 46 | 2026-02-20 00:03 |
AUD팀:
[2026.02.19] (BCRM#G0102) [2026] [GeoMap] 지도 데이터 최신화 및 데이터 정합성 확인 |
| v. 45 | 2026-02-11 05:36 |
AUD팀:
[2026.02.11] 지도 샘플 보고서 모음 페이지 링크 추가 |
| v. 44 | 2026-02-02 17:39 |
AUD팀:
[2026.02.02] 타일 서버 가이드 관련 문서 항목 추가 |
| v. 43 | 2025-09-18 13:10 |
AUD팀:
[2025.09.18] Source 보고서 최신 버전 사용 안내 내용 추가 |
| v. 42 | 2025-08-29 10:36 |
AUD팀:
[2025.08.29] UseOSM 안내 문구 수정 |
| v. 41 | 2025-08-29 10:05 |
AUD팀:
[2025.07.30] [i-AUD] GeoMap 컴포넌트 권역별 데이터 조회 방식 안내 추가 |
| v. 40 | 2025-05-23 09:53 |
AUD팀:
[2025.05.23] (BCRM#F2122) [AUD-Map] 더블클릭 이벤트 제거 방법 - UseDoubleClickZoom |
| v. 39 | 2025-05-22 16:22 |
AUD팀:
[2025.05.22] (BCRM F2176) [GeoMap] GeoMap 에서 사용하는 이미지 리소스 경로 개선 및 기본 배포 정책 전환 |
| v. 38 | 2025-05-21 16:03 |
AUD팀:
[2025.05.21] (BCRM#F2052) [AUD-Map] 피처 마우스 커서 변경 API 필요 |
| v. 37 | 2025-05-16 11:38 |
AUD팀:
[2025.05.16] (BCRM#E3669) [GeoMap] Center 위치를 조정할 수 있는 API 추가 |
| v. 36 | 2025-05-13 16:34 |
AUD팀:
[2025.05.13] Update Release 버전 최신화 |
| v. 35 | 2025-05-13 16:18 |
AUD팀:
[2025.05.09] (BCRM#F1976) [F1902 하위 건][GeoMap > AudMap] 1. 지도 배경 스타일 지정, Source 보고서 추가 |
| v. 34 | 2025-05-08 18:19 |
AUD팀:
[2025.05.08] (BCRM#F1953) [F1902 하위 건][GeoMap > AudMap] 5. 피처 레이블에 개행문자 추가 방법 |
| v. 33 | 2025-05-07 19:39 |
AUD팀:
[2025.05.07] (BCRM#F1939) [GeoMap > AudMap] feature의 FONT_SIZE가 적용되지 않는 현상 - 가이드 내용 추가 |
| v. 32 | 2025-04-25 15:15 |
AUD팀:
[2025.04.25] Update Release 버전 최신화 |
| v. 31 | 2025-04-16 18:41 |
AUD팀:
[2025.04.16] (BCRM#F1535) [F1063 하위 건] AudMap 에 (Redo/Undo), (확대/축소) 버튼 옵션 처리 |
| v. 30 | 2025-04-11 18:01 |
AUD팀:
[2025.04.11] 참조 테이블 수정 시 도움말 안내 |
| v. 29 | 2025-03-06 10:44 |
AUD팀:
[2025.03.06] GeoMap Source 보고서 최신화 |
| v. 28 | 2025-02-27 17:58 |
AUD팀:
[2025.02.27] Update Release 버전 최신화 |
| v. 27 | 2025-02-23 15:56 |
AUD팀:
[2025.02.23] (BCRM#E3667) [GeoMap] 지도 데이터 최신화 및 데이터 정합성 확인 - 데이터 최신 버전 기입 |
| v. 26 | 2025-01-08 11:03 |
AUD팀:
[2025.01.08] (BCRM#E5034) [스마트로] GeoMap 실행 오류 문의 건. - Source 보고서 오류 수정 |
| v. 25 | 2025-01-08 10:04 |
AUD팀:
[2024.12.26] 이전 버전 데이터 추가하기 - 하위 버전 사용 방법 안내 |
| v. 24 | 2024-12-26 11:41 | 품질기술팀 |
| v. 23 | 2024-12-26 11:39 | 품질기술팀 |
| v. 22 | 2024-12-26 10:40 |
AUD팀:
[2024.12.26] 이전 버전 데이터 추가하기 - 버전별 첨부 파일 분리 |
| v. 21 | 2024-12-17 14:57 |
AUD팀:
[2024.12.11] 지도 컴포넌트 어드민 화면 사용 가이드 내용 추가 |
| v. 20 | 2024-11-26 15:56 | 품질기술팀 |
| v. 19 | 2024-11-22 16:30 |
AUD팀:
[2024.11.22] 지리 데이터 파일 오류 수정 |
| v. 18 | 2024-11-19 15:54 |
AUD팀:
[2024.11.19] (BCRM#E4265) 지도 내 폰트 변경 문의 (타일서버 일때 + 기본지도 일때) |
| v. 17 | 2024-11-11 17:24 |
AUD팀:
[2024.11.11] (BCRM#E4050) [우리에프아이에스] 세계지도 히트맵 적용시 국가코드 관련문의 - MAP_GEO_COUNTRY_CODE 테이블 생성 및 데이터 최신화 |
| v. 16 | 2024-11-11 10:03 |
AUD팀:
[2024.11.11] (BCRM#E3824) undo 기능 실행 후 지도 isfit 기능 문의 |
| v. 15 | 2024-10-25 11:32 |
AUD팀:
[2024.10.25] 타사 상용 API 연결 지도 스타일 속성 변경 모든 레벨 가능하도록 개선 |
| v. 14 | 2024-10-25 08:42 |
AUD팀:
문서 내부에 변경 이력을 추가 |
| v. 13 | 2024-10-24 17:40 |
AUD팀:
[2024.10.24] 세계 국가별 권역 LEVEL 0 기본 배포 |
| v. 12 | 2024-10-16 17:58 |
AUD팀:
Update Release No 최신화 |
| v. 11 | 2024-10-16 17:54 |
AUD팀:
Source 보고서 오류 수정 |
| v. 10 | 2024-10-07 10:23 |
AUD팀:
릴리즈 번호 업데이트 변경 |
| v. 9 | 2024-09-10 16:43 |
AUD팀:
source temp 파일 경로 제거 |
| v. 8 | 2024-09-09 17:58 |
AUD팀:
Cachefile read source update |
| v. 7 | 2024-09-09 16:49 |
AUD팀:
WEB_IMAGES 패치 방법 업데이트 |
| v. 6 | 2024-09-03 11:42 |
AUD팀:
가이드별 제품 버전 명시 |
| v. 5 | 2024-07-22 13:48 |
AUD팀:
샘플 보고서 URL 변경 |
| v. 4 | 2024-07-09 18:33 |
AUD팀:
이전 버전에서 최신 버전 패치 시 수정해야하는 내용 안내 |
| v. 3 | 2024-07-04 16:55 |
AUD팀:
Start Release 잘못 표기된 사항 수정 |
| v. 2 | 2024-07-03 11:01 |
품질기술팀:
타사 상용 맵 라이선스 안내 추가 |
| v. 1 | 2024-06-25 23:20 | AUD팀 |
