카카오 우편번호 API 활용해보기

주소를 검색해서 우편번호를 입력하여야 하는 API를 찾아보다가 카카오에서 제공해주는 것을 확인하여 적용해봤습니다. 먼저 우편번호 서비스를 제공해주는 오픈 소스에 대한 명세입니다.

https://postcode.map.daum.net/guide

Daum 우편번호 서비스

들어가보시면 친절하게 설명되어 있어서 너무 좋아요.

---

그리고 우편번호와 관련된 Q&A는 깃헙에서 또 받고 있더라구요, 아무래도 개발자들을 위한 편의성을 제공해주기 위한 다음카카오 측의 배려라고 생각이 들었습니다.

그 다음으로는 제가 작성한 코드를 올려볼까합니다.

index.html

<input type="button" name="postcode" value="우편번호 찾기" onclick="openDaumPostcodePopup()">

<script src="//t1.daumcdn.net/mapjsapi/bundle/postcode/prod/postcode.v2.js"></script>

index.js

const postcode = new daum.Postcode({
    oncomplete: function(data) {
        // 팝업에서 검색결과 항목을 클릭했을때 실행할 코드를 작성하는 부분.

        // 각 주소의 노출 규칙에 따라 주소를 조합한다.
        // 내려오는 변수가 값이 없는 경우엔 공백('')값을 가지므로, 이를 참고하여 분기 한다.
        var addr = ''; // 주소 변수
        var extraAddr = ''; // 참고항목 변수

        //사용자가 선택한 주소 타입에 따라 해당 주소 값을 가져온다.
        if (data.userSelectedType === 'R') { // 사용자가 도로명 주소를 선택했을 경우
            addr = data.roadAddress;
        } else { // 사용자가 지번 주소를 선택했을 경우(J)
            addr = data.jibunAddress;
        }

        // 사용자가 선택한 주소가 도로명 타입일때 참고항목을 조합한다.
        if(data.userSelectedType === 'R'){
            // 법정동명이 있을 경우 추가한다. (법정리는 제외)
            // 법정동의 경우 마지막 문자가 "동/로/가"로 끝난다.
            if(data.bname !== '' && /[동|로|가]$/g.test(data.bname)){
                extraAddr += data.bname;
            }
            // 건물명이 있고, 공동주택일 경우 추가한다.
            if(data.buildingName !== '' && data.apartment === 'Y'){
                extraAddr += (extraAddr !== '' ? ', ' + data.buildingName : data.buildingName);
            }
            // 표시할 참고항목이 있을 경우, 괄호까지 추가한 최종 문자열을 만든다.
            if(extraAddr !== ''){
                extraAddr = ' (' + extraAddr + ')';
            }
            // 조합된 참고항목을 해당 필드에 넣는다.
            // document.getElementById("extraAddr").value = extraAddr;

        } else {
            // document.getElementById("extraAddr").value = '';
        }

        // 우편번호와 주소 정보를 해당 필드에 넣는다.
        document.getElementById('zonecode').value = data.zonecode;
        document.getElementById("address").value = addr;
        // 커서를 상세주소 필드로 이동한다.
        document.getElementById("address_detail").focus();
    }
});

// 버튼이 클릭되었을 때 오픈 팝업은 이와 같이 적용하면 됩니다.
const openDaumPostcodePopup = function() {
    postcode.open();
}

실제로 적용된 팝업