SGIS 통계지리정보서비스

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

OpenAPI 1.0

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

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

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

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

집계구 기반 제공 항목 검색 서비스

통계지리정보서비스에서 집계구 기반 단위로 제공되어지는 통계항목을 검색을 제공하는 서비스입니다.

1. 기본정보

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

2. 요청문서

2.1 요청문서 구성

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

<SgisClassifyItemRequest>
 <svcKey>API발급키</svcKey>
    <ClassifyItemRequest>
         <searchItemName>남자</searchItemName>
    </ClassifyItemRequest>
 </SgisClassifyItemRequest>

요청문서 구성
순번	요소명	설명
1	<svcKey>	통계지리정보서비스에서 발급받은 API이용키
2	<ClassifyItemRequest> <searchItemNamet;	검색어 지정

2.2 통계 항목 설정

검색하고자 하는 통계항목을 아래와 같이 작성하면 됩니다.

<ClassifyItemRequest >
		<searchItemName>검색하고자 하는내용</searchItemName>
</ClassifyItemRequest >

2.3 요청문서샘플

<?xml version="1.0" encoding="euc-kr"?>
<SgisClassifyItemRequest xmlns="http://service.gis.knso.org/sgistype" xmlns:xls="http://www.opengis.net/xls" xmlns:gml="http://www.opengis.net/gml">
	<svcKey>api발급키</svcKey>
	<ClassifyItemRequest >
		<searchItemName>남자</searchItemName>
	 </ClassifyItemRequest >
</ SgisClassifyItemRequest >

3. 응답문서

응답문서은 itemName, itemid, itemValueKind로 구성 되어 있습니다.

<?xml version="1.0" encoding="euc-kr"?>
<SgisClassifyItemResponse xmlns="http://service.gis.knso.org/sgistype">
	<StatClassifyItem>
		<itemNmae>10세이상 ~ 14세이하_남자</itemName>
<itemId>in_age_017 </itemId>
<itemValueKind>INT</ itemValueKind >
	</ StatClassifyItem >
<StatClassifyItem>
		<itemNmae>15세이상 ~ 19세이하_남자</itemName>
<itemId> in_age_018</itemId>
<itemValueKind>INT </ itemValueKind >
	</ StatClassifyItem >
………
……….
………
   <StatClassifyItem>
		<itemNmae>이혼_남자</itemName>
<itemId> in_wed_004</itemId>
<itemValueKind>INT </ itemValueKind >
	</ StatClassifyItem >
</ SgisClassifyItemResponse >

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/getclassifyitem";
		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  += "<SgisClassifyItemRequest";  
reqXml  += "  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  += " <ClassifyItemRequest>";
		 reqXml  += " <searchItemName>남자</searchItemName>";	
                     reqXml  += " </ClassifyItemRequest>";
		 reqXml += " </SgisClassifyItemRequest>";
        //요청문서 작성 끝
		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/getclassifyitem";  
//요청문서 작성 시작   
		var xml = "<?xml version='1.0' encoding='euc-kr'?>";
		    xml += "<SgisClassifyItemRequest";  
		    xml += " 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 += " <ClassifyItemRequest>";
		    xml += " <searchItemName>남자</searchItemName>";	
                        xml += " </ClassifyItemRequest>";
		    xml += " </SgisClassifyItemRequest>";	
                   //요청문서 작성 끝	
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>