좌표제공 API | 도로명주소 개발자센터

좌표 팝업 API

좌표 팝업 API정보
호출방식	요청 URL	출력결과
POST GET	https://www.juso.go.kr/addrlink/addrCoordUrl.do	파라미터

좌표 팝업 API 요청변수
요청변수명	타입	필수여부	설명
confmKey	String	Y	신청시 발급받은 승인키
returnUrl	String	Y	주소 검색 결과를 리턴받을 URL (통합검색창을 호출한 페이지)
resultType	String	N	도로명주소 검색결과 화면 출력유형 1 : 도로명, 2 : 도로명+지번+상세보기(관련지번, 관할주민센터), 3 : 도로명+상세보기(상세건물명), 4 : 도로명+지번+상세보기(관련지번, 관할주민센터, 상세건물명)

좌표 팝업 API 출력결과
출력변수명	타입	필수여부	설명
roadFullAddr	String	Y	전체 도로명주소
roadAddrPart1	String	Y	도로명주소(참고항목 제외)
roadAddrPart2	String	N	도로명주소 참고항목
jibunAddr	String	Y	지번주소
engAddr	String	Y	도로명주소(영문)
zipNo	String	Y	우편번호
addrDetail	String	N	고객 입력 상세 주소
admCd	String	Y	행정구역코드
rnMgtSn	String	Y	도로명코드
bdMgtSn	String	Y	건물관리번호
detBdNmList	String	N	상세건물명
bdNm	String	N	건물명
bdKdcd	String	Y	공동주택여부(1 : 공동주택, 0 : 비공동주택)
siNm	String	Y	시도명
sggNm	String	Y	시군구명
emdNm	String	Y	읍면동명
liNm	String	N	법정리명
rn	String	Y	도로명
udrtYn	String	Y	지하여부(0 : 지상, 1 : 지하)
buldMnnm	Number	Y	건물본번
buldSlno	Number	Y	건물부번
mtYn	String	Y	산여부(0 : 대지, 1 : 산)
lnbrMnnm	Number	Y	지번본번(번지)
lnbrSlno	Number	Y	지번부번(호)
emdNo	String	Y	읍면동일련번호
entX	String	Y	X좌표
entY	String	Y	Y좌표

좌표 팝업 API 오류코드
오류메세지	조치방법
시스템에러	도로명주소 도움센터로 문의하시기 바랍니다.
승인되지 않은 KEY 입니다.	정확한 승인키를 입력하세요.(검색API 승인키 사용불가)
정상적인 경로로 접속하시기 바랍니다.	요청변수 중 returnUrl 항목이 없습니다. 요청변수를 다시 확인하세요.
검색어가 입력되지 않았습니다.	검색어를 입력해주세요.
주소를 상세히 입력해 주시기 바랍니다.	시도명으로는 검색이 불가합니다.
검색어는 두글자 이상 입력되어야 합니다.	한 글자만으로는 검색이 불가합니다.
검색어는 문자와 숫자 같이 입력되어야 합니다.	숫자만으로는 검색이 불가합니다.
검색어가 너무 깁니다. (한글40자, 영문,숫자 80자 이하)	80글자를 초과한 검색어는 검색이 불가합니다.
검색어에 너무 긴 숫자가 포함되어 있습니다. (숫자10자 이하)	10자리를 초과하는 숫자가 포함된 검색어는 검색이 불가합니다.
특수문자+숫자만으로는 검색이 불가능 합니다.	특수문자와 숫자만으로 이루어진 검색어는 검색이 불가합니다.
SQL 예약어 또는 특수문자( %,=,>,<,[,] )는 검색이 불가능 합니다.	SQL예약어 또는 특수문자를 제거 후 검색합니다.
개발승인키 기간이 만료되어 서비스를 이용하실 수 없습니다.	개발승인키를 다시 발급받아 API서비스를 호출합니다.
검색 범위를 초과하였습니다.	검색결과가 9천건이 초과하는 검색은 불가합니다.

가이드 및 소스 다운로드(JSP | ASP | PHP )

