SGIS 통계지리정보서비스

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

OpenAPI 1.0

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

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

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

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

Geocoder서비스

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

1. 기본정보

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

2. 요청문서

2.1 요청문서 구성

공간통계 요청 문서는 인증키, 새주소(도로명), 구주소(지번)로 구성됩니다

2.1 요청문서 구성

<?xml version="1.0" encoding="UTF-8"?>
<SgisGeocodeRequest>
	<svcKey>api발급키</svcKey>
	<xls:GeocodeRequest>
		<xls:Address>
			<xls:Place type="SigunguName">금천구</xls:Place>
			<xls:Place type="LawDongName">가산동</xls:Place>
			<xls:ParcelAddress">371-28</xls:ParcelAddress>
		</xls:Address>
	</xls:GeocodeRequest>
</SgisGeocodeRequest>

요청문서 구성
순번	요소명	설명
1	<svcKey>	통계지리정보서비스에서 발급받은 API이용키
2	<GeocodeRequestt> <Address>	<Place>, <ParcelAddress>로 구성되어 있으며 <Place>의 type 속성 에는 “SidoName“, “SigunguName” , “LawDongName”이 있으며 각각 시도, 시군구, 읍면동 명칭이 들어가며 선택적으로 사용할 수 있습니다. <ParcelAddress>에는 찾고자 하는 지번을 지정 할 수 있으면 필수 사항입니다.

2.1.2. 새주소(도로명) 요청문서 구청

<?xml version="1.0" encoding="UTF-8"?>
<SgisGeocodeRequest>
	<svcKey>api발급키</svcKey>
	<xls:GeocodeRequest>
		<xls:Address>
			<xls:Place type="SigunguName">서구</xls:Place>
			<xls:StreetAddress>
				<xls:Street offcialName="양천로">
				<xls:Building number="110">
			</xls:StreetAddress>
		</xls:Address>
	</xls:GeocodeRequest>
</SgisGeocodeRequest>

요청문서 구성
순번	요소명	설명
1	<svcKey>	통계지리정보서비스에서 발급받은 API이용키
2	<GeocodeRequestt> <Address>	<Place>, < StreetAddress>로 구성되어 있으며 <Place>의 type 속성 에는 “SidoName“, “SigunguName” , “LawDongName”이 있으며 각각 시도, 시군구, 읍면동 명칭이 들어가며 선택적으로 사용할 수 있습니다. <StreetAddress>는 하위 항목으로 <street>와 <Buiding>으로 나눠져 있으며 <street>의 “officialName에는 도로명을 <Building>의 number에는 건물번호가 들어갑니다.

2.3 요청좌표 설정

2.2.1 구주소(지번)

<Place>의 type에는 “SidoName”, “SigunguName”, ”LawDongName”이 있으면 각각 시도, 시군구,읍면동 명칭이 들어가며 선택적으로 사용할 수 있으며 <ParcelAddress>는 필수사항이며 찾고자 하는 지번으로 설정하시면 됩니다.

<xls:GeocodeRequest>
	<xls:Address>
		<xls:Place type="LawDongName">가산동</xls:Place>
		<xls:ParcelAddress>371-28</xls:ParcelAddress>
	</xls:Address>
</xls:GeocodeRequest>

2.2.2. 새주소(도로명)

<Place>의 type 속성에는 “SidoName“, “SigunguName”이 있으며 각각 시도, 시군구 명칭이 들어가며 선택적으로 사용할 수 있으며, 필수 항목인 <Street>의속성 officialName는 도로명, <Building>의 속성인 number 일 경우 건물주소를 입력하면 됩니다.

<xls:GeocodeRequest>
	<xls:Address>
		<xls:Place type="SigunguName">서구</xls:Place> 
		<xls:StreetAddress>
			<xls:Street officialName="양천로"/>
			<xls:Building number="110"/>
		</xls:StreetAddress>
	</xls:Address>
</xls:GeocodeRequest>

2.3 요청문서샘플

2.3.1 구주소(지번)

<?xml version="1.0" encoding="UTF-8"?>
<SgisGeocodeRequest 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:GeocodeRequest>
		<xls:Address>
			<xls:Place type="LawDongName">가산동</xls:Place>
			<xls:ParcelAddress>371-28</xls:ParcelAddress>
		</xls:Address>
	</xls:GeocodeRequest>
