page no. 79410815
라이센스 안내
해당 기능은 타사의 상용 맵 API 연결을 지원하는 것이므로, 아래 샘플 처럼 타사의 맵을 이용하기 위해서는 BI MATRIX가 아닌 타사 와의 라이센스 계약이 필요합니다.
이 과정에서 별도로 비용이 요구될 수 있으며 API Key에 대한 사용기간, 발급 방법 등에 대한 내용은 각 라이브러리의 사이트를 참고하세요.
기능 사용 전 필수 참고 사항
- 해당 기능을 사용하기 위해서는 패치를 우선적으로 해주셔야 합니다. 패치 방법은 GeoMap 컴포넌트(국내지도) 사용 가이드 의 패치 적용 방법 안내 를 참고하세요. 아래 항목까지만 적용하시면 됩니다.
- 기존 패키지 패치 방법과 동일하게 백업 후 패치를 진행합니다.
- GeoMap 컴포넌트 사용을 위해 필요한 데이터를 아래의 보고서를 통해 생성합니다.
- 필수 옵션과 제약 사항에 관해서는 GeoMap 컴포넌트(국내지도) 사용 가이드 를 참고하세요.
- 해당 기능을 위해 사용한 오픈 소스 라이브러리에 대한 내용은 아래 참고사항 을 참고하세요.
- 기능 설명
- AddIn Control의 GeoMap Component를 이용하여 타사 상용 또는 무료 맵 API를 사용할 수 있습니다.
- 지원 API 목록 : Mapbox gl, Kakao 지도, V-world 지도
사용 방법
간단하고 빠르게 해당 기능을 사용할 수 있도록 샘플 보고서를 제공합니다.최초 샘플 보고서 사용 시에는 아래 목록의 보고서를 모두 다운로드 받으셔야 합니다.
보고서 분류 보고서 명 보고서 설명 다운로드 Viewer 보고서 [UC] MAP_VIEWER(external) (상용 지도) UserComponent 보고서를 사용하여 간단하게 해당 기능을 사용할 수 있음을 보여줍니다. UserComponent 사용 가이드는 UserComponent 기본 사용 가이드 를 참고하세요. UserComponent 보고서 [GeoMap] MAP_USERCOMPONENT(external) AddIn Control인 GeoMap Component를 감싼 보고서입니다. 인터페이스는 스크립트에 정의되어 있습니다. 추가 기능이 신규로 생길 경우, 해당 보고서가 수정됩니다. [GeoMap] MAP_USERCOMPONENT(overlay) GeoMap Component의 addOverlay 메소드 사용 시, i-AUD 보고서를 Overlay할 수 있습니다. 해당 메소드를 위한 샘플 보고서입니다. 스크립트로 파라미터 전달 방법을 확인하세요. 샘플 보고서- File DB 사용 주의
샘플 보고서 다운로드 하신 후 사용하실 때 DB Connection 오류 발생 시, 보고서 내 데이터소스의 File DB Connection을 연결해주세요.
- 적용 결과
Component 인터페이스
Method 명
Method 설명
addLine(locations) 매개 변수 locations 정보에 맞는 위치에 Line을 생성하고, 해당 Line 객체를 반환합니다.
addMarker(markerInfos) 매개 변수 markerInfos정보에 맞는 위치에 Marker를 생성하고, 해당 Marker 객체를 반환합니다.
- markerInfos : Array<object> 예시)
Dispose() Component를 Dispose합니다. Resize() Component를 Resize합니다. LoadMap(geoJson, isFit) 전달받은 geoJson 데이터대로 Layer 위에 표시합니다. isFit이 true일 경우 Bound를 Set합니다. - geoJson : GeoJSON - isFit : boolean addOverlay(options) Overlay를 추가합니다.
addDomesticGeoJson(isFit) 권역별 데이터를 로드하여 Layer를 추가합니다. isFit이 true일 경우 Bound를 Set합니다. - isFit : boolean Component 이벤트
Event 명
Event 설명
OnFeatureClick Map의 어떠한 Feature를 click시 발생합니다.
해당 Feature 객체를 전달받습니다.
OnMarkerClick Map에 Marker가 존재하고 해당 Marker를 click시 발생합니다.
해당 Marker 객체와 아래 Layer의 Feature 객체를 전달받습니다.
이외 추가 기능은 아래 가이드를 참고하세요.
참고 사항
사용 오픈소스 라이브러리
- 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
필수 옵션
시스템 운영관리 > 제품 별 옵션 설정 > 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 (로그인 시 진입가능) 옵션 미설정 시에는 다음과 같은 메세지가 뜹니다.
주의 사항
제약 사항
- 해당 기능은 ie11에서 사용 불가능합니다.
- 반드시 [i-AUD] GeoMap 국내지도 컴포넌트를 제공합니다. 를 우선으로 확인하고 해당 가이드의 기능을 이용하셔야 합니다.
- API Key에 대한 사용기간, 발급 방법 등에 대한 내용은 각 라이브러리 사이트를 참고하세요.
기능 정보 |
|
|
|
|
|
|
|
---|---|---|---|---|---|---|---|
시작 버전 정보 |
|
샘플 정보
- 샘플 URL
- 샘플 파일