Daum 우편번호 서비스 Q&A
Switch branches/tags
Nothing to show
Clone or download
Latest commit 9629eb9 Jun 19, 2018
Permalink
Failed to load latest commit information.
asset Add files via upload Aug 18, 2016
PATCHNOTE.md Update PATCHNOTE.md Jun 19, 2018
README.md Update README.md Apr 5, 2018

README.md

Daum 우편번호 서비스

Daum 우편번호 서비스는 웹사이트에서 도로명 주소와 우편번호를 검색할 수 있는 Javascript API입니다.
Sample 코드와 상세 Reference는 http://postcode.map.daum.net/guide 에서 확인할 수 있습니다.

문의 사항은 먼저 아래 FAQ를 확인해주시고, Issue로 등록해주시면 됩니다.


>> 업데이트 소식 바로가기(Click!!)

업데이트 소식을 더 보기 편하시도록 페이지를 이동하였습니다. 업데이트와 관련된 사항은 위 링크된 페이지를 확인해 주세요. 추가적인 업데이트의 자세한 내용은 가이드 페이지 를 참고해 주세요.


자주 묻는 질문(FAQ)

1. 주소가 없습니다 / 검색되지 않습니다.

우선 행정자치부 도로명주소 검색시스템에서 검색이 되는지 확인해 주세요. 만약 행정자치부 도로명주소 검색시스템에서 검색이 되지 않는다면 직접 등록 요청을 하셔야 합니다.

  1. 행정자치부 도로명 주소 검색시스템 접속
  2. 상단 메뉴 중 "고객지원" -> "도로명주소 도움센터(Q&A)" 클릭
  3. 게시판에 해당 주소에 대해서 등록 요청 글을 남기시면 됩니다.(로그인 필요)

위 단계를 통해 해당 주소가 행정자치부 도로명 주소 검색시스템에 등록이 되면, Daum 우편번호 서비스 시스템에는 등록된 날로부터 1일 후에 업데이트 됩니다.
만약 행자부 도로명 주소 검색시스템에서는 검색이 되는데 Daum 우편번호 서비스에서 검색이 되지 않는다면, 검색 방식의 차이로 인한 오류일 수 있으니 Issue로 등록해주시기 바랍니다.

추가사항

대부분의 모든 주소를 1일 업데이트 하지만, 몇몇 업데이트가 불가능한 주소가 있습니다. 행정자치부 도로명주소 검색시스템에서 검색은 되나, 저희 우편번호시스템에서는 검색이 안되는 경우가 있는데요. 이는 국가보안시설(주요 기관, 발전소 등)로 지정된 곳은 저희에게 데이터를 내려주지 않아 현재 업데이트가 불가능합니다. 해당 주소들은 도로명주소 검색시스템에서 검색시 아래와 같이 지도 마커가 없습니다. noshow

이외 지도 마커가 있는 주소들은 저희 시스템에서 모두 검색이 됩니다. show

이점 API 이용에 참고하시기 바랍니다.

2. 주소에 있는 건물명이 실제 명칭과 다릅니다.

1번 질문과 같은 방식으로 확인하시면 됩니다. 주소 데이터는 저희가 수정할 수는 없습니다.

3. 6자리 구우편번호가 필요합니다

2015년 8월 1일 부로 6자리 구우편번호는 우정사업본부에서 더이상 생성/관리되지 않으므로 5자리 새우편번호(기초구역번호)를 이용하셔야 합니다. (참고. 우정국 새우편번호 시행 공지) 현재 일부 제공되고 있는 6자리 구우편번호는 시간이 지남에 따라 삭제될 예정입니다.

4. REST API로도 제공하고 있나요?

제공 계획은 없습니다.

5. 정말 아무에게나 무료인가요? 회사에서 상업적인 용도로 써도 무료인가요?

레알 100% 무료입니다.

6. 하루 사용량 제한이 있나요?

레알 100% 무제한 입니다.

7. 하단 로고를 안보이게 할 수 없나요?

로고는 정책상 반드시 노출하는 것을 원칙으로 하고 있습니다. 하단의 'Powered by Daum' 을 통한 저작자 표기 정책은 Daum 우편번호서비스를 지속적으로 무료 운영할 수 있는 근거로 활용되고 있으며, 로고를 숨길 경우에는 사용상의 제약을 받을 수 있습니다.

8. UI를 변경하는 기능이나 옵션은 없나요?

현재 우편번호 서비스 화면의 색상을 변경할 수 있는 테마기능과 '영문보기','지도' 버튼을 가릴 수 있는 옵션을 제공하고 있습니다. 단, 이외 UI컴포넌트 추가 및 레이아웃 변경과 같은 기능은 제공하고 있지 않습니다.

9. 모바일앱에서도 사용할 수 있나요?

웹뷰를 이용하여 하이브리드앱 제작 방식으로 사용할 수 있습니다. 단, html,js,css들을 정적으로 넣고 실행하는 경우에는 데이터 전달이 되지 않기 때문에, 페이지를 호출하는 방식으로 사용하셔야 합니다.

10. iOS/Android에서 webview를 이용하여 사용할 수 있나요?

9번과 같이 정적 html,js,css가 아닌 http(s)프로토콜을 사용한 페이지를 호출하는 페이지에서는 사용가능합니다.
단, 기본 webview의 경우 우편번호서비스의 open메소드를 이용한 팝업방식 보다는 embed메소드를 이용한 레이어 방식을 사용하시길 권해드립니다.
이유는 기본적인 webview에서 open메소드 사용시, 팝업이 뜨기보다 기존페이지에서 우편번호서비스 페이지로 이동이 되어 버리기 때문에, 데이터 전달이 되지 않습니다. 반드시 open메소드를 사용하시고자 하실때에는 각 플랫폼의 webview에서 window.open에 대응할 수 있도록 webview를 개선하여 사용하시기 바랍니다.

