2015년 8월 1일부터 우편번호가 5자리로 변경이 됩니다

다행히 우정사업본부에서 OpenAPI를 제공하고 있습니다

금번 제공되는 OpenAPI는 기존 제공API보다 한단계 발전된 형태로 제공하네요

기존에는 시도선택 구군선택을 해야만 했고

지번주소인지 건물명인지 도로명인지를 선택하고

건물번호나 번지수를 입력해야 했는데

금번 제공되는 것은 도로명을 넣든 동명을 넣든 건물명을 넣든 다 검색을 해주네요

또한 검색 후 총 검색 갯수와 페이징까지 정보를 보내줍니다

또한 초기 검색시 가져올 갯수까지지정이 가능하고

검색시 현재 페이지를 넘겨주면 해당페이지에 해당하는 검색리스트를 리턴해줍니다

 

그럼 간단히 살펴볼까요

 

먼저 data.go.kr에 가셔서 회원가입을 하고 5자리 우편번호 OpenAPI사용신청을 하셔야 합니다

그러면 인증키를 발급받을수 있습니다

그런 후

http://openapi.epost.go.kr/postal/retrieveNewAdressAreaCdSearchAllService/retrieveNewAdressAreaCdSearchAllService/getNewAddressListAreaCdSearchAll?currentPage=현재페이지&srchwrd=검색어&countPerPage=페이지당 갯수&serviceKey=발급받은 인증키

 

이렇게 호출하면 XML로 데이타를 리턴해줍니다

 

리턴된 데이타를 살펴보면 (소공로로 검색해봤습니다)

 

<NewAddressListResponse>
<cmmMsgHeader>
<requestMsgId/>
<responseMsgId/>
<responseTime>20150715:102013227</responseTime>
<successYN>Y</successYN>
<returnCode>00</returnCode>
<errMsg/>
<totalCount>173</totalCount>
<countPerPage>10</countPerPage>
<totalPage>18</totalPage>
<currentPage>1</currentPage>
</cmmMsgHeader>
<newAddressListAreaCdSearchAll>
<zipNo>04633</zipNo>
<lnmAdres>서울특별시 중구 소공로 25 (회현동2가)</lnmAdres>
<rnAdres>서울특별시 중구 회현동2가 59</rnAdres>
</newAddressListAreaCdSearchAll>

.

.

.

 

</NewAddressListResponse> 

 

이런 XML을 보내줍니다

 

살펴보면

cmmMsgHeader 부분에는 전체적인 정보를 보내줍니다

검색 성공여부, 에러메세지, 전체검색갯수, 페이지당 갯수, 총페이지수, 현재페이지 정보를 보내줍니다

newAddressListAreaCdSearchAll 이부분에서 해당 내용을

우편번호, 도로명주소, 지번주소를 같이 보내줍니다

 

이것을 XML파싱을 해서 사용하시면 됩니다

 

도움이 되었으면 합니다

 

 

 

top