SGIS 통계지리정보서비스

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

OpenAPI 1.0

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

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

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

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

집계구 기반 공간통계 서비스

통계지리정보서비스가 제공하는 각종 공간 통계 정보의 분류항목 및 통계항목에 대한 검색API에 전달되는 요청문서의 구성을 통해 집계구 기반 공간통계을 조회합니다.

1. 기본정보

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

2. 요청문서

2.1 요청문서 구성

공간통계 요청 문서는 인증키, 영역, 통계항목, 응답형식으로 구성됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<SgisStaticsRequest>
	<svcKey>API발급키</svcKey>
	<StaticsRequest>
		<ReqRegionInfo>
			<Region regionid="region_1">
				<gml:Envelope>
					<gml:pos>236998.80784611683 314810.4218812939</gml:pos>
					<gml:pos>238221.19215388317 315629.5781187061</gml:pos>
				</gml:Envelope>
			</Region>
		</ReqRegionInfo>
		<ReqStatItemInfo>
			<MartStatItem itemId="item_1" itemName="">
				<baseYear>2005</baseYear>
				<itemFieldName>to_in_001</itemFieldName>
			</MartStatItem>
		</ReqStatItemInfo>
		<StaticsOutput targetSrs="LL_W" outputEormat="KML" outputUbit="OA">
	</StaticsRequest>
</SgisStaticsRequest>

요청문서 구성
순번	요소명	설명
1	<svcKey>	통계지리정보서비스에서 발급받은 API이용키
2	<ReqRegionInfo>	지리적 공간통계 조회 대상 영역 Bounding Box, Center Point & Radius, Polygon, 행정경계코드 중 선택하여 지정 합니다.
3	<ReqStatItemInfo>	집계구 기반 제공 공간통계 항목 설정
4	<StaticsOutput>	응답포맷 및 집계구 인코딩을 위한 좌표체계 지정

2.2 요청영역설정

2.2.1 Bounding Box

Minx, MinY, maxX, maxY의 지리적 좌표를 입력하고 해당 영역과 겹치는 집계구의 통계정보를 검색 합니다.

<ReqRegionInfo>
	<Region regionid="region_1">
		<gml:Envelope>
			<gml:pos>236998.80784611683 314810.4218812939</gml:pos>
			<gml:pos>238221.19215388317 315629.5781187061</gml:pos>
		</gml:Envelope>			
	</Region>
</ReqRegionInfo>

2.2.2 CircleByCenterPoint

지리적 중심 좌표 및 반지름을 입력하여 해당 영역과 겹치는 집계구의 통계정보를 검색 합니다.

<ReqRegionInfo>
	<Region regionid="region_1">
		<gml:CircleByCenterPoint>
			<gml:pos>236998.80784611683 314810.4218812939</gml:pos>
			<gml:radius>500</gml:radius>
		</gml:CircleByCenterPoint>
	</Region>
</ReqRegionInfo>

2.2.3 Polygon

임의의 다각형을 구성하는 지리적 좌표 목록을 입력하여 해당 영역과 겹치는 집계구의 통계정보를 검색 합니다.

<gml:Polygon>
	<gml:exterior>
		<gml:LinearRing>
			<gml:pos>236998 314810</gml:pos>
			<gml:pos>238221 314810</gml:pos>
			<gml:pos>238221 315629</gml:pos>
			<gml:pos>236998 314810</gml:pos>
		</gml:LinearRing>
	</gml:exterior>
</gml:Polygon>

2.3 통계 항목 설정

집계구 기반 제공 항목 검색 서비스를 통해 검색된 항목 아이디 중 통계를 조회를 원하는 항목을<itemFieldName>에 설정하며 기준년도<baseyear>는 인구,가구,주택은 2000년과 2005년만 제공되고 사업체는 2000년부터 2009년까지만 제공됩니다.

<ReqStatItemInfo>
	<MartStatItem itemId="item_1" itemName="">
		<baseYear>2005</baseYear>
		<itemFieldName>to_in_001</itemFieldName>
	</MartStatItem>		
</ReqStatItemInfo>

2.4 응답 형식 지정

“<StaticsOutput>” 요소를 구성하는 속성에 원하는 정보 인코딩 형식을 지정합니다.

<SgisStaticsRequest>
	<StaticsRequest>
	     .......
		<StaticsOutput targetSrs="LL_W" outputEormat="KML" outputUbit="OA">
	</StaticsRequest>
</SgisStaticsRequest>

위 예제는 KML 형식을 준수하여 통계정의문서를 생성하고 이 때 사용하는 좌표계는 “WGS84” 경위도 좌표계를 사용하여 지형형상을 인코딩하라는 의미입니다. 아래 표는 각 속성에 적용될 수 있는 값을 설명합니다.

요청문서 구성
순번	요소명	설명
targetSrs	LL_B	BESSEL 타원체 경위도 좌표
	LL_W	WGS84 타원체 경위도 좌표
	TM_M	TM 중부원점
	TM_W	TM 서부원점
	TM_W	TM 동부원점
	TM_K	UTM-K 형식
	UTM_52	UTM52N 좌푯