11. requireJS를 사용할 수 있나요?

아뇨. 현재 대응하고 있지 않습니다.

12. 팝업창에서 검색 후 결과를 클릭해도 반응이 없습니다.

혹시 웹서버 환경에서 확인하고 계신가요? 정적페이지로 브라우저에서 파일을 오픈하여 사용할 경우에는 host정보를 알 수 없어 데이터 전달이 되지 않습니다.

13. 팝업창이 비어 있는 채로 뜹니다.

혹시 document.domain을 사용하고 계신가요? Daum 우편번호 서비스를 사용하시는 페이지에서는 document.domain값을 임의로 세팅하는 경우에 일부 IE 브라우저에서 제대로 동작하지 않습니다.

14. 검색 후 결과 클릭한 후 팝업이 닫히지 않습니다(값이 입력되거나 또는 입력되지 않는 상황).

FAQ 13번의 이슈가 아니라면, javascript 실행시 오류가 난 경우입니다. oncomplete 함수에서 사용하는 변수가 정확한지, input tag의 id값을 잘못 사용하고 있는지 확인해 보시길 바랍니다. 브라우저의 개발자 도구 활용을 권장합니다. (팝업형의 경우 개발자 도구는 팝업창에 focus를 두고 개발자 도구를 띄우셔야 합니다.)

예를 들면, document.getElementById() 함수 이용시,
IE9이하에서는 input tag의 name값으로도 노드를 가져올 수 있지만, 그 외 브라우저에서는 null을 리턴합니다.
그렇기 때문에 반드시 id 속성을 사용하시기 바라며,
그렇지 못할 경우에 다른 셀렉터 함수(document.querySelector, jQuery selector 등)를 사용하시기 바랍니다.

15. javascript API 코드를 복사해서 사용해도 되나요?

javascript API 코드를 복사하여 자체 서버에 업로드 하여 사용하실 경우에는 추후에 기능적인 업그레이드로 인한 지원을 받으실 수 없기 때문에 오류가 발생하거나 사용상의 제약을 받을 수 있습니다.

16. 사용자가 지번/도로명 중 어떤 것을 선택하더라도 무조건 도로명 주소만 이용하고 싶은데.. 어떻게 해야되나요?

사용자가 선택한 값(userSelectedType)과 상관 없이 로직상 autoRoadAddress변수를 체크하고, 값이 없으면 roadAddress변수를 이용하시면 됩니다.
도로명 주소의 데이터가 셋팅되는 방법에 대해서 추가 설명 드리자면
(autoMapping을 true로 설정한 경우 - 기본값)

  • 사용자가 지번-도로명 1:N 관계에서 메인 지번주소를 선택할 경우, 도로명 주소는 autoRoadAddress에 들어가게 됩니다. 또한 연관된 도로명 주소를 선택하게 되면 roadAddress에 들어가게 됩니다.
  • 사용자가 지번-도로명 1:1 관계에서 메인 지번주소나 연관된 도로명주소를 선택하면, 도로명 주소는 roadAddress에 들어가게 됩니다.
  • 사용자가 도로명-지번 1:N, 1:1 관계에서 메인 도로명주소를 선택하거나 연관된 지번주소를 선택할 경우, 도로명 주소는 address, roadAddress에 들어가게 됩니다.

17. 사용자가 지번/도로명 중 어떤 것을 선택하더라도 무조건 지번 주소만 이용하고 싶은데.. 어떻게 해야되나요?

사용자가 선택한 값(userSelectedType)과 상관 없이 로직상 autoJibunAddress변수를 체크하고, 값이 없으면 JibunAddress변수를 이용하시면 됩니다. 지번 주소의 데이터가 셋팅되는 방법에 대해서 추가 설명 드리자면 (autoMapping을 true로 설정한 경우 - 기본값)

  • 사용자가 도로명-지번 1:N 관계에서 메인 도로명 주소를 선택할 경우, 지번 주소는 autoJibunAddress에 들어가게 됩니다. 또한 연관된 지번 주소를 선택하게 되면 jibunAddress에 들어가게 됩니다.
  • 사용자가 도로명-지번 1:1 관계에서 메인 도로명 주소나 연관된 지번주소를 선택하면, 지번 주소는 jibunAddress에 들어가게 됩니다.
  • 사용자가 지번-도로명 1:N, 1:1 관계에서 메인 지번주소를 선택하거나 연관된 도로명주소를 선택할 경우, 지번 주소는 address, jibunAddress에 들어가게 됩니다.

18. '세종특별자치시', '제주특별자치도'의 축약형이 내려오지 않습니다.

우편번호 서비스는 기본적으로 축약형 형태로 주소정보를 제공(shorthand=true)하고 있으나, 각 지자체의 요청에 따라 해당 기능의 기본 값이 변경될 수 있습니다. 이러한 주소는 shorthand옵션에 영향을 받지 않고 항상 전체 이름으로 내려가게 됩니다.

현재 이와 같은 처리가 된 주소는 아래와 같습니다.

  • 세종특별자치시
  • 제주특별자치도

그렇기 때문에, 축약형을 원하는 이용자 분들께서는 oncomplete 콜백 함수내에서 데이터를 받을 시, sido 변수가 위 주소인지를 확인하시어 적절한 값으면 변경하여 사용하시기 바랍니다.