도로명주소 API - 검색API 적용하기

도로명주소 API - 검색API 적용

도로명주소 API에서 검색형 API로 적용을 해보겠습니다.

검색형과 팝업형이있는데 레이어팝업을 사용해야되거나 팝업이 싫으시나 하시는 분들은

이방법으로 사용하시면 됩니다.

방식은 xml, json이 있는데 json으로 사용해볼겠습니다.

앞에 팝업형에서도 작성한것과 같이 

주소 api를 사용하려면 아래 링크에서 샘플 및 정보를 받을수 있습니다.

https://www.juso.go.kr/addrlink/main.do

접속해서 api키를 발급받아야 사용이 가능하니 api키를 발급 받으시길 바랍니다.

기본적인 정보만 입력하면 쉽게 발급받으실수 있습니다.

sample과 api활용 가이드도 있으니 참고하시면 좋을것 같습니다.

이번에는 검색형 주소검색을 사용했고 제가 적용한것을 작성하겠습니다.

자바스크립트

아래서 에러코드를 사용했는데 에러코드는 다음과 같습니다.

0         정상

-999         시스템에러 도로명주소 도움센터로 문의하시기 바랍니다.

E0001 승인되지 않은 KEY 입니다. 정확한 승인키를 입력하세요.(팝업API 승인키 사용불가)

E0005 검색어가 입력되지 않았습니다. 검색어를 입력해주세요.

E0006 주소를 상세히 입력해 주시기 바랍니다. 시도명으로는 검색이 불가합니다.

// 주소 검색후 데이터 받아오기

function getAddr(){

// AJAX 주소 검색 요청

$.ajax({

url:"http://www.juso.go.kr/addrlink/addrLinkApiJsonp.do" // 주소검색 OPEN API URL

,type:"post"

,data:$("#form").serialize() // 요청 변수 설정

,dataType:"jsonp" // 크로스도메인으로 인한 jsonp 이용, 검색결과형식 JSON 

,crossDomain:true

,success:function(jsonStr){ // jsonStr : 주소 검색 결과 JSON 데이터

$("#list").html(""); // 결과 출력 영역 초기화

var errCode = jsonStr.results.common.errorCode;

var errDesc = jsonStr.results.common.errorMessage;

if(errCode != "0"){ 

$("#pageApi").html("");

if(errCode ==  "E0001"){ alert("승인되지 않은 KEY입니다."); }

else if(errCode ==  "E0005"){ alert("검색어를 입력해주세요."); }

else if(errCode ==  "E0006"){ alert("시도명으로는 검색이 불가합니다."); }

else { alert("에러가 발생하였습니다. 잠시후 다시 시도해주세요."); }

}else{

if(jsonStr!= null){

makeListJson(jsonStr); // 결과 JSON 데이터 파싱 및 출력

pageMake(jsonStr);

}

}

}

,error: function(xhr,status, error){

alert("에러발생"); // AJAX 호출 에러

}

});

}

// 주소검색한 리스트를 html에 생성

function makeListJson(jsonStr){

var htmlStr = "";

htmlStr += "<table>";

// jquery를 이용한 JSON 결과 데이터 파싱

$(jsonStr.results.juso).each(function(){

htmlStr += "<tr>";

htmlStr += "<td>"+this.roadAddrPart1+"</td>";

htmlStr += "<td>"+this.roadAddrPart2+"</td>";

htmlStr += "<td>"+this.engAddr+"</td>";

htmlStr += "<td>"+this.zipNo+"</td>";

     htmlStr += "<td>

<input type=\"button\" onclick=\"addressing(\'"+this.zipNo+"\',\'"+this.roadAddrPart1+"\',\'"+this.roadAddrPart2+"\')\" value=\"선택\"></td>";

htmlStr += "</tr>";

});

htmlStr += "</table>";

// 결과 HTML을 FORM의 결과 출력 DIV에 삽입

$("#list").html(htmlStr);

}

// 주소값 넣어주기

function addressing(zipNo,roadAddrPart1,roadAddrPart2){

document.form.zipNo.value = zipNo; // 우편번호

document.form.addr.value = roadAddrPart1;//+" "+roadAddrPart2; // 도로명주소

}

//페이지 이동

function goPage(pageNum){

document.form.currentPage.value=pageNum;

getAddr();

}

// json타입 페이지 처리 (주소정보 리스트 makeListJson(jsonStr); 다음에서 호출)

function pageMake(jsonStr){

var total = jsonStr.results.common.totalCount; // 총건수

console.log("총건수:"+total);

var pageNum = document.form.currentPage.value;// 현재페이지

var paggingStr = "";

if(total < 1){

var htmlStr = "";

htmlStr += "<table>";

htmlStr += "<tr>";

htmlStr += "<td>검색결과가 없습니다.</td>";

htmlStr += "</tr>";

htmlStr += "</table>";

$("#list").html(htmlStr);

$("#pageApi").html("");

}else{

if(total > 1000){

total=1000;

}

var PAGEBLOCK=10; // 10

var pageSize=10; // 10

var totalPages = Math.floor((total-1)/pageSize) + 1; // 총페이지

var firstPage = Math.floor((pageNum-1)/PAGEBLOCK) * PAGEBLOCK + 1; // 리스트의 처음 ( (2-1)/10 ) * 10 + 1 // 1 11 21 31

if( firstPage <= 0 ) firstPage = 1; // 처음페이지가 1보다 작으면 무조건 1

var lastPage = firstPage-1 + PAGEBLOCK; // 리스트의 마지막 10 20 30 40 50

if( lastPage > totalPages ) lastPage = totalPages; // 마지막페이지가 전체페이지보다 크면 전체페이지

var nextPage = lastPage+1 ; // 11 21 

var prePage = firstPage-PAGEBLOCK ;

if( firstPage > PAGEBLOCK ){

paggingStr +=  "<a href='javascript:goPage("+prePage+");'>◁</a>  " ; // 처음 페이지가 아니면 <를 넣어줌

}

for(var i=firstPage; i<=lastPage; i++ ){

if( pageNum == i )

paggingStr += "<a style='font-weight:bold;color:blue;font-size:15px;' href='javascript:goPage("+i+");'>" + i + "</a>  ";

else

paggingStr += "<a href='javascript:goPage("+i+");'>" + i + "</a>  ";

}

if( lastPage < totalPages ){

paggingStr +=  "<a href='javascript:goPage("+nextPage+");'>▷</a>"; // 마지막페이지가 아니면 >를 넣어줌

}

$("#pageApi").html(paggingStr);

}

}

JSP - HTML

<form name="form" id="form" method="post">

  <input type="hidden" name="currentPage" value="1"/> <!-- 요청 변수 설정 (현재 페이지. currentPage : n > 0) -->

  <input type="hidden" name="countPerPage" value="10"/> <!-- 요청 변수 설정 (페이지당 출력 개수. countPerPage 범위 : 0 < n <= 100) -->

  <input type="hidden" name="resultType" value="json"/> <!-- 요청 변수 설정 (검색결과형식 설정, json) --> 

  <input type="hidden" name="confmKey" value="승인키"/> <!-- 요청 변수 설정 (승인키) -->

  <input type="text" name="keyword" value=""/> <!-- 요청 변수 설정 (키워드) -->

  <input type="button" onClick="getAddr();" value="주소검색하기"/>

  <div id="list"> <!-- 검색 결과 리스트 출력 영역 --> </div>

  <div class="paginate" id="pageApi"></div>

</form>