주소입력화면 소스보기

						
/*
 파일명 : Sample.jsp
 내  용 : 주소입력화면 (Sample.jsp ↔jusoPopup.jsp ↔ 도로명주소 팝업API )
*/

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script language="javascript">
function goPopup(){
	// 호출된 페이지(jusopopup.jsp)에서 실제 주소검색URL(https://www.juso.go.kr/addrlink/addrCoordUrl.do)를 호출하게 됩니다.
    var pop = window.open("/popup/jusoPopup.jsp","pop","width=570,height=420, scrollbars=yes, resizable=yes"); 
}
function jusoCallBack(roadFullAddr,roadAddrPart1,addrDetail,roadAddrPart2,engAddr, jibunAddr, zipNo, admCd, rnMgtSn, bdMgtSn
						, detBdNmList, bdNm, bdKdcd, siNm, sggNm, emdNm, liNm, rn, udrtYn, buldMnnm, buldSlno, mtYn, lnbrMnnm, lnbrSlno
						, emdNo, entX, entY){
	// 팝업페이지에서 주소입력한 정보를 받아서, 현 페이지에 정보를 등록합니다.
	document.form.roadAddrPart1.value = roadAddrPart1;
	document.form.roadAddrPart2.value = roadAddrPart2;
	document.form.addrDetail.value = addrDetail;
	document.form.zipNo.value = zipNo;
	document.form.entX.value = entX;
	document.form.entY.value = entY;
}
</script>
<title>주소 입력 샘플</title>
</head>
<body>
<form name="form" id="form" method="post">
	<table >
			<colgroup>
				<col style="width:20%"><col>
			</colgroup>
			<tbody>
				<tr>
					<th>우편번호</th>
					<td>
					    <input type="hidden" id="confmKey" name="confmKey" value=""  >
						<input type="text" id="zipNo" name="zipNo" readonly style="width:100px">
						<input type="button"  value="주소검색" onclick="goPopup();">
					</td>
				</tr>
				<tr>
					<th><label>도로명주소</label></th>
					<td><input type="text" id="roadAddrPart1" style="width:85%"></td>
				</tr>
				<tr>
					<th>상세주소</th>
					<td>
						<input type="text" id="addrDetail" style="width:40%" value="">
						<input type="text" id="roadAddrPart2"  style="width:40%" value="">
					</td>
				</tr>
				<tr>
					<th>좌표정보</th>
					<td>
						<input type="text" id="entX" style="width:40%" value="">
						<input type="text" id="entY"  style="width:40%" value="">
					</td>
				</tr>
			</tbody>
		</table>
</form>
</body>
</html>

팝업API 호출 소스보기

						
/*
 파일명 : jusoPopup.jsp
 내  용 : 팝업API 호출 소스(jusoPopup.jsp ↔ 도로명주소 팝업API )
*/
/*
모의 해킹 테스트 시 팝업API를 호출하시면 IP가 차단 될 수 있습니다. 
주소팝업API를 제외하시고 테스트 하시기 바랍니다.
*/
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
<% 
	//request.setCharacterEncoding("UTF-8");  //한글깨지면 주석제거
	//request.setCharacterEncoding("EUC-KR");  //해당시스템의 인코딩타입이 EUC-KR일경우에
	String inputYn = request.getParameter("inputYn"); 
	String roadFullAddr = request.getParameter("roadFullAddr"); 
	String roadAddrPart1 = request.getParameter("roadAddrPart1"); 
	String roadAddrPart2 = request.getParameter("roadAddrPart2"); 
	String engAddr = request.getParameter("engAddr"); 
	String jibunAddr = request.getParameter("jibunAddr"); 
	String zipNo = request.getParameter("zipNo"); 
	String addrDetail = request.getParameter("addrDetail"); 
	String admCd    = request.getParameter("admCd");
	String rnMgtSn = request.getParameter("rnMgtSn");
	String bdMgtSn  = request.getParameter("bdMgtSn");
	String detBdNmList  = request.getParameter("detBdNmList");
	String bdNm  = request.getParameter("bdNm");
	String bdKdcd  = request.getParameter("bdKdcd");
	String siNm  = request.getParameter("siNm");
	String sggNm  = request.getParameter("sggNm");
	String emdNm  = request.getParameter("emdNm");
	String liNm  = request.getParameter("liNm");
	String rn  = request.getParameter("rn");
	String udrtYn  = request.getParameter("udrtYn");
	String buldMnnm  = request.getParameter("buldMnnm");
	String buldSlno  = request.getParameter("buldSlno");
	String mtYn  = request.getParameter("mtYn");
	String lnbrMnnm  = request.getParameter("lnbrMnnm");
	String lnbrSlno  = request.getParameter("lnbrSlno");
	String emdNo  = request.getParameter("emdNo");
	String entX  = request.getParameter("entX");
	String entY  = request.getParameter("entY");
