연구 개발 매뉴얼
공간 바로가기
페이지 트리
메타 데이터의 끝으로 건너뛰기
메타 데이터의 시작으로 이동

이 페이지의 이전 버전을 보고 있습니다. 현재 버전 보기.

현재와 비교 페이지 이력 보기

« 이전 버전 8 다음 »

GeoMap Component를 통해 i-AUD가 타사 상용 또는 무료 맵에 대해서는 고객사에서 발급받은 API를 통한 연결을 지원합니다.

Start Release No : 7.0.500~ / Update Release No :

프로젝트명 : (BCRM#E0122) [GeoMap Component] 타사 상용 또는 무료 맵에 대한 연결 지원

작성자 : 황송희, 김예슬         / 검수자 : 

기능 정보
  • API Open
  • UI Open
  • Read Only
  • Not Use
  • Hidden
  • Not Recommend

기능 사용 전 필수 참고 사항

  • 해당 기능을 사용하기 위해서는 패치를 우선적으로 해주셔야 합니다. 패치 방법은 GeoMap 컴포넌트(국내지도) 사용 가이드 의 패치 적용 방법 안내 를 참고하세요. 아래 항목까지만 적용하시면 됩니다.
    1. 기존 패키지 패치 방법과 동일하게 백업 후 패치를 진행합니다.
    2. GeoMap 컴포넌트 사용을 위해 필요한 데이터를 아래의 보고서를 통해 생성합니다.
  • 필수 옵션과 제약 사항에 관해서는 GeoMap 컴포넌트(국내지도) 사용 가이드 를 참고하세요.

기능 설명

  1. 기능 설명
    1. AddIn Control의 GeoMap Component를 이용하여 타사 상용 또는 무료 맵 API를 사용할 수 있습니다.
    2. 지원 API 목록 : Mapbox gl, Kakao 지도, V-world 지도

  2. 사용 방법
    간단하고 빠르게 해당 기능을 사용할 수 있도록 rnd 사이트에 샘플 보고서를 제공합니다.

    보고서 분류보고서 명보고서 설명다운 혹은 연결 URL
    Viewer 보고서[UC] MAP_VIEWER(external) (상용 지도)UserComponent 보고서를 사용하여 간단하게 해당 기능을 사용할 수 있음을 보여줍니다. UserComponent 사용 가이드는 UserComponent 기본 사용 가이드 를 참고하세요.

    URL: https://rnd.bimatrix.co.kr/aud7/portal/Content.jsp?id=REP5D10EC786D6046698FCDB4447CF1A33C
    보고서 위치: 1. 샘플 보고서 > 1.1. i-AUD > UserComponent > [UC] MAP_VIEWER(external) (상용 지도)

    UserComponent 보고서[GeoMap] MAP_USERCOMPONENT(external)AddIn Control인 GeoMap Component를 감싼 보고서입니다. 인터페이스는 스크립트에 정의되어 있습니다. 추가 기능이 신규로 생길 경우, 해당 보고서가 수정됩니다.

    [GeoMap] MAP_USERCOMPONENT(external).sc

    [GeoMap] MAP_USERCOMPONENT(overlay)GeoMap Component의 addOverlay 메소드 사용 시, i-AUD 보고서를 Overlay할 수 있습니다. 해당 메소드를 위한 샘플 보고서입니다. 스크립트로 파라미터 전달 방법을 확인하세요.

    [GeoMap] MAP_USERCOMPONENT(overlay).sc

  3. 적용 결과


  4. Component 인터페이스

    Method 명

    		Method 설명
    addLine(locations)

    매개 변수 locations 정보에 맞는 위치에 Line을 생성하고, 해당 Line 객체를 반환합니다.

     Method
    • setColor(color): line 객체의 color를 설정합니다. Update() 실행 후 UI가 변경됩니다.
    • setWidth(width): line 객체의 width를 설정합니다. Update() 실행 후 UI가 변경됩니다.
    • setLineDash(linedash): line 객체의 lineDash 사용 여부를 설정합니다. Update() 실행 후 UI가 변경됩니다.
    • setLineCap(lineCap): line 객체의 line style를 설정합니다. Update() 실행 후 UI가 변경됩니다.
    • removeLines(coordinate): 매개 변수 coordinate에 해당하는 line를 제거합니다.
    addMarker(markerInfos)

    매개 변수 markerInfos정보에 맞는 위치에 Marker를 생성하고, 해당 Marker 객체를 반환합니다.

    - markerInfos : Array<object> 예시)

    markerInfos 예시 
    [{'name' : '세방빌딩',
    'id' : 'ID_AA',
 'lonLat': ['127.0448', '37.5038']},
 {'name' : '경복궁',
    'id' : 'ID_BB',
 'lonLat': ['126.9602', '37.5788']} ]
     Method
    • setImg(imgUrl, imgScale): 기본 제공 마커 이미지 대신 다른 이미지를 원하는 scale에 맞춰 설정합니다.
      • imgUrl: contextpath/reports/WEB_IMAGES 아래의 이미지 파일
    • removeMarkers(id): 매개 변수 id에 해당하는 marker를 제거합니다. id가 undefined일 경우, 모든 marker를 제거합니다.
    Dispose()Component를 Dispose합니다.
    Resize()Component를 Resize합니다.
    LoadMap(geoJson, isFit)전달받은 geoJson 데이터대로 Layer 위에 표시합니다. isFit이 true일 경우 Bound를 Set합니다. - geoJson : GeoJSON - isFit : boolean
    addOverlay(options)

    Overlay를 추가합니다.

    options 
    element?: HTMLElement;
