SGIS 통계지리정보서비스

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

OpenAPI 1.0

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

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

MapControl/Overlay서비스 좌표 변환 서비스 WebMap 서비스 Geocoder서비스 Reverse Geocoder서비스

집계구 기반 제공 항목 검색 서비스 원시명부항목검색서비스 집계구 기반 공간통계서비스

Reverse Geocoder 서비스

Reverse Geocode 서비스는 건물정보에 있는 지번 및 도로명/건물번호 등으로 구성된 새주소정보를 이용하여 위치정보를 주소정보로 변환해 주는 서비스입니다.

1. 기본정보

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

2. 요청문서

2.1 요청문서 구성

공간통계 요청 문서는 인증키, 위치정보로 이루어져 있습니다.

2.1.1. 구주소(지번) 요청문서 구성

<?xml version="1.0" encoding="UTF-8"?>
<SgisReverseGeocodeRequest>
	<svcKey>API발급키</svcKey>
	<xls:ReverseGeocodeRequest>
		<xls:Position>
			<gml:Point>
				<gml:pos>234271 318191</gml:pos>
			</gml:Point>
		</xls:Position>
		<xls:ReverseGeocodePreference">ParcelAddress</xls:ReverseGeocodePreference>
	</xls:ReverseGeocodeRequest>
</SgisReverseGeocodeRequest>

요청문서 구성
순번	요소명	설명
1	<svcKey>	통계지리정보서비스에서 발급받은 API이용키
2	<xls:Position> <gml:Point> <gml:pos>	찾고자 하는 위치 정보를 지정
3	<xls:ReverseGeocodePreference>	구주소(지번)와 신주소(도로명) 요청문서의 구분 값

2.2 요청주소설정

2.2.1. 구주소(지번)

<gml:pos>항목에 위치정보를 지정하며 구조소(지번) 요청문서임을 표시하기 위해 <xls:ReverseGeocodePreference>에 ParcelAddres를 지정합니다.

<xls:ReverseGeocodeRequest>
	<xls:Position>
		<gml:Point>
			<gml:pos>234271 318191</gml:pos>
		</gml:Point>
	</xls:Position>
	<xls:ReverseGeocodePreference>ParcelAddress</xls:ReverseGeocodePreference>
</xls:ReverseGeocodeRequest>

2.2.2 새주소(도로명)

<gml:pos>항목에 위치정보를 지정하며 새주소(도로명) 요청문서임을 표시하기 위해 <xls:ReverseGeocodePreference>에 항목을 삭제합니다.

<xls:ReverseGeocodeRequest>
	<xls:Position>
		<gml:Point>
			<gml:pos>234271 318191</gml:pos>
		</gml:Point>
	</xls:Position>
</xls:ReverseGeocodeRequest>

2.3 요청문서샘플

2.3.1 구주소

<gml:pos>항목에 알고자 하는 중심좌표를 입력하고 다음과 같이 작성합니다.

<?xml version="1.0" encoding="UTF-8"?>
<SgisReverseGeocodeRequest xmlns="http://service.gis.knso.org/sgistype" xmlns:xls="http://www.opengis.net/xls" xmlns:gml="http://www.opengis.net/gml">
	<svcKey> api발급키입력 </svcKey>
	<xls:ReverseGeocodeRequest>
		<xls:Position>
			<gml:Point>
				<gml:pos>234271 318191</gml:pos>
			</gml:Point>
		</xls:Position>
		<xls:ReverseGeocodePreference>ParcelAddress</xls:ReverseGeocodePreference>
	</xls:ReverseGeocodeRequest>
</SgisReverseGeocodeRequest>

2.3.2 신주소

<gml:pos>항목에 알고자 하는 중심좌표를 입력하고 다음과 같이 작성합니다.

<?xml version="1.0" encoding="UTF-8"?>
<SgisReverseGeocodeRequest xmlns="http://service.gis.knso.org/sgistype" xmlns:xls="http://www.opengis.net/xls" xmlns:gml="http://www.opengis.net/gml">
	<svcKey> api발급키입력 </svcKey>
	<xls:ReverseGeocodeRequest>
		<xls:Position>
			<gml:Point>
				<gml:pos>189583.90 441874.18</gml:pos>
			</gml:Point>
		</xls:Position>
	</xls:ReverseGeocodeRequest>
</SgisReverseGeocodeRequest>

3. 응답문서

입력된 위치정보가 주소로 응답됩니다.

3.1. 구주소(지번) 응답문서

구주소(지번)의 요청 문서에 대한 응답 문서는 다음과 같습니다.
<gml:pos>에는 구주소(지번)의 중심좌표가 있으며 <xls:freeFormAddress>에는 요청한 중심좌표의 주소가 있습니다.

<?xml version="1.0" encoding="UTF-8"?>
<SgisReverseGeocodeResponse xmlns="http://service.gis.knso.org/sgistype" xmlns:xls="http://www.opengis.net/xls" xmlns:gml="http://www.opengis.net/gml">
	<xls:ReverseGeocodeResponse>
		<xls:ReverseGeocodedLocation>
			<gml:Point>
				<gml:pos>234271.51750000002 318191.63999999996</gml:pos>
			</gml:Point>
			<xls:Address>
				<xls:freeFormAddress>대전광역시 서구 둔산동 920</xls:freeFormAddress>
			</xls:Address>
		</xls:ReverseGeocodedLocation>
	</xls:ReverseGeocodeResponse>
