Postcodify 매뉴얼

무료 API 및 CDN 활용 안내

무료 API 소개

검색 횟수가 하루 수십~수백 회에 불과한 소규모 사이트라면 몇 기가에 이르는 도로명주소 검색 DB를 직접 구축하기가 어려울 수 있습니다. 그래서 개인, 기업, 단체 등 누구나 자유롭게 사용할 수 있는 무료 API를 운영하고 있습니다.

무료 API를 사용하기 위해서 특별히 서버 설정이나 사용 신청을 할 필요는 없습니다. 별다른 설정 없이 Postcodify 팝업 레이어 또는 jQuery 플러그인을 사용하면 자동으로 무료 API를 통해 검색을 수행하게 됩니다.

무료 API는 CloudFlare CDN을 사용하는 메인서버와 별도 네트워크로 구성된 백업서버로 이중화되어 있으며, 메인서버가 다운될 경우 자동으로 백업서버에서 검색을 수행하므로 매우 높은 안정성을 자랑합니다.

무료 API 이용시 유의사항

Postcodify는 새주소 전환을 돕고 웹마스터 여러분의 수고를 덜어드리기 위해 만든 프로그램입니다. 개발자는 Postcodify와 관련하여 저작권료, 사용료, 자문료 등 어떠한 이윤도 추구하지 않으며, 서버도 자비와 후원금으로 운영중입니다. 따라서 불필요한 쿼리가 발생하지 않도록 사용자들에게 검색 요령을 잘 안내해 주시기 바랍니다. 새주소는 예전처럼 읍·면·동만 입력하면 검색 효율이 많이 떨어집니다.

무료 API 서버는 검색서버의 원활한 운영과 공평한 사용을 위해 일일 쿼리수 제한을 두고 있습니다. 검색량이 많은 사이트라면 후원을 고려해 주시기 바랍니다. API 서버가 튼튼해야 여러분의 사이트도 튼튼해집니다.

CDN 선택 안내

무료 API 사용시 반드시 아래의 CDN 중 하나를 사용하여 Postcodify를 로딩하시기 바랍니다. search.min.js 파일을 호스팅 계정에 직접 복사하여 사용하실 경우 무료 API 서버와의 호환성이 떨어지는 문제가 발생할 수 있습니다.

Amazon CloudFront CDN (추천)

일반적으로는 아래와 같이 사용하시면 됩니다.

<script src="//d1p7wdleee1q2z.cloudfront.net/post/search.min.js"></script>

단, 익스플로러 6.0 지원이 필요한 경우 아래의 코드도 추가해 주시기 바랍니다. (익스플로러 6.0에서는 SSL을 사용할 수 없습니다.)

<!--[if IE 6]><script src="http://d1p7wdleee1q2z.cloudfront.net/post/search.min.js"></script><![endif]-->

개발자가 직접 관리하며, Postcodify 새 버전 발표시 24시간 내에 업데이트됩니다. 언제나 무료 API 서버와 호환되는 버전을 제공합니다. 서울을 비롯한 세계 20여 곳에 전송 서버를 두고 있습니다.

특별한 이유가 없다면 공식 CDN을 사용하시기 바랍니다. 팝업창 기능과 CSS 파일들은 현재 이곳을 통해서만 제공되고 있습니다.

개발서버 CDN

<script src="//cdn.poesis.kr/post/search.min.js"></script>

Amazon CloudFront보다 조금 더 빨리 업데이트되지만, 개발서버의 특성상 안정성이 다소 떨어질 수도 있습니다. 다른 CDN 접속이 용이하지 않을 경우 (예: 특정 국가에서 공식 접속을 차단한 경우) 이곳을 사용하셔도 됩니다.

CDNJS

<script src="//cdnjs.cloudflare.com/ajax/libs/jquery.postcodify/3.4.1/search.min.js"></script>

세계적인 자바스크립트 전문 CDN입니다. 버전을 지정해야 하므로 Postcodify 새 버전이 나오면 매번 URL의 버전을 변경해 주어야 한다는 단점이 있으나, 반면 꼬박꼬박 업데이트만 해주면 언제나 최신 버전을 사용할 수 있다는 장점도 있습니다.

검색 서버를 직접 구축하여 사용하시는 경우에는 검색 서버의 버전과 search.min.js 파일의 버전이 일치해야 하므로, 이곳처럼 특정한 버전을 지정할 수 있는 CDN에서 로딩하시는 것도 좋은 생각입니다.

jsDelivr

<script src="//cdn.jsdelivr.net/jquery.postcodify/3.4.1/search.min.js"></script>

또다른 자바스크립트 전문 CDN으로, CDNJS와 유사한 장단점을 갖고 있습니다.

버전을 latest로 지정하면 매번 버전을 변경해 주지 않아도 되지만, 이전 버전이 브라우저에 캐싱되어 있는 경우 최장 1년간 업데이트가 이루어지지 않을 수도 있으므로 실제로는 사용자가 어떤 버전을 사용하게 될지 예측이 불가능합니다.

원본인 search.js는 주석처리가 꼼꼼하게 되어 있고 소스를 읽기 편하지만, 용량이 커서 대부분의 CDN에서는 취급하지 않습니다. 압축 버전인 search.min.js는 불필요한 주석과 공백 등을 제거하여 용량을 1/3로 줄인 파일입니다. 개발 및 디버깅시에는 원본을 사용해도 무방하지만, 실제 운영하는 사이트에는 압축 버전을 사용해야 페이지 로딩 시간과 트래픽을 절약할 수 있습니다.