OpenAPI 1.0 < OpenAPI < 공유마당 < 처음페이지

OpenAPI 1.0

S-OpenAPI 1.0의 내용은 다음과 같습니다.

※ S-OpenAPI 1.0은 2013년 12월 말 서비스 종료 되었습니다.

좌표변환 서비스

좌표 변환 서비스는 GIS의 각종 좌표체계의 원하는 좌표체계의 좌표로 변환해 주는 서비스로 상이한 좌표체계를 가진 Map API와 매쉬업을 위한 필수적인 API입니다.

1. 기본정보

센서스 공간통계 자료 신청.
Request URL http://sgis1.kostat.go.kr/SGisService/coordconversion
호출방법 HTTP POST
검색결과포맷 XML

2. 요청문서

2.1 요청문서 구성

좌표변환 요청 문서는 인증키, source좌표 체계와 변환 좌표체계를 표현하는 설정 부분 그리고 영역으로 구성됩니다.

요청문서 구성
순번 요소명 설명
1 <svcKey> 통계지리정보서비스에서 발급받은 API이용키
2 <CoordConversionRequest>
<coordConvserionInfo>
Source좌표 체계와 변환될 좌표체계 표현
3 <CoordConversionRequest>
<gml:pos>
변환할 좌표.
pos, coord, coordinates 중 선택하여 구성.
pos, coord, coordinates의 구성은 GML의 정의 준수.
2.2 변환될 좌표체계 설정

“<coordConvserionInfo>” 요소를 구성하는 속성에 source좌표 체계 형식과 변환할 좌표체계 형식을 지정합니다.
<CoordConvserionInfo fromSrs="TM_M" toSrs="TM_K"/>
위 예제는 “TM_M”(TM 중부원점)좌표 계를 “TM_K”(UTM-K 형식)좌표 계로 변환하라는 의미입니다. 아래의 표는 각 속성에 적용될 수 있는 값을 설명합니다.

변환될 좌표체계 설정
속성명 요소명 설명
BESSEL 타원체 경위도 좌표 LL_B BESSEL 타원체 경위도 좌표
LL_W WGS84 타원체 경위도 좌표
TM_M TM 중부원점
TM_W TM 서부원점
TM_E TM 동부원점
TM_K UTM-K 형식
UTM_52 UTM52N 좌표
toSrs LL_B BESSEL 타원체 경위도 좌표
LL_W WGS84 타원체 경위도 좌표
TM_M TM 중부원점
TM_W TM 서부원점
TM_E TM 동부원점
TM_K UTM-K 형식
UTM_52 UTM52N 좌표
2.3 변환할 좌표 설정
2.3.1 pos Element 이용

하나의 “<gml:pos>” element는 하나의 좌표 X, Y를 ‘ ’(공백문자)를 이용해 나누어 표시합니다.
<gml:pos>236710 315220</gml:pos>

2.3.2 coord Element 이용

하나의 “<gml:coord>” element는 하나의 좌표 X, Y를 “<gml:X>”, “<gml:Y>”를 이용해 표시합니다.

2.3.3 coordinates Element 이용

하나의 “<gml:coordinates>” element는 여러 개의 좌표를 속성 cs, ts를 이용해 구분하여 표시합니다. <gml:coordinates cs="," ts=" "> 127.40969565,36.337086910 127.4117231258,36.34140560311 127.40181879,36.34324141</gml:coordinates>

2.4 요청문서샘플
2.4.1 pos Element를 이용한 TM_M(TM 중부원점)에서 TM_K(UTM-k 형식)으로 좌표 변환
2.4.2 coord Element를 이용한 TM_M(TM 중부원점)에서 LL_W(WGS84 타원체 경위도 좌표)로 좌표 변환
2.4.3 coordinates Element를 이용한 LL_W(WGS84 타원체 경위도 좌표) 에서 TM_M(TM 중부원점)으로 좌표 변환

3. 응답문서

요청문서에 사용된 좌표 표시 형식에 따라 같은 형식으로 표시된 응답문서가 반환됩니다.

3.1 응답문서샘플
3.1.1 pos Element를 이용한 요청의 응답
3.1.2 coord Element를 이용한 요청의 응답.
3.1.3 coordinates Element를 이용한 요청의 응답.

4. API 이용샘플

4.1 JAVA

크로스 도메인 해결을 위한 서버코드 작성을 위한 자바 샘플 코드 입니다.

4.2 Javascript

AJAX 를 적용하여 통계 조회 어플리케이션 작성을 위한 샘플 코드 입니다.

예제실행하기