협업 - 위치정보연계

위치정보연계는 사용자의 현재 위치(위도, 경도)를 취득할 수 있는 컴포넌트로 다양한 위치기반 서비스에 활용할 수 있다.
사용자의 현재 위치 취득에는 HTML5의 GeoLocation API를 사용한다.

본 컴포넌트 예제로 사용자의 현재 위치를 기반으로 주변 건물 위치정보를 조회하며, 관리자가 건물 위치정보를 관리하는 기능을 제공한다.

* 기능흐름

본 컴포넌트의 모바일 화면은 모바일 디바이스에 탑재된 브라우저를 대상으로 개발 및 테스트 검증이 완료되었다.
또한 동일 제조사의 동일한 브랜드라도 PC용 브라우저와 mobile용 브라우저의 HTML5, CSS3 에 대한 지원이 상이함으로
개발시 유의가 필요함을 밝혀둔다.

검증 대상 디바이스와 브라우저로는 각각 갤럭시S2, 갤럭시S, iPad2, iPhone4, 갤럭시탭1 등의 디바이스와
android용 웹 브라우저, Firefox, Safari, opera mobile 등의 모바일 브라우저를 사용하였다.

검증결과는 아래와 같다.

Android
android용 웹 브라우저, Firefox(6.xx), opera mobile은 android OS 2.3(gingerbread) 에서 HTML5, CSS3 및 컴포넌트의
실행이 안정적으로 실행되는 것을 확인 하였다.
반면 android OS 2.3(gingerbread) 하위 브라우저인 android 2.1, 2.2에서는 컴포넌트 실행에 있어 매끄럽지 못한 HTML5, CSS3 지원으로 인하여
컴포넌트의 UI 구현이 원할하지 못한 모습을 보였다.

opera mobile의 경우 UI처리시 색상 및 이벤트 처리에 문제를 야기하였으며
그로인해 opera mobile은 3종 지원브라우저 대상에서 제외 되었다.
테스트 모바일 디바이스로는 갤럭시, 갤럭시S2, 갤럭시탭1을 채택하였다.

iOS
iOS는 3종 지원브라우저 대상중 하나로 Safari 4.2, 4.3 버전에서 검증을 하였으며 비교적 원활한 HTML5, CSS3를 지원을 하였다.
테스트 모바일 디바이스로는 iPhone4, iPad2를 채택하였다.

모바일위치정보연계서비스의 예제로 제공하는 2가지 지도를 사용하기 위해서는 별도로 해당 지도 API 인증키를 신청하여야 한다.
- 국가공간정보통합체계 지도 : http://www.nsdi.go.kr/use/openapi/key/ahUseOpenAPIKey010.do)
- Daum 지도 : https://apis.daum.net/register/myapi.daum)