targetSrs	KML	KML 형식 정보 인코딩
targetSrs	KML	GML 형식 정보 인코딩
targetSrs	OA	요청영역과 겹치는 소지역 집계구 기반 정보 인코딩
targetSrs	DONG	요청영역과 겹치는 읍면동 기반 정보 인코딩

2.5 요청문서샘플

2.5.1 Bounding Box에 집계구 기반 공간통계 검색

<SgisStaticsRequest xmlns="http://service.gis.knso.org/sgistype" xmlns:xls="http://www.opengis.net/xls" xmlns:gml="http://www.opengis.net/gml">
	<svcKey>API발급키</svcKey>
	<StaticsRequest>
		<ReqRegionInfo>
			<Region regionid="region_1">
				<gml:Envelope>
					<gml:pos>236998.80784611683 314810.4218812939</gml:pos>
					<gml:pos>238221.19215388317 315629.5781187061</gml:pos>
				</gml:Envelope>
			</Region>
		</ReqRegionInfo>
		<ReqStatItemInfo>
			<MartStatItem itemId="item_1" itemName="">
				<baseYear>2005</baseYear>
				<itemFieldName>to_in_001</itemFieldName>
			</MartStatItem>			
		</ReqStatItemInfo>
		<StaticsOutput targetSrs="LL_W" outputFormat="KML" outputUnit="OA"/>
	</StaticsRequest>
</SgisStaticsRequest>

3. 응답문서

요청문서에 지정된 응답형식에 따라 인코딩 된 문서를 가리키는 URL을 포함하는 응답문서가 반환됩니다. 사용자는 URL에 접근함으로써 공간통계정의문서를 이용합니다.

<?xml version="1.0" encoding="euc-kr"?>
<SgisStaticsResponse xmlns="http://service.gis.knso.org/sgistype">
	<StaticsResponse outputFormat="KML" outputUnit="OA">
		<URL>http://211.34.86.118/SGisService/data/2011/08/09/20110809145444909638.kml</URL>
	</StaticsResponse>
</SgisStaticsResponse>

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/getstaticsxml";
		StringBuffer responseXml = new StringBuffer();

		try {
			/**
			 *
			 */
			//String reqData = URLEncoder.encode(requestXml, "UTF-8");
			
			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='UTF-8'?>";
		 reqXml += "<SgisStaticsRequest  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 += "<StaticsRequest>";
		 reqXml += "<ReqRegionInfo>";
reqXml += "<Region regionid = 'region_1'>";
		 reqXml +="<gml:Envelope>";
reqXml += "<gml:pos>236998.80784611683 314810.4218812939</gml:pos>";
reqXml +="<gml:pos>238221.19215388317 315629.5781187061</gml:pos>";
reqXml += "</gml:Envelope>";
		 reqXml +="</Region>";
reqXml += "</ReqRegionInfo>";
		 reqXml += "<ReqStatItemInfo>";
reqXml += "<MartStatItem itemId = 'item_1' itemName=''>";
reqXml += "<baseYear>2005</baseYear>";
reqXml += "<itemFieldName>to_in_001</itemFieldName>";
reqXml += "</MartStatItem>";
reqXml += "<MartStatItem itemId = 'item_2' itemName=''>";
reqXml += "<baseYear>2005</baseYear>";
reqXml += "<itemFieldName>to_in_002</itemFieldName>";
reqXml += "</MartStatItem>";
reqXml += "</ReqStatItemInfo>";
		 reqXml += "<StaticsOutput targetSrs='LL_W' outputFormat='KML' outputUnit='OA'/>";
		 reqXml +="</StaticsRequest>";
reqXml += "</SgisStaticsRequest>";
//요청문서 작성 끝
		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/getstaticsxml";
                        //요청문서 작성 시작
		  var xml= "<?xml version='1.0' encoding='UTF-8'?>";
		 xml += "<SgisStaticsRequest  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 += "<StaticsRequest>";
		 xml += "<ReqRegionInfo>";
xml += "<Region regionid = 'region_1'>";
		 xml +="<gml:Envelope>";
xml += "<gml:pos>236998.80784611683 314810.4218812939</gml:pos>";
xml +="<gml:pos>238221.19215388317 315629.5781187061</gml:pos>";
xml += "</gml:Envelope>";
		 xml +="</Region>";
xml += "</ReqRegionInfo>";
		 xml += "<ReqStatItemInfo>";
xml += "<MartStatItem itemId = 'item_1' itemName=''>";
xml += "<baseYear>2005</baseYear>";
xml += "<itemFieldName>to_in_001</itemFieldName>";
xml += "</MartStatItem>";
xml += "<MartStatItem itemId = 'item_2' itemName=''>";
xml += "<baseYear>2005</baseYear>";
xml += "<itemFieldName>to_in_002</itemFieldName>";
xml += "</MartStatItem>";
xml += "</ReqStatItemInfo>";
		 xml += "<StaticsOutput targetSrs='LL_W' outputFormat='KML' outputUnit='OA'/>";
		 xml +="</StaticsRequest>";
xml += "</SgisStaticsRequest>";                       
//요청문서 작성 끝
		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>