offset?: Array<number>;
position?: Array<number>;
positioning? : string;
reportCode?: string;
params?: object;
    addDomesticGeoJson(isFit)권역별 데이터를 로드하여 Layer를 추가합니다. isFit이 true일 경우 Bound를 Set합니다. - isFit : boolean

  5. Component 이벤트

    Event 명Event 설명
    OnFeatureClick

    Map의 어떠한 Feature를 click시 발생합니다.

    해당 Feature 객체를 전달받습니다.

    OnMarkerClick

    Map에 Marker가 존재하고 해당 Marker를 click시 발생합니다.

    해당 Marker 객체와 아래 Layer의 Feature 객체를 전달받습니다.

 추가 기능

문서 좌표계 변경 기능

  1. 실행 경로 : [제품(상품)명 > 컨트롤러(컴포넌트) 명 > 기능명(Property,Method,Event) > 속성(파라미터) 명]
  2. 사용 방법
    1. 이미지 추가 및 설명을 작성 합니다.
      1. 세부 내역
    2. 적용 결과

17개 시도별 중심 좌표 찾기 기능

개요

getCenterPoint(callback) 은 map 의 util 객체에 정의되어 있습니다.

파라미터 callback 은 각 지역의 정보를 가져온 뒤 실행되는 함수입니다.

SGIS 에 정의되어 있는 지역의 데이터를 가져오고 있으며, 정확한 중앙값을 보장할 수 없습니다.

현재는 시/도 범위의 중심 좌표만 지원합니다.

사용 예제

예제 코드
function getCenter(){
	map.util.getCenterPoint(function(datas){
		// callback function
		var markerInfo = datas.map(function(data){
			retrun {
				name: data.name,
				lonLat: data.lonLat
			}
		});
		map.addMarker(markerInfo);	// 마커로 표시합니다
	});
}

결과값

lonLat: 좌표값

code: SGIS 의 지역 코드

name: 지역 이름 (MAP_GEO_1 테이블의 LABEL 에 해당하는 값과 같습니다)

결과값 
[
    {
        "lonLat": [
            126.97834782835902,
            37.56669009036455
        ],
        "code": "11",
        "name": "서울특별시"
    },
    {
        "lonLat": [
            129.09175563706935,
            35.24125634125668
        ],
        "code": "21",
        "name": "부산광역시"
    },
    {
        "lonLat": [
            128.6226425399308,
            35.97347538476608
        ],
        "code": "22",
        "name": "대구광역시"
    },
    {
        "lonLat": [
            126.70523602351949,
            37.45604185708162
        ],
        "code": "23",
        "name": "인천광역시"
    },
    {
        "lonLat": [
            126.8354459164671,
            35.15573674234789
        ],
        "code": "24",
        "name": "광주광역시"
    },
    {
        "lonLat": [
            127.39405991650911,
            36.33980451022681
        ],
        "code": "25",
        "name": "대전광역시"
    },
    {
        "lonLat": [
            129.23840258289323,
            35.55370705798613
        ],
        "code": "26",
        "name": "울산광역시"
    },
    {
        "lonLat": [
            127.25881030360377,
            36.560535581441435
        ],
        "code": "29",
        "name": "세종특별자치시"
    },
    {
        "lonLat": [
            127.25204502645134,
            37.2865873659788
        ],
        "code": "31",
        "name": "경기도"
    },
    {
        "lonLat": [
            128.17336172923484,
            37.8836272925393
        ],
        "code": "32",
        "name": "강원특별자치도"
    },
    {
        "lonLat": [
            127.53924730130387,
            36.73834076972116
        ],
        "code": "33",
        "name": "충청북도"
    },
    {
        "lonLat": [
            126.71839045797792,
            36.67835738574175
        ],
        "code": "34",
        "name": "충청남도"
    },
    {
        "lonLat": [
            127.10867588676484,
            35.820389942968816
        ],
        "code": "35",
        "name": "전라북도"
    },
    {
        "lonLat": [
            126.67198974055624,
            34.814882947753354
        ],
        "code": "36",
        "name": "전라남도"
    },
    {
        "lonLat": [
            128.75109173106813,
            36.4649263768976
        ],
        "code": "37",
        "name": "경상북도"
    },
    {
        "lonLat": [
            128.16437996516694,
            35.42913615877326
        ],
        "code": "38",
        "name": "경상남도"
    },
    {
        "lonLat": [
            126.48382513785216,
            33.40104880413814
        ],
        "code": "39",
        "name": "제주특별자치도"
    }
]

