SGIS 통계지리정보서비스

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

OpenAPI 1.0

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

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

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

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

WebMap 서비스

센서스공간DB를 이용하여 지도 이미지를 생성하여 제공하는 서비스이다.
기본적인 스키마는 OpenLS의 Presentation 서비스를 준수하며 png 포맷 지도 요청만 가능합니다.

1. 기본정보

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

2. 요청문서

2.1 요청문서 구성

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

<sgisPortrayMapRequest>
	<svcKey>발급키</svcKey>
	<xls:PortrayMapRequest>
		<xls:Output width="640" height="480" format="images/png">
			<xls:BBoxContext>
				<gml:pos>189583.90 441874.18</gml:pos>
				<gml:pos>189590.90 441881.18</gml:pos>
			</xls:BBoxContext>
		</xls:Output>
	</xls:PortrayMapRequest>
</sgisPortrayMapRequest>

요청문서 구성
순번	요소명	설명
1	<svcKey>	통계지리정보서비스에서 발급받은 API이용키
2	<xls:PortrayMapRequest> <xls:Output>	지도의 길이와 넓이 및 이미지 형식을 지정
3	<xls:BBoxContext> <gml:pos>	<gml:pos>를 이용하여 지도에 나타내고자 하는 시작 low 좌표와 high 좌표를 지정

2.2 요청이미지 사이즈 및 이미지 포맷 설정

2.2.1 Output

요청하는 지도의 사이즈 및 이미지 형식을 지정(현재 png 형식만 지원하고 있음) 합니다.

<xls:PortrayMapRequest>
<xls:Output width='640' height='480' format='image/png'>
   ………
   ………
</xls:Output>
</xls:PortrayMapRequest>

2.3 요청좌표 설정

BBoxContext를 이용하여 좌표의 low 및 high 값을 설정 합니다.

<xls:BBoxContext>
	<gml:pos>189583.90 441874.18</gml:pos>
	<gml:pos>189590.90 441881.18</gml:pos>
</xls:BBoxContext>

2.4 요청문서샘플

BBoxContext를 이용하여 사용자가 지역을 설정하여 WebMap 서비스 요청 합니다.

<?xml version="1.0" encoding="utf-8"?>
<SgisPortrayMapRequest xmlns='http://service.gis.knso.org/sgistype' xmlns:xls='http://www.opengis.net/xls' xmlns:gml='http://www.opengis.net/gml'>
	<svcKey>발급키</svcKey>
	<xls:PortrayMapRequest>
		<xls:Output width='640' height='480' format='image/png'>
			<xls:BBoxContext>
				<gml:pos>189583.90 441874.18</gml:pos>
				<gml:pos>189590.90 441881.18</gml:pos>
			</xls:BBoxContext>
		</xls:Output>
	</xls:PortrayMapRequest>
</SgisPortrayMapRequest>

3. 응답문서

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

<?xml version="1.0" encoding="utf-8"?>
<SgisPortrayMapResponse xmlns="http://service.gis.knso.org/sgistype" xmlns:xls="http://www.opengis.net/xls">
<xls:PortrayMapResponse>
    <xls:Map>
      <xls:Content format="image/png" width="640" height="480">
        <xls:URL>http://sgis1.kostat.go.kr/SGisService/data/2011/08/10/20110810104911529008.png</xls:URL>
      </xls:Content>
    </xls:Map>
  </xls:PortrayMapResponse>
</SgisPortrayMapResponse>

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/getportraymap";
		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='utf-8'?>";;	
		 reqXml += "<SgisPortrayMapRequest";  
		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 += " <xls:PortrayMapRequest>";
		reqXml += " <xls:Output width='640' height='480' format='image/png'>";	
                    reqXml += " <xls:BBoxContext>";
		reqXml += " <gml:pos>189583.90 441874.18</gml:pos>";
		reqXml += " <gml:pos>189590.90 441881.18</gml:pos>";
                    reqXml += "</xls:BBoxContext>";
		reqXml += " </xls:Output>";	
		reqXml += " </xls:PortrayMapRequest>";
		reqXml += " </SgisPortrayMapRequest>";	
//요청문서 작성 끝

	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/getportraymap";
//요청문서 작성 시작
		var xml = "<?xml version='1.0' encoding='utf-8'?>";
		   xml += "<SgisPortrayMapRequest";  
		   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>발급키 </svcKey>";
		   xml += " <xls:PortrayMapRequest>";
		   xml += " <xls:Output width='640' height='480' format='image/png'>";	
                       xml += " <xls:BBoxContext>";
		   xml += " <gml:pos>189583.90 441874.18</gml:pos>";
		   xml += " <gml:pos>189590.90 441881.18</gml:pos>";
                       xml += "</xls:BBoxContext>";
		   xml += " </xls:Output>";	
		   xml += " </xls:PortrayMapRequest>";
		   xml += " </SgisPortrayMapRequest>";	
//요청문서 작성 끝
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>