안녕하세요?

자료실에 플러그인 형태로도 올라가 있는

오픈소스 도로명주소 검색 API Postcodify 개발자입니다.

SIR 도로명주소 서비스 종료된다고 엊그제부터 대자보가 붙었네요. 몇 달 전부터 예고되었음에도 불구하고, 겨우 보름을 남겨둔 이제서야 A/S 때문에 고생하시는 분들이 주위에 꽤 보입니다.

코어 업데이트가 가장 바람직한 방법이겠고, 업데이트가 힘든 분들을 위해 관련 패치가 별도로 올라와 있긴 하지만, 그래도 커스터마이징을 꽤 많이 한 사이트라면 일일이 적용하고 테스트하기 힘드시죠? 아니면 그냥 다음 API가 맘에 들지 않으실 수도 있고요 ㅡ.ㅡ;; (주소검색 API는 사용자 취향을 많이 타더군요. 그래서 저도 함부로 제꺼 쓰라고 말씀드리지 못합니다.) 

아무튼 그래서 제가 운영하는 Postcodify 무료 API를 기존의 SIR 검색 API와 동일한 포맷으로 변환한 버전을 제공하기로 했습니다.

기존 그누보드 소스의 js/zip.js 파일에서

    //juso.sir.co.kr/search.php

라고 되어 있는 부분을 

    //api.poesis.kr/post/search.php

라고 바꾸시면 

다른 것 전혀 바꾸실 필요 없이 기존의 소스를 계속 사용하실 수 있습니다.

SIR 공식 API가 아닌 유사품(?)을 사용하고 있다는 의미로 우측 구석에 "Powered by Postcodify" 메시지가 뜨는 것 외에는 100% 동일하게 작동합니다. 물론, 내부적인 알고리듬의 차이 때문에 검색 결과의 갯수가 약간 다를 수는 있습니다. 

SIR 검색 API 호환 기능에 대해 더 자세한 정보는 이곳에서 읽으실 수 있습니다. 

< 참고 >

1. 단지 오픈소스가 좋아서 만들고 운영하는 무료 API입니다. 남에게 피해주지 않도록 살살 써주세요. 일일 쿼리수 제한은 Postcodify에서 제공하는 플러그인을 사용하실 때와 동일하게 적용됩니다.

2. Powered by 메시지가 보기 싫으시면 CSS 스타일을 아래와 같이 넣어주면 됩니다. 절대 문제삼지 않겠습니다.

    div.powered_by_postcodify { display: none; }

3. 궁금한 점이 있으시면 여기에 댓글을 달거나 Postcodify 공식 사이트의 메일주소로 문의해 주세요.

4. 문 닫을 계획은 전혀 없으나, 안정적인 운영을 위해 최선을 다하겠다는 것 외에 특별한 약속을 드릴 수는 없습니다. 예를 들어 제가 내일 아침에 뺑소니당하면 끝일지도 모릅니다 ㅋ 그러나 Postcodify는 모든 소스가 공개되어 있으므로 직접 검색서버를 만들어 쓸 수 있습니다. PHP와 MySQL만 있으면 됩니다. SQLite 버전을 통째 서버에 복사해 놓고 써도 되고요. 즉, 제가 뺑소니를 당하더라도 안심하고 쓰실 수 있습니다 ^^ (SIR 검색 API와 동일한 포맷으로 변환하는 소스도 공개되어 있습니다.) 

5. 적용 도중 문제가 있을 경우 웹브라우저의 관리자도구(F12) → "네트워크" 탭을 사용하여 실제로 api.poesis.kr 서버에 GET 요청이 이루어지고 있는지 확인해 주시기 바랍니다. (스크린샷 참고) 그누보드는 워낙 다양하게 커스터마이징이 되곤 해서 정확히 어디가 안 되는지 찾기가 어려울 수도 있습니다. 

6. Postcodify는 CloudFlare CDN을 사용하고 있습니다. 최근에 발표된 "푸들" 취약점 때문에 CloudFlare에서 SSLv3 지원을 중단하고 TLSv1 이상 버전만 사용하게 되었습니다. SSLv3와 TLSv1은 보안서버 통신에 사용되는 프로토콜의 일종으로, 대부분의 브라우저는 TLSv1을 지원합니다. 그러나 IE6은 TLSv1을 지원하지 않으므로, IE6에서는 보안서버(https)를 사용한 API 이용이 불가능하게 되었습니다. 만약 보안서버(https)를 적용한 페이지에서 IE6 지원이 필요하다면 위의 방법으로는 안 되니 그누보드를 업데이트하신 후 다음 API 또는 자료실의 Postcodify 플러그인을 사용해 주시기 바랍니다. 

7. 그래도 웬만하면 그누보드 최신버전으로 업데이트하세요. 보안취약점 고쳐진 게 한두 가지가 아닌데... 다음 API가 정말 싫으신 분은 일단 업데이트하신 후 제가 자료실에 올려둔 Postcodify 플러그인을 설치하셔도 됩니다. 

8. 새우편번호(기초구역번호) 입력이 필요하신 분은 매뉴얼을 참고하여 URL을 변경하시면 됩니다. [2015.06.26 추가]