필수 옵션

  • 시스템 운영관리 > 제품 별 옵션 설정 > i-AUD 모듈 > 신규로 외부 맵의 appkey 옵션에 관한 row를 아래와 같이 추가하시면 됩니다.

제약 사항

  • 해당 기능은 ie11에서 사용 불가능합니다.
  • 반드시 GeoMap 컴포넌트(국내지도) 사용 가이드 를 우선으로 확인하고 해당 가이드의 기능을 이용하셔야 합니다.
  • API Key에 대한 사용기간, 발급 방법 등에 대한 내용은 각 라이브러리 사이트를 참고하세요.

샘플 정보

  파일 변경됨
공유된 파일이 아직 없습니다.

변경 전/후 제품 버전

변경 전(제품 버전)

변경 전


변경 후

참고 자료

사용 오픈 소스 라이브러리

  1. Client
    1. Point 좌표계 변환 - proj : https://github.com/OSGeo/PROJ
    2. 곡선 생성 - turf : https://github.com/Turfjs/turf
    3. 중심 좌표 반환 - SGIS : https://sgis.kostat.go.kr/developer/html/newOpenApi/api/dataApi/addressBoundary.html
  2. Server
    1. 문서 좌표계 변환 - GeoTools : https://github.com/geotools/geotools
 여기를 클릭하여 펼치기...

  파일 변경됨
공유된 파일이 아직 없습니다.

문서 수정 이력

버전 날짜 댓글
현재 버전 (v. 8) 2024-03-19 08:47 AUD팀
v. 37 2024-06-27 20:07 AUD팀
v. 36 2024-06-27 16:02 AUD팀:
v. 33으로 복귀하기(최신화는 다른 가이드에 진행했습니다.)
v. 35 2024-06-25 14:12 AUD팀
v. 34 2024-06-25 13:37 AUD팀
v. 33 2024-06-21 11:16 품질기술팀
v. 32 2024-06-21 10:57 품질기술팀
v. 31 2024-06-21 10:57 품질기술팀
v. 30 2024-06-21 10:57 품질기술팀
v. 29 2024-06-21 10:54 품질기술팀
v. 28 2024-06-04 13:53 품질기술팀
v. 27 2024-05-20 10:04 품질기술팀
v. 26 2024-04-05 09:53 AUD팀
v. 25 2024-04-04 16:35 AUD팀
v. 24 2024-04-04 16:34 AUD팀
v. 23 2024-04-04 16:00 AUD팀
v. 22 2024-03-25 16:37 AUD팀
v. 21 2024-03-21 14:28 품질기술팀
v. 20 2024-03-21 14:27 품질기술팀
v. 19 2024-03-21 14:26 품질기술팀
v. 18 2024-03-21 14:26 품질기술팀
v. 17 2024-03-21 14:25 품질기술팀
v. 16 2024-03-21 14:25 품질기술팀
v. 15 2024-03-21 14:25 품질기술팀
v. 14 2024-03-21 14:24 품질기술팀
v. 13 2024-03-21 14:23 품질기술팀
v. 12 2024-03-21 14:23 품질기술팀
v. 11 2024-03-19 10:05 AUD팀:
곡선 생성 기능 추가
v. 10 2024-03-19 09:55 AUD팀:
좌표계 변경 기능 추가
v. 9 2024-03-19 08:49 AUD팀
v. 8 2024-03-19 08:47 AUD팀
v. 7 2024-03-19 08:30 AUD팀
v. 6 2024-03-18 19:23 AUD팀:
옵션 미설정 시 메세지 안내 추가
v. 5 2024-03-18 16:54 AUD팀
v. 4 2024-03-18 16:53 AUD팀
v. 3 2024-03-18 16:51 AUD팀
v. 2 2024-03-08 18:59 AUD팀:
중간 저장
v. 1 2024-02-25 20:07 AUD팀

BCRM 정보

(BCRM#E0122) [GeoMap Component] 타사 상용 또는 무료 맵에 대한 연결 지원

...

  • 레이블 없음