예제로 사용하는 국가공간정보통합체계 지도 및 Daum 지도 사용에 관한 모든 권한은 해당 기관에 있으며,
Daum 지도 사용시 'Daum 지도 Open API 서비스 이용약관'을 확인 후 사용한다.
(Daum 지도 Open API 서비스 이용약관 : http://dna.daum.net/apis/mapagreement)

예제로 사용하는 지도 외에도 기타 지도 API 약관 및 규격에 맞추에 서비스를 연계하여 구축 가능하다.

모바일위치정보연계서비스는 크게 건물 위치정보의 관리기능인 건물 위치정보 목록조회, 상세조회, 등록, 수정, 삭제로 구성되어 있으며, 사용자의 현재 위치를
기반으로한 위치정보 조회 기능으로 구성되어 있다.(관련기능 부분참조)

• ID Generation Service를 활용하기 위해서 Sequence 저장테이블인 COMTECOPSEQ에 GEO_ID (건물위치정보 아이디) 항목을 추가해야 한다.

위치정보연계는 건물 정보 목록조회, 상세조회, 등록, 수정, 삭제에서 관리자 인증이 필요하다.
인증을 위해 로그인/회원관리/권한관리 컴포넌트와 연계하여 사용할 수 있다. Spring Security를 통해 인증을 할 경우 다음과 같이 변경하면 된다.

    <!--인증된 유저의 LoginVO, 권한, 인증 여부를 확인 할 수있는 서비스 클래스-->
    <bean id="egovUserDetailsHelper" class="egovframework.com.cmm.util.EgovUserDetailsHelper">
        <property name="egovUserDetailsService">
            <ref bean="egovUserDetailsSecurityService" />
        </property> 
    </bean>
 
    <!-- 시큐리티를 이용한 인증을 사용할 빈 -->
    <bean id="egovUserDetailsSecurityService" class="egovframework.com.sec.ram.service.impl.EgovUserDetailsSecurityServiceImpl"/>

    <!-- 2. 스프링 시큐리티 설정-->
    <filter>
        <filter-name>springSecurityFilterChain</filter-name>
        <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>springSecurityFilterChain</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
 
    <listener>
        <listener-class>org.springframework.security.ui.session.HttpSessionEventPublisher</listener-class>
    </listener>
    <!-- security 끝 -->
 
    <!-- 4. Spring Security 로그아웃 설정을 위한 필터 설정 -->
    <filter>
    	<filter-name>EgovSpringSecurityLogoutFilter</filter-name>
    	<filter-class>egovframework.com.sec.security.filter.EgovSpringSecurityLogoutFilter</filter-class>
    </filter>
    <filter-mapping>
    	<filter-name>EgovSpringSecurityLogoutFilter</filter-name>
    	<url-pattern>/uat/uia/actionLogout.do</url-pattern>
    </filter-mapping>
 
    <!-- 4. Spring Security 로그인 설정을 위한 필터 설정 -->
    <filter>
    	<filter-name>EgovSpringSecurityLoginFilter</filter-name>
    	<filter-class>egovframework.com.sec.security.filter.EgovSpringSecurityLoginFilter</filter-class>
    </filter>
    <filter-mapping>
    	<filter-name>EgovSpringSecurityLoginFilter</filter-name>
    	<url-pattern>*.do</url-pattern>
    </filter-mapping>

web.xml에 위 내용과 같은 Spring Security 관련 필터를 추가 하여야 한다.

로그인/회원관리/권한관리에 대한 자세한 내용은 다음을 참조한다.

• 로그인 : 일반로그인
• 회원관리 : 사용자관리
• 권한관리 : 권한관리

사용자/관리자 권한이 필요한 페이지는 다음과 같다.

* 현재 배포된 모바일 공통컴포넌트는 HTML5, CSS3를 적용하고 있다.
* 그에 따라, 현재 모바일OK, W3C의 모바일 웹 사이트 유효성 검사의 표준에 맞지 않으며, 정확한 유효성 검사에 대한 문의는 해당 전문기관에 문의가 필요하다.
* 현재 배포된 모바일 공통컴포넌트 V 2.0은 소스코드에 대한 보안성 검증이 완료 되었다.

모바일위치정보연계서비스는 크게 일반사용자가 사용하는 모바일 위치정보 조회 기능 및 관리자가 사용하는 건물 위치정보 목록조회, 건물 위치정보 상세조회,
건물 위치정보 등록, 건물 위치정보 수정, 건물 위치정보 삭제 기능으로 구성되어있다.

사용자의 현재 위치를 기준으로 조회범위에 따라 주변 건물의 위치정보를 조회할 수 있다.

해당 기능 사용시 페이지내에 다음과 같은 설정이 필요하다.

  <script type="text/javascript" src="http://www.nsdi.go.kr/use/openapi/key/certifyKey.do?oap_key=발급받은인증키" charset="utf-8"></script>

또는

  <script type="text/javascript" src="http//apis.daum.net/maps/maps3.js?apikey=발급받은인증키"></script>

위의 코드에서 발급받은인증키 부분에 사전에 발급받은 인증키를 입력한다.

기타 지도 API 사용시 다음의 부분을 해당 지도 API 규격에 맞게 수정하여 사용할 수 있다.

 <!-- 맵 API* -->
 이하 수정

 // 조회 범위에 따른 ZoomLevel 설정*
 이하 수정

 // 현재 위치 좌표*
 이하 수정

 // 지도 설정*
 이하 수정

 // 지도 생성*
 이하 수정

 // 현재 위치 마커 표시*
 이하 수정

 // 정보창 생성*
 이하 수정

 // 건물 아이콘*
 이하 수정

 // 조회 범위 내의 건물 마커 표시*
 이하 수정

 // 조회 범위 원 그리기*
 이하 수정

N/A

조회범위 변경: 조회범위를 변경할 때마다 조회범위 내에 존재하는 건물의 위치정보를 조회한다.

조회조건으로 목록조회를 할 수 있고, 등록버튼을 클릭하여 건물 위치정보 등록 화면으로 이동하여 건물 위치정보를 등록 처리 할 수 있다.

N/A

건물 위치정보 목록은 페이지 당 10건씩 조회되며 페이징은 10페이지씩 이루어진다. 검색조건은 건물명, 전화번호, 주소에 대해서 수행된다.
페이지 당 검색 범위를 변경하고자 하는 경우 context-properties.xml 파일의 pageUnit, pageSize를 변경한다.
(단 해당 설정은 전체 공통서비스 기능에 영향을 미친다.)

조회: 건물 위치정보를 조회하기 위해서는 상단의 검색조건을 선택 후 해당하는 검색문자를 입력 후 조회 버튼을 클릭한다.
등록: 건물 위치정보를 등록하기 위해서는 상단의 등록 버튼을 통해서 건물 위치정보 등록 화면으로 이동한다.
목록클릭: 건물 위치정보 상세조회 화면으로 이동한다.

건물 위치정보 목록조회에서 목록 클릭 시 이동되는 화면으로 건물 위치정보에 대한 상세정보를 보여준다.

N/A

건물 위치정보 상세조회화면은 건물 위치정보 수정, 건물 위치정보 삭제, 건물 위치정보 목록조회를 할 수 있다.

수정: 수정버튼 클릭 시 건물 위치정보를 수정할 수 있는 화면으로 이동한다.
삭제: 삭제버튼 클릭 시 삭제여부를 확인하는 메세지를 보여주고 삭제처리를 할 수 있다.
목록: 건물 위치정보 목록조회 화면으로 이동한다.

입력명 우측의 빨간* 표시는 반드시 입력해야할 항목을 표시한다.

저장처리 시 GEO_ID 컬럼은 “egovframework.rte.fdl.idgnr.impl.EgovTableIdGnrService”를 통하여

Primary Key => GEO_ID : 일련번호로 자동생성 부여된다.

<bean name="egovGeoLocationIdGnrService"
	class="egovframework.rte.fdl.idgnr.impl.EgovTableIdGnrService"
	destroy-method="destroy">
	<property name="dataSource" ref="dataSource" />
	<property name="blockSize" 	value="10"/>
	<property name="table"	   	value="COMTECOPSEQ"/>
	<property name="tableName"	value="GEO_ID"/>
</bean>		

N/A

건물 위치정보에 관한 기본정보를 입력 저장처리한다.

등록: 입력한 건물 위치정보가 저장 처리된다.
목록: 건물 위치정보 목록조회 화면으로 이동한다.

입력명 우측의 빨간* 표시는 수정 시 반드시 입력해야 할 항목을 표시한다.

N/A

입력한 건물 위치정보를 저장 처리한다.

수정: 수정 입력한 건물 위치정보가 저장 처리된다.
목록: 건물 위치정보 목록조회 화면으로 이동한다.

• 실행환경 참조 : ID Generation Service
• 배포 및 테스트 관련 : 모바일 공통컴포넌트란 및 배포 패키지 구성안
• 관련 데이터베이스 구조 및 스키마 : 관련 데이터베이스 구조 및 스키마