%>
</head>
<script language="javascript">
function init(){
	var url = location.href;
	var confmKey = "TESTJUSOGOKR";//승인키
	var resultType = "4"; // 도로명주소 검색결과 화면 출력유형, 1 : 도로명, 2 : 도로명+지번+상세보기(관련지번, 관할주민센터), 3 : 도로명+상세보기(상세건물명), 4 : 도로명+지번+상세보기(관련지번, 관할주민센터, 상세건물명)
	var inputYn= "<%=inputYn%>";
	if(inputYn != "Y"){
		document.form.confmKey.value = confmKey;
		document.form.returnUrl.value = url;
		document.form.resultType.value = resultType;
		document.form.action="https://www.juso.go.kr/addrlink/addrCoordUrl.do"; // 인터넷망
		document.form.submit();
	}else{
		opener.jusoCallBack("<%=roadFullAddr%>","<%=roadAddrPart1%>","<%=addrDetail%>", "<%=roadAddrPart2%>","<%=engAddr%>"
			, "<%=jibunAddr%>","<%=zipNo%>", "<%=admCd%>", "<%=rnMgtSn%>", "<%=bdMgtSn%>", "<%=detBdNmList%>"
			, "<%=bdNm%>", "<%=bdKdcd%>", "<%=siNm%>", "<%=sggNm%>", "<%=emdNm%>", "<%=liNm%>", "<%=rn%>", "<%=udrtYn%>"
			, "<%=buldMnnm%>", "<%=buldSlno%>", "<%=mtYn%>", "<%=lnbrMnnm%>", "<%=lnbrSlno%>", "<%=emdNo%>", "<%=entX%>", "<%=entY%>");
		window.close();
	}
}
</script>
<body onload="init();">
	<form id="form" name="form" method="post">
		<input type="hidden" id="confmKey" name="confmKey" value=""/>
		<input type="hidden" id="returnUrl" name="returnUrl" value=""/>
		<input type="hidden" id="resultType" name="resultType" value=""/>
		<!-- 해당시스템의 인코딩타입이 EUC-KR일경우에만 추가 START--> 
		<!-- 
		<input type="hidden" id="encodingType" name="encodingType" value="EUC-KR"/>
		 -->
		<!-- 해당시스템의 인코딩타입이 EUC-KR일경우에만 추가 END-->
	</form>
</body>
</html>

CSS파일 소스보기

소스 다운로드