</SgisGeocodeRequest>

2.3.2 새주소(도로명)

찾고자 하는 새주소의 도로명과 건물번호 및 해당 시군구 지역을 알 경우 다음과 같이 작성을 하시면됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<SgisGeocodeRequest 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:GeocodeRequest>
		<xls:Address>
			<xls:Place type="SigunguName">강서구</xls:Place> 
			<xls:StreetAddress>
				<xls:Street officialName="양천로"/>
				<xls:Building number="110"/>
			</xls:StreetAddress>
		</xls:Address>
	</xls:GeocodeRequest>
</SgisGeocodeRequest>

3. 응답문서

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

3.1. 구주소(지번)

<GeocodeResponseList>의 리스트로 반환되며 <gml:pos>에는 해당되는 주소지의 중심좌표 값이 <xls:freeFormAddress>는 구주소 값이 지정되어 반환됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<SgisGeocodeResponse xmlns="http://service.gis.knso.org/sgistype" xmlns:xls="http://www.opengis.net/xls" xmlns:gml="http://www.opengis.net/gml">
	<xls:GeocodeResponse>
		<xls:GeocodeResponseList>
			<xls:GeocodedAddress>
				<gml:Point>
					<gml:pos>189542.696363691 441980.2291124032</gml:pos>
				</gml:Point>
				<xls:Address>
					<xls:freeFormAddress>서울특별시 금천구 가산동 371-28</xls:freeFormAddress>
				</xls:Address>
			</xls:GeocodedAddress>
		</xls:GeocodeResponseList>
	</xls:GeocodeResponse>
</SgisGeocodeResponse>

3.2. 새주소(도로명)

<GeocodeResponseList>의 리스트로 반환되며 <gml:pos>에는 해당되는 주소지의 중심좌표 값이 <xls:freeFormAddress>는 새주소 값이 지정되어 반환됩니다.

<?xml version='1.0' encoding='euc-kr'?>
<SgisGeocodeResponse xmlns="http://service.gis.knso.org/sgistype" xmlns:xls="http://www.opengis.net/xls" xmlns:gml="http://www.opengis.net/gml">
  <xls:GeocodeResponse>
    <xls:GeocodeResponseList>
      <xls:GeocodedAddress>
        <gml:Point>
          <gml:pos>183110.27615000005 452482.9428000001</gml:pos>
        </gml:Point>
        <xls:Address>
          <xls:freeFormAddress>서울특별시 강서구 양천로1길 110</xls:freeFormAddress>
        </xls:Address>
      </xls:GeocodedAddress>
    </xls:GeocodeResponseList>
  </xls:GeocodeResponse>
</SgisGeocodeResponse>

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/geocoder";
		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 += "<SgisGeocodeRequest 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:GeocodeRequest>";
                    reqXml += "<xls:Address>";
	                reqXml += "<xls:Place type='SigunguName'>강서구</xls:Place>";
	                reqXml += "<xls:StreetAddress>";
	                reqXml += "<xls:Street officialName='양천로'/>;
	                reqXml += "<xls:Building number='110'/>;
	               reqXml += "</xls:StreetAddress>";
	               reqXml += "</xls:Address>";
	               reqXml += "</xls:GeocodeRequest>";
 reqXml += "</SgisGeocodeRequest>”;
//요청문서 작성 끝		
	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/geocoder";
		//요청문서 작성 시작
		var xml= "<?xml version='1.0' encoding='EUC-KR'?>";
                 xml += "<SgisGeocodeRequest 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:GeocodeRequest>";
                 xml += "<xls:Address>";
	 xml += "<xls:Place type='SigunguName'>강서구</xls:Place>";
	 xml += "<xls:StreetAddress>";
	 xml += "<xls:Street officialName='양천로'/>;
	 xml += "<xls:Building number='110'/>;
	             xml += "</xls:StreetAddress>";
	             xml += "</xls:Address>";
	             xml += "</xls:GeocodeRequest>";
xml += "</SgisGeocodeRequest>";
//요청문서 작성 끝			
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>