2017년 2월 6일부로 우편번호 V1 서비스가 종료됩니다.
현재 도로명주소를 대응한 V2 서비스는 정상 운영중이니 V2 서비스로 이관해 주시기 바랍니다.
http://postcode.map.daum.net/guide 에서 자세한 내용을 확인하세요.

웹사이트에서 주소를 입력받을 때 꼭 필요한 우편번호 검색 기능. 구현도 유지보수도 만만치 않으셨죠?
Daum 우편번호 서비스를 이용해 쉽고 간편하게 우편번호 검색, 주소 입력 기능을 만들어보세요. 아무 제약 없이 누구나 사용할 수 있으며, 100% 무료입니다!

우편번호 서비스 썸네일 이미지

Daum 우편번호 서비스를 이용하려면,
우편번호 검색 팝업창을 띄우고자 하는 페이지에 아래와 같은 방식으로 코드를 넣으면 됩니다.

일반적인 팝업 방식입니다. 버튼을 클릭하여 우편번호 찾기 팝업창을 띄우고, 검색 결과를 클릭했을때 우편번호와 주소 필드에 값을 채워 넣는 예제 입니다.

위 코드를 이용한 Demo를 바로 실행해보실 수 있습니다.

-

모바일웹에서는 팝업을 띄우는게 부담스러울 수도 있으니, 아래 코드와 같이 특정 element에 크기를 지정하여 iframe으로 끼워넣는 방식을 이용할 수도 있습니다.

위 코드를 이용한 Demo를 바로 실행해보실 수 있습니다.

-

화면내에 끼워넣는 방식일 경우, 내부 스크롤이 거슬릴수도 있습니다. 이때 onresize 옵션을 추가해서 iframe 높이를 조절하면 스크롤이 생기지 않습니다.

-

daum.Postcode의 생성자 option들은 아래와 같습니다.

우편번호 찾기 화면에서 특정 항목을 클릭한 경우, 해당 정보를 받아서 처리할 함수를 정의하는 부분입니다.(null값 또는 정의하지 않을 시에 팝업은 뷰어모드로 동작하게 됩니다.)
이 함수를 정의할때 넣는 인자에는 우편번호 찾기 화면에서 클릭했던 항목이 객체로 들어가게 됩니다.

address변수의 각 케이스별 예시 표
addressType address address1 address2
N 서울특별시 용산구 한남동 1~28 서울특별시 용산구 한남동 1~28
N 서울특별시 용산구 한남동 578 서울특별시 용산구 한남동 578
N 서울특별시 동작구 대방동 대림아파트 서울특별시 동작구 대방동 대림아파트
N 광역시 강서구 대저2동 사서함 307-1~307-29 광역시 강서구 대저2동 사서함 307-1~307-29
N 서울특별시 관악구 청룡동 산174~177 서울특별시 관악구 청룡동 산174~177
N 인천광역시 강화군 불은면 덕성리 인천광역시 강화군 불은면 덕성리 -
R 서울특별시 강북구 월계로 37 (미아동 48-9) 서울특별시 강북구 월계로 37 (미아동 48-9)
R 서울특별시 강북구 월계로37길 137 (번동 191,기산그린아파트) 서울특별시 강북구 월계로37길 137 (번동 191,기산그린아파트)

address,relatedAddress변수의 예시표
addressType address relatedAddress
R 서울특별시 강북구 월계로37길 137 (번동 191,기산그린아파트) 서울특별시 강북구 번동 191
R 제주특별자치도 제주시 한경면 고조로 5 (고산리 2148-7) 제주특별자치도 제주시 한경면 고산리 2148-7

검색 결과로 인해 우편번호 찾기 화면 크기가 변한 경우, 해당 정보를 받아서 처리할 함수를 정의하는 부분입니다. 우편번호 찾기를 iframe으로 넣은 경우에 이 크기 정보값을 이용해서 iframe을 감싸고 있는 element의 크기(주로 높이값)를 조절하고자 할때 사용하면 됩니다.
이 함수를 정의할때 넣는 인자에는 우편번호 찾기 화면 크기 정보가 객체로 들어가게 됩니다. (open()함수를 이용한 팝업모드에서는 지원하지 않습니다.)

화면의 넓이를 지정합니다. 기본값은 500이며 iframe으로 띄울 경우 비율(%)로도 입력이 가능합니다. 최소 width는 300으로 고정됩니다.

화면의 높이를 지정합니다. 기본값은 500이며 iframe으로 띄울 경우 비율(%)로도 입력이 가능합니다.

daum.Postcode의 method들은 아래와 같이 두가지가 제공됩니다.

우편번호 찾기 화면을 팝업으로 띄웁니다.

특정 검색어를 넘겨 바로 실행하고자 할때는 매개변수를 추가하면 됩니다(필요하지 않을때 생략가능).
매개변수에 객체형식으로 {q : '한남동'}을 입력하면 팝업이 열리면서, "한남동"으로 자동 검색됩니다.

우편번호 찾기 화면을 iframe으로 삽입합니다. 이때 iframe을 삽입할 element를 첫번째 매개변수로 넘겨주어야 합니다.

특정 검색어를 넘겨 바로 실행하고자 할때는 두번째 매개변수를 추가하면 됩니다(필요하지 않을때 생략가능).
두번째 매개변수에 객체형식으로 {q : '한남동'}을 입력하면 iframe이 열리면서, "한남동"으로 자동 검색됩니다.

Daum 우편번호 서비스는 PC 및 모바일웹 환경에서 일반적으로 사용되는 모든 브라우저를 지원합니다.

HTTPS를 이용하는 곳에서는 HTTPS 사용가이드를 참고해 주세요. 현재 페이지와 동일한 내용이지만, 샘플 코드와 Demo가 HTTPS용으로 제작되어 있습니다.

더 나은 검색결과를 제공하기 위해, 사용처 도메인(referrer) 정보와 검색된 결과들을 log로 남기고 있습니다. 사용자의 개인정보는 전혀 수집하지 않으므로 안심하셔도 됩니다.

Daum 우편번호 서비스는 우정사업본부에서 제공하는 우편번호 DB를 사용한 검색 기능을 제공하고 있으며, Daum 우편번호 서비스를 사용함으로 인하여 발생하는 문제에 대하여 Kakao는 어떠한 책임도 부담하지 않습니다.

문의사항이 있으신 경우, 우편번호 서비스 Q&A에 Issue를 남겨주세요. 최대한 빠르게 답변하겠습니다.