CSS파일 소스보기

						
/* 바탕 배경 이미지 */
.pop-address-search .pop-address-search-inner { background-image: url(http://www.0000.com/img/backImg.png);}
/* 회사 로고 이미지 */
.pop-address-search .pop-address-search-inner .logo { background: url(http://www.0000.com/img/logo.png) no-repeat; background-position:center; }

/* 바탕 배경색상 */
.pop-address-search .pop-address-search-inner { background-color:#ECECEC; }
/* 검색창 바탕 배경색상 */
.pop-address-search .pop-address-search-inner .search-wrap { background-color:#DCF3F4; }
/* 검색창 색상 */
.pop-address-search .pop-address-search-inner .wrap input { background-color:#FFFFFF; }
/* 검색버튼 색상 */
.pop-address-search .pop-address-search-inner .wrap { background-color:#FFFFFF; }
/* 본문 배경색(홀수) */
.pop-address-search .pop-address-search-inner .result table.data-col tbody tr:nth-child(odd) td {background:#FFFFFF}
/* 본문 배경색(짝수) */
.pop-address-search .pop-address-search-inner .result table.data-col tbody tr:nth-child(even) td {background:#FFFFFF}

좌표 검색 API

좌표 검색 API정보
호출방식	요청 URL	출력결과
POST GET	https://www.juso.go.kr/addrlink/addrCoordApiJsonp.do	JSONP(xml, json)
POST GET	https://www.juso.go.kr/addrlink/addrCoordApi.do	xml, json

좌표 검색 API 요청변수
요청변수명	타입	필수여부	기본값	설명
confmKey	String	Y	-	신청시 발급받은 승인키
admCd	String	Y	-	행정구역코드
rnMgtSn	String	Y	-	도로명코드
udrtYn	String	Y	-	지하여부
buldMnnm	Number	Y	-	건물본번
buldSlno	Number	Y	-	건물부번
resultType	String	N	xml	검색결과형식 설정(xml, json)

좌표 검색 API 출력결과
출력변수명	타입	필수여부	설명
common	totalCount	String	Y	총 검색 데이터수
errorCode	String	Y	에러 코드
errorMessage	String	Y	에러 메시지
juso	admCd	String	Y	행정구역코드
rnMgtSn	String	Y	도로명코드
bdMgtSn	String	Y	건물관리번호
udrtYn	String	Y	지하여부(0 : 지상, 1 : 지하)
buldMnnm	Number	Y	건물본번
buldSlno	Number	Y	건물부번
entX	String	Y	X좌표
entY	String	Y	Y좌표
bdNm	String	N	건물명

좌표 검색 API 오류코드
오류코드	오류메세지	조치방법
0	정상
-999	시스템에러	도로명주소 도움센터로 문의하시기 바랍니다.
E0001	승인되지 않은 KEY 입니다.	정확한 승인키를 입력하세요.(팝업API 승인키 사용불가)
E0002	행정구역코드(admCd)의 요청항목이 없습니다.	요청변수 중 행정구역코드(admCd)를 다시 확인하세요.
E0003	도로명코드(rnMgtSn)의 요청항목이 없습니다.	요청변수 중 도로명코드(rnMgtSn)를 다시 확인하세요.
E0004	지하여부(udrtYn)의 요청항목이 없습니다.	요청변수 중 지하여부(udrtYn)를 다시 확인하세요.
E0005	건물본번(buldMnnm)의 요청항목이 없습니다.	요청변수 중 건물본번(buldMnnm)을 다시 확인하세요.
E0006	건물부번(buldSlno)의 요청항목이 없습니다.	요청변수 중 건물부번(buldSlno)을 다시 확인하세요.
E0007	짦은 시간동안 다량의 주소검색 요청이 있습니다. 잠시 후 이용하시길 바랍니다.	비정상적인 연속된 호출을 삼가하세요.

웹 호출 소스보기( XML | JSON )
어플리케이션 호출 소스보기( XML | JSON )

가이드 및 소스 다운로드

웹 호출 (XML) 소스

						
/*
 파일명 : apiSampleXML.jsp
 내  용 : 웹 ↔ 좌표API방식(검색결과형식 XML)
 비  고 : 크로스도메인으로 인한 jsonp 이용
*/
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script type="text/JavaScript" src="/juso_support_center/js/jquery-1.8.3.min.js" ></script>

<script language="javascript">
function getAddr(){
	$.ajax({
		 url :"https://www.juso.go.kr/addrlink/addrCoordApiJsonp.do"  //인터넷망
		,type:"post"
		,data:$("#form").serialize()
		,dataType:"jsonp"
		,crossDomain:true
		,success:function(xmlStr){
			if(navigator.appName.indexOf("Microsoft") > -1){
				var xmlData = new ActiveXObject("Microsoft.XMLDOM");
				xmlData.loadXML(xmlStr.returnXml)
			}else{
				var xmlData = xmlStr.returnXml;
			}
			$("#list").html("");
			var errCode = $(xmlData).find("errorCode").text();
			var errDesc = $(xmlData).find("errorMessage").text();
			if(errCode != "0"){
				alert(errCode+"="+errDesc);
			}else{
				if(xmlStr != null){
					makeList(xmlData);
				}
			}
		}
	    ,error: function(xhr,status, error){
	    	alert("에러발생");
	    }
	});
}

function makeList(xmlStr){
	var htmlStr = "";
	htmlStr += "<table>";
	$(xmlStr).find("juso").each(function(){
		htmlStr += "<tr>";
		htmlStr += " <td>"+$(this).find('admCd').text()+"</td>";
		htmlStr += "<td>"+$(this).find('rnMgtSn').text()+"</td>";
		htmlStr += "<td>"+$(this).find('bdMgtSn').text()+"</td>";
		htmlStr += "<td>"+$(this).find('udrtYn').text()+"</td>";
		htmlStr += "<td>"+$(this).find('buldMnnm').text()+"</td>";
		htmlStr += "<td>"+$(this).find('buldSlno').text()+"</td>";
		htmlStr += "<td>"+$(this).find('entX').text()+"</td>";
		htmlStr += "<td>"+$(this).find('entY').text()+"</td>";
		htmlStr += "<td>"+$(this).find('bdNm').text()+"</td>";
		htmlStr += "</tr>";
	});
	htmlStr += "</table>";
	$("#list").html(htmlStr);
}
</script>
<title>Insert title here</title>
</head>
<body>
<form name="form" id="form" method="post">
	<input type="text" name="confmKey" value="TESTJUSOGOKR"/><!-- 요청 변수 설정 (승인키) -->
	<input type="text" name="admCd" value=""/> <!-- 요청 변수 설정 (행정구역코드) -->
	<input type="text" name="rnMgtSn" value=""/><!-- 요청 변수 설정 (도로명코드) --> 
	<input type="text" name="udrtYn" value=""/> <!-- 요청 변수 설정 (지하여부) -->
	<input type="text" name="buldMnnm" value=""/><!-- 요청 변수 설정 (건물본번) --> 
	<input type="text" name="buldSlno" value=""/><!-- 요청 변수 설정 (건물부번) --> 
	<input type="button" onClick="getAddr();" value="좌표검색하기"/>
	<div id="list" ></div><!-- 검색 결과 리스트 출력 영역 -->
</form>
</body>
</html>

어플리케이션 호출 (XML) 소스

						
/*
 파일명 : apiSampleApplicationXML.jsp
 내  용 : 웹 ↔ Java Controller ↔ 좌표API방식(검색결과형식 XML)
*/
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script type="text/JavaScript" src="/juso_support_center/js/jquery-1.8.3.min.js" ></script>

<script language="javascript">
function getAddrLoc(){
	$.ajax({
		 url :"/sample/getAddrApi.do"
		,type:"post"
		,data:$("#form").serialize()
		,dataType:"xml"
		,success:function(xmlStr){
			$("#list").html("");
			var errCode = $(xmlStr).find("errorCode").text();
			var errDesc = $(xmlStr).find("errorMessage").text();
			if(errCode != "0"){
				alert(errCode+"="+errDesc);
			}else{
				if(xmlStr != null){
					makeList(xmlStr);
				}
			}
		}
	    ,error: function(xhr,status, error){
	    	alert("에러발생");
	    }
	});
}

function makeList(xmlStr){
	var htmlStr = "";
	htmlStr += "<table>";
	$(xmlStr).find("juso").each(function(){
		htmlStr += "<tr>";
		htmlStr += "<td>"+$(this).find('admCd').text()+"</td>";
		htmlStr += "<td>"+$(this).find('rnMgtSn').text()+"</td>";
		htmlStr += "<td>"+$(this).find('bdMgtSn').text()+"</td>";
		htmlStr += "<td>"+$(this).find('udrtYn').text()+"</td>";
		htmlStr += "<td>"+$(this).find('buldMnnm').text()+"</td>";
		htmlStr += "<td>"+$(this).find('buldSlno').text()+"</td>";
		htmlStr += "<td>"+$(this).find('entX').text()+"</td>";
		htmlStr += "<td>"+$(this).find('entY').text()+"</td>";
		htmlStr += "<td>"+$(this).find('bdNm').text()+"</td>";
		htmlStr += "</tr>";
	});
	htmlStr += "</table>";
	$("#list").html(htmlStr);
}
</script>
<title>Insert title here</title>
</head>
<body>
<form name="form" id="form"method="post">
	<input type="text" name="confmKey" id="confmKey" value="TESTJUSOGOKR"/><!-- 요청 변수 설정 (승인키) -->
	<input type="text" name="admCd" value=""/> <!-- 요청 변수 설정 (행정구역코드) -->
	<input type="text" name="rnMgtSn" value=""/><!-- 요청 변수 설정 (도로명코드) --> 
	<input type="text" name="udrtYn" value=""/> <!-- 요청 변수 설정 (지하여부) -->
	<input type="text" name="buldMnnm" value=""/><!-- 요청 변수 설정 (건물본번) --> 
	<input type="text" name="buldSlno" value=""/><!-- 요청 변수 설정 (건물부번) -->
	<input type="button" onClick="getAddrLoc();" value="좌표검색하기"/>
	<div id="list" ></div><!-- 검색 결과 리스트 출력 영역 -->
</form>
</body>
</html> 	

/*
 파일명 : apiSampleXMLController.java
 내  용 : 웹 ↔ Java Controller ↔ 좌표API방식(검색결과형식 XML)
*/
import 	 java.io.BufferedReader;
import 	 java.io.InputStream;
import 	 java.io.InputStreamReader;
import 	 java.net.MalformedURLException;
import 	 java.net.URL;
import 	 java.net.URLConnection;
import 	 java.net.URLEncoder;
import 	 java.util.List;
import 	 javax.annotation.Resource;
import 	 javax.servlet.http.HttpServletRequest;
import 	 javax.servlet.http.HttpServletResponse;
import 	 org.springframework.stereotype.Controller;
import 	 org.springframework.ui.Model;
import 	 org.springframework.ui.ModelMap;
import 	 org.springframework.validation.BindingResult;
import 	 org.springframework.web.bind.annotation.ModelAttribute;
import 	 org.springframework.web.bind.annotation.RequestMapping;
import 	 org.springframework.web.bind.annotation.RequestParam;
import 	 org.springframework.web.bind.annotation.SessionAttributes;
import 	 org.springframework.web.bind.support.SessionStatus;
import 	 org.springmodules.validation.commons.DefaultBeanValidator;

@Controller
@SessionAttributes(types=SampleVO.class)
public class  EgovSampleController {	

   @Resource(name = "sampleService")
   private  EgovSampleService sampleService;    

   @Resource(name = "propertiesService")
   protected  EgovPropertyService propertiesService;

   @Resource(name = "beanValidator")
   protected  DefaultBeanValidator beanValidator;

   @RequestMapping(value="/sample/getAddrApi.do")
   public void  getAddrApi(@ModelAttribute("searchVO") SampleDefaultVO searchVO, 
                          HttpServletRequest req, ModelMap model, HttpServletResponse response) throws Exception {

   	String admCd = req.getParameter("admCd");
	String rnMgtSn = req.getParameter("rnMgtSn");
	String udrtYn = req.getParameter("udrtYn");
   	String buldMnnm = req.getParameter("buldMnnm");
	String buldSlno = req.getParameter("buldSlno");
	String confmKey = req.getParameter("confmKey");
	String apiUrl = "https://www.juso.go.kr/addrlink/addrCoordApi.do?admCd="+admCd
									+"&rnMgtSn="+rnMgtSn+"&udrtYn="+udrtYn+"&buldMnnm="+buldMnnm
									+"&buldSlno="+buldSlno+"&confmKey="+confmKey;
   	URL url = new URL(apiUrl);
   	BufferedReader br = new BufferedReader(new InputStreamReader(url.openStream(),"UTF-8"));
   	StringBuffer sb = new StringBuffer();
   	String tempStr = null;
   	while(true){ 
    		tempStr = br.readLine();
    		if(tempStr == null) break;
    		sb.append(tempStr);	
    	}
    	br.close();
    	response.setCharacterEncoding("UTF-8");
    	response.setContentType("text/xml");
    	response.getWriter().write(sb.toString());
    }
}

웹 호출 (JSON) 소스

						
/*
 파일명 : apiSampleJSON.jsp
 내  용 : 웹 ↔ 좌표API방식(검색결과형식 JSON)
 비  고 : 크로스도메인으로 인한 jsonp 이용
           검색결과형식을 XML로 받는 경우, 웹 호출 소스보기(XML)을 참고하시길 바랍니다. 
*/
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script type="text/JavaScript" src="/juso_support_center/js/jquery-1.8.3.min.js" ></script>

<script language="javascript">
function getAddr(){
	$.ajax({
		 url :"https://www.juso.go.kr/addrlink/addrCoordApiJsonp.do"  //인터넷망
		,type:"post"
		,data:$("#form").serialize()
		,dataType:"jsonp"
		,crossDomain:true
		,success:function(jsonStr){
			$("#list").html("");
			var errCode = jsonStr.results.common.errorCode;
			var errDesc = jsonStr.results.common.errorMessage;
			if(errCode != "0"){
				alert(errCode+"="+errDesc);
			}else{
				if(jsonStr != null){
					makeListJson(jsonStr);
				}
			}
		}
	    ,error: function(xhr,status, error){
	    	alert("에러발생");
	    }
	});
}

function makeListJson(jsonStr){
	var htmlStr = "";
	htmlStr += "<table>";
	$(jsonStr.results.juso).each(function(){
		htmlStr += "<tr>";
		htmlStr += "<td>"+this.admCd+"</td>";
		htmlStr += "<td>"+this.rnMgtSn+"</td>";
		htmlStr += "<td>"+this.bdMgtSn+"</td>";
		htmlStr += "<td>"+this.udrtYn+"</td>";
		htmlStr += "<td>"+this.buldMnnm+"</td>";
		htmlStr += "<td>"+this.buldSlno+"</td>";
		htmlStr += "<td>"+this.entX+"</td>";
		htmlStr += "<td>"+this.entY+"</td>";
		htmlStr += "<td>"+this.bdNm+"</td>";
		htmlStr += "</tr>";
	});
	htmlStr += "</table>";
	$("#list").html(htmlStr);
}
</script>
<title>Insert title here</title>
</head>
<body>
<form name="form" id="form" method="post">
	<input type="text" name="resultType" value="json"/> <!-- 요청 변수 설정 (검색결과형식 설정, json) --> 
	<input type="text" name="confmKey" value="TESTJUSOGOKR"/><!-- 요청 변수 설정 (승인키) -->
	<input type="text" name="admCd" value=""/> <!-- 요청 변수 설정 (행정구역코드) -->
	<input type="text" name="rnMgtSn" value=""/><!-- 요청 변수 설정 (도로명코드) --> 
	<input type="text" name="udrtYn" value=""/> <!-- 요청 변수 설정 (지하여부) -->
	<input type="text" name="buldMnnm" value=""/><!-- 요청 변수 설정 (건물본번) --> 
	<input type="text" name="buldSlno" value=""/><!-- 요청 변수 설정 (건물부번) -->
	<input type="button" onClick="getAddr();" value="좌표검색하기"/>
	<div id="list" ></div><!-- 검색 결과 리스트 출력 영역 -->
</form>
</body>
</html>

어플리케이션 호출 (JSON) 소스

						
/*
 파일명 : apiSampleApplicationJSON.jsp
 내  용 : 웹 ↔ Java Controller ↔ 좌표API방식(검색결과형식 JSON)
 비  고 : 검색결과형식을 XML로 받는 경우, 어플리케이션 호출 소스보기(XML)을 참고하시길 바랍니다.
*/
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script type="text/JavaScript" src="/juso_support_center/js/jquery-1.8.3.min.js" ></script>

<script language="javascript">
function getAddrLoc(){
	$.ajax({
		 url :"/sample/getAddrApi.do"
		,type:"post"
		,data:$("#form").serialize()
		,dataType:"json"
		,success:function(jsonStr){
			$("#list").html("");
			var errCode = jsonStr.results.common.errorCode;
			var errDesc = jsonStr.results.common.errorMessage;
			if(errCode != "0"){
				alert(errCode+"="+errDesc);
			}else{
				if(jsonStr != null){
					makeListJson(jsonStr);
				}
			}
		}
	    ,error: function(xhr,status, error){
	    	alert("에러발생");
	    }
	});
}

function makeListJson(jsonStr){
	var htmlStr = "";
	htmlStr += "<table>";
	$(jsonStr.results.juso).each(function(){
		htmlStr += "<tr>";
		htmlStr += "<td>"+this.admCd+"</td>";
		htmlStr += "<td>"+this.rnMgtSn+"</td>";
		htmlStr += "<td>"+this.bdMgtSn+"</td>";
		htmlStr += "<td>"+this.udrtYn+"</td>";
		htmlStr += "<td>"+this.buldMnnm+"</td>";
		htmlStr += "<td>"+this.buldSlno+"</td>";
		htmlStr += "<td>"+this.entX+"</td>";
		htmlStr += "<td>"+this.entY+"</td>";
		htmlStr += "<td>"+this.bdNm+"</td>";
		htmlStr += "</tr>";
	});
	htmlStr += "</table>";
	$("#list").html(htmlStr);
}
</script>
<title>Insert title here</title>
</head>
<body>
<form name="form" id="form"method="post">
	<input type="text" name="resultType" value="json"/> <!-- 요청 변수 설정 (검색결과형식 설정, json) -->
	<input type="text" name="confmKey" id="confmKey" value="TESTJUSOGOKR"/><!-- 요청 변수 설정 (승인키) -->
	<input type="text" name="admCd" value=""/> <!-- 요청 변수 설정 (행정구역코드) -->
	<input type="text" name="rnMgtSn" value=""/><!-- 요청 변수 설정 (도로명코드) --> 
	<input type="text" name="udrtYn" value=""/> <!-- 요청 변수 설정 (지하여부) -->
	<input type="text" name="buldMnnm" value=""/><!-- 요청 변수 설정 (건물본번) --> 
	<input type="text" name="buldSlno" value=""/><!-- 요청 변수 설정 (건물부번) -->
	<input type="button" onClick="getAddrLoc();" value="좌표검색하기"/>
	<div id="list" ></div><!-- 검색 결과 리스트 출력 영역 -->
</form>
</body>
</html> 	

/*
 파일명 : apiSampleJSONController.java
 내  용 : 웹 ↔ Java Controller ↔ 좌표API방식(검색결과형식 JSON)
*/
import 	 java.io.BufferedReader;
import 	 java.io.InputStream;
import 	 java.io.InputStreamReader;
import 	 java.net.MalformedURLException;
import 	 java.net.URL;
import 	 java.net.URLConnection;
import 	 java.net.URLEncoder;
import 	 java.util.List;
import 	 javax.annotation.Resource;
import 	 javax.servlet.http.HttpServletRequest;
import 	 javax.servlet.http.HttpServletResponse;
import 	 org.springframework.stereotype.Controller;
import 	 org.springframework.ui.Model;
import 	 org.springframework.ui.ModelMap;
import 	 org.springframework.validation.BindingResult;
import 	 org.springframework.web.bind.annotation.ModelAttribute;
import 	 org.springframework.web.bind.annotation.RequestMapping;
import 	 org.springframework.web.bind.annotation.RequestParam;
import 	 org.springframework.web.bind.annotation.SessionAttributes;
import 	 org.springframework.web.bind.support.SessionStatus;
import 	 org.springmodules.validation.commons.DefaultBeanValidator;

@Controller
@SessionAttributes(types=SampleVO.class)
public class  EgovSampleController {	

   @Resource(name = "sampleService")
   private  EgovSampleService sampleService;    

   @Resource(name = "propertiesService")
   protected  EgovPropertyService propertiesService;

   @Resource(name = "beanValidator")
   protected  DefaultBeanValidator beanValidator;

   @RequestMapping(value="/sample/getAddrApi.do")
   public void  getAddrApi(@ModelAttribute("searchVO") SampleDefaultVO searchVO, 
                          HttpServletRequest req, ModelMap model, HttpServletResponse response) throws Exception {

	String admCd = req.getParameter("admCd");
	String rnMgtSn = req.getParameter("rnMgtSn");
	String udrtYn = req.getParameter("udrtYn");
   	String buldMnnm = req.getParameter("buldMnnm");
	String buldSlno = req.getParameter("buldSlno");
	String confmKey = req.getParameter("confmKey");
	String resultType = req.getParameter("resultType");
	String apiUrl = "https://www.juso.go.kr/addrlink/addrCoordApi.do?admCd="+admCd
									+"&rnMgtSn="+rnMgtSn+"&udrtYn="+udrtYn+"&buldMnnm="+buldMnnm
									+"&buldSlno="+buldSlno+"&confmKey="+confmKey+"&resultType="+resultType;
   	URL url = new URL(apiUrl);
   	BufferedReader br = new BufferedReader(new InputStreamReader(url.openStream(),"UTF-8"));
   	StringBuffer sb = new StringBuffer();
   	String tempStr = null;
   	while(true){ 
    		tempStr = br.readLine();
    		if(tempStr == null) break;
    		sb.append(tempStr);	
    	}
    	br.close();
    	response.setCharacterEncoding("UTF-8");
    	response.setContentType("application/juso_support_center/json");
    	response.getWriter().write(sb.toString());
    }
}

※ 단독건물인 경우 건물중심점좌표, 집합건물인 경우 주출입구 좌표를 제공합니다.
※ 좌표계 안내 : 좌표계(ITRF2000), 기준타원체(GRS80), 투영법(UTM), 장반경(6,378,137m)
※ 행정망 내에서 운영되는 시스템도 이용 가능합니다. 행정망 서비스를 위한 API 요청URL은 별도로 문의 주시기 바랍니다.

(1588-0061)

좌표제공API