</SgisReverseGeocodeResponse>

3.2 신주소(도로명) 응답문서

신주소(도로명)의 요청 문서에 대한 응답 문서는 다음과 같습니다.
<gml:pos>에는 신주소(지번)의 중심좌표가 있으며 <xls:freeFormAddress>에는 요청한 중심좌표의 주소가 있습니다.

<?xml version='1.0' encoding='euc-kr'?>
<SgisReverseGeocodeResponse xmlns="http://service.gis.knso.org/sgistype" xmlns:xls="http://www.opengis.net/xls" xmlns:gml="http://www.opengis.net/gml">
  <xls:ReverseGeocodeResponse>
    <xls:ReverseGeocodedLocation>
      <gml:Point>
        <gml:pos>189571.02608749992 441913.2371624997</gml:pos>
      </gml:Point>
      <xls:Address>
        <xls:freeFormAddress>서울특별시 금천구 가산디지털1로 168</xls:freeFormAddress>
      </xls:Address>
    </xls:ReverseGeocodedLocation>
  </xls:ReverseGeocodeResponse>
</SgisReverseGeocodeResponse>

4. API 이용샘플

4.1 JAVA

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

package test.testapis;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStreamWriter;
import java.net.MalformedURLException;
import java.net.URLConnection;
import java.net.URLEncoder;

import java.net.URL;

public class StaticsXml {

	public String sgisApiStaticsXml(String requestXml) {
		final String apiurl = "http://sgis1.kostat.go.kr/SGisService/reversegeocoder";
		StringBuffer responseXml = new StringBuffer();

		try {
			URL url = new URL(apiurl);
			URLConnection conn = url.openConnection();
			conn.setDoOutput(true);

			OutputStreamWriter owr = new OutputStreamWriter(conn
					.getOutputStream());
			owr.write(requestXml);
			owr.flush();

			InputStream is = conn.getInputStream();
			BufferedReader br = new BufferedReader(new InputStreamReader(is));

			String line;
			while ((line = br.readLine()) != null) {
				responseXml.append(line);
			}

		} catch (MalformedURLException me) {
			//2015-12-03 시큐어코딩
			//e.printStackTrace();
			logger.info("서버에서 처리중 에러가 발생했습니다.:"+me);

		} catch (IOException ioe) {
			//2015-12-03 시큐어코딩
			//e.printStackTrace();
			logger.info("서버에서 처리중 에러가 발생했습니다.:"+ioe);

		}
		return responseXml.toString();
	}

	public static void main(String[] args) throws Exception {
StaticsXml api = new StaticsXml();
//요청문서 작성 시작
		final String reqXml = "<?xml version='1.0' encoding='EUC-KR'?>";
                      reqXml += "<SgisReverseGeocodeRequest xmlns='http://service.gis.knso.org/sgistype' ";
                      reqXml += " xmlns:xls=http://www.opengis.net/xls xmlns:gml='http://www.opengis.net/gml'>";
	                  reqXml += "<svcKey>api발급키</svcKey>";
	                  reqXml += "<xls:ReverseGeocodeRequest>";
                      reqXml += "<xls:Position>";
	                  reqXml += "<gml:Point>";
	                  reqXml += "<gml:pos>234271 318191</gml:pos>";
	                  reqXml += "</gml:Point>";
	                  reqXml += "<xls:Building number='110'/>";
	                  reqXml += "</xls:Position>";
	                  reqXml += "<xls:ReverseGeocodePreference>ParcelAddress</xls:ReverseGeocodePreference>";
	                  reqXml += "</xls:ReverseGeocodeRequest>";
                      reqXml += "</SgisReverseGeocodeRequest>";	
           //요청문서 작성 끝		
		String response = api.sgisApiStaticsXml(reqXml);
		System.out.println(response);	}

}

4.2 Javascript

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <title> New Document </title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <script type="text/javascript">
	function aaaaopen(){
		var url = "http://sgis1.kostat.go.kr/SGisService/reversegeocoder";
		//요청문서 작성 시작
		var    xml= "<?xml version='1.0' encoding='EUC-KR'?>";
                         xml += "<SgisReverseGeocodeRequest xmlns='http://service.gis.knso.org/sgistype' ";
 xml += " xmlns:xls='http://www.opengis.net/xls' xmlns:gml='http://www.opengis.net/gml'>";
	 xml += "<svcKey>api발급키</svcKey>";
	 xml += "<xls:ReverseGeocodeRequest>";
                        xml += "<xls:Position>";
	 xml += "<gml:Point>";
	 xml += "<gml:pos>234271 318191</gml:pos>";
	                    xml += "</gml:Point>;
	                     xml += "<xls:Building number='110'/>";
	 xml += "</xls:Position>";
	 xml += "<xls:ReverseGeocodePreference>ParcelAddress</xls:ReverseGeocodePreference>";
	                 xml += "</xls:ReverseGeocodeRequest>";
                    xml += "</SgisReverseGeocodeRequest>";	
                   //요청문서 작성 끝				
var req = new ActiveXObject("Microsoft.XMLHTTP");
		req.open("POST", url, false);
		req.setRequestHeader("Content-type","text/plain");
		req.send(xml);
		if(req.status == 200)
		alert(req.responseText);
		else
		alert("error");
		
	}
  </script>
 </head>
 <body>
  <form name="f_submit">  
   <input type="button" name="btnsubmit" id="submit" value="전송" onclick="javascript:aaaaopen();"/>
  </form>
 </body>
</html>