Postcodify 매뉴얼

버전별 변경내역

Postcodify 3.5.0

2021년 12월 31일

  • 구 버전 DB를 업데이트할 경우 오류가 발생할 수 있습니다. 3.5 버전으로 생성한 DB를 사용하시기 바랍니다.
  • 행정자치부 도로명주소 사이트 URL 구조 및 다운로드 정책 변경 대응
  • GIS 데이터와 편리하게 연동할 수 있는 토지고유번호(19자리) 필드 제공
  • 정확하게 일치하는 주소 1개만 반환하는 exact=Y 파라미터 지원
  • 최대 180일까지 누적된 업데이트를 한 번에 적용할 수 있도록 지원
  • 건물 동호수 목록이 아주 긴 경우 잘려서 저장되는 문제 수정
  • 삭제된 주소 플래그 추가

Postcodify 3.4.1

2016년 12월 31일

  • 기존 우편번호 처리 관련 버그 수정
  • 행정자치부 도로명주소 사이트 리뉴얼 대응

Postcodify 3.4

2016년 5월 19일

  • 한글 로마자 변환 라이브러리를 사용해서 영문 주소를 더 정확하게 입력하도록 변경
  • 공동주택명에 불필요한 숫자가 포함되어 있는 경우의 처리 방식 개선
  • 행정자치부 데이터 파일명 변경 대응
  • 버그 수정

Postcodify 3.3

2015년 11월 25일

  • DB 생성시 기존 우편번호를 저장하지 않는 것을 기본값으로 함 (--add-old-postcodes 옵션 추가)
  • 행정자치부 데이터 파일명 변경 대응
  • 버그 수정

Postcodify 3.2

2015년 9월 30일

  • 기본 플러그인(search.js)과 팝업 레이어 플러그인(popup.js)을 하나의 파일로 합쳐 로딩속도 향상 (기존의 팝업 레이어 주소를 요청할 경우 합쳐진 파일을 반환하여 하위 호환 보장)
  • 검색어 입력란에 placeholder를 추가하여 검색에 익숙하지 않은 사용자들을 배려
  • MySQL의 sql_mode를 엄격하게 설정해 놓은 경우 인덱서 오류 수정
  • 숫자와 점이 포함된 도로명주소 키워드 처리 개선

Postcodify 3.1

2015년 7월 31일

  • 새우편번호(기초구역번호)를 기본값으로 사용하도록 변경
  • SIR 및 XE 에뮬레이션 기능에서도 새우편번호를 기본값으로 사용하도록 변경
  • 행정자치부 데이터에서 기존 우편번호가 삭제되는 것에 대비하여 인덱서 구동 방식을 일부 변경하고, DB 생성시 --no-old-postcodes 옵션을 사용하여 기존 우편번호를 누락시키는 기능 추가
  • 부트스트랩을 사용하는 페이지에서 팝업 레이어 사용시 호환성 개선
  • 팝업 플러그인의 onSelect 이벤트에 콜백함수 등록시 현재 선택된 항목에 접근할 수 없는 버그 수정

Postcodify 3.0

2015년 6월 26일

  • 아파트 동수 범위 표시를 7천여 건에서 9만여 건으로 대폭 확대하여 검색 편의 향상
  • 행정자치부 “최종안” 데이터 포맷을 사용하도록 하여 향후 장기간 안정적으로 사용할 수 있도록 함
  • DB 스키마 및 반환 데이터 포맷을 정리하고 불필요하게 중복되는 데이터를 제거하여 DB 용량을 절약하도록 함
  • 인덱서 구동 속도를 20~30% 향상하고 업데이트 실행 속도도 대폭 개선
  • 건물명, 아파트 동수 범위, 기타 주소 등을 별도의 <input>에 입력할 수 있도록 옵션 추가
  • SIR 에뮬레이션 기능 개선 (스타일 개선, 기초구역번호 지원 등)
  • 자잘한 버그 수정

Postcodify 2.5

2015년 3월 26일

  • 전국 7천여개 아파트 단지 주소에 동수 범위 (예: 201~217동) 데이터 추가
  • 팝업 레이어에서 모든 옵션을 사용할 수 있도록 개선
  • 일일변동분 중 우편번호 누락 레코드 처리 알고리즘을 개선하여 우편번호의 정확성을 높이고 업데이트 속도 향상
  • 사서함 주소 데이터 원본을 우체국에서 제공하는 새 포맷으로 교체
  • 사서함 검색시 존재하지 않는 도로명코드가 표시되는 문제 해결
  • 일부 “구” 단위의 행정구역을 검색 조건으로 인식하지 못하는 문제 해결
  • 주소 선택 후 같은 검색을 반복할 경우 검색 결과가 표시되지 않는 문제 해결
  • 지번주소 검색시 우측에 공동주택명이 표시되지 않는 문제 해결

Postcodify 2.4

2015년 3월 7일

  • 팝업 레이어 스타일 개선
  • 팝업 레이어에서 선택한 주소를 입력할 <input>의 범위를 제한하는 설정 추가
  • 팝업 레이어에서 주소 선택 후 다른 작업을 수행할 수 있도록 onSelect 이벤트 추가
  • 일일변동분 업데이트시 우편번호가 누락된 레코드가 있으면 기존 데이터를 사용하여 추측·입력하는 기능 추가
  • 숫자가 포함된 행정동 및 지번주소 검색 알고리즘 개선
  • 일부 32비트 환경에서 검색서버가 정상 동작하지 않는 문제 해결
  • 첫 검색이 공백일 경우 오류가 표시되지 않는 문제 해결
  • jQuery의 AJAX 기본 설정을 변경한 경우에도 Postcodify 검색서버 연결시에는 항상 GET을 사용하도록 조치
  • 영문주소 표기오류 다수 수정

Postcodify 2.3

2015년 1월 9일

  • 검색 결과에 기존 우편번호 대신 새우편번호(기초구역번호)를 표시하는 옵션 추가
  • 우체국 비공식 데이터를 활용하여 사서함 주소 검색시에도 새우편번호(기초구역번호)가 표시되도록 개선
  • 행정자치부 도로명주소 안내시스템 개편 이후 일일변동분 데이터가 다운로드되지 않는 문제 해결

Postcodify 2.2

2014년 11월 15일

  • 지번주소와 도로명주소, 건물명 등을 불규칙하게 혼합하여 검색하는 경우의 검색 품질 개선
  • 서버에 부하를 많이 주는 형태의 검색 결과는 Memcached 또는 Redis를 사용하여 캐싱하는 기능 추가
  • 일부 환경에서의 호환성 개선을 위해 CORS를 사용하지 않도록 설정하는 옵션 추가
  • 다른 API를 에뮬레이션할 때 EUC-KR로 인코딩된 검색어를 정상적으로 처리하지 못하는 문제 해결
  • 행정자치부 도로명주소 안내시스템 개편에 따라 주소 데이터 다운로드 스크립트 수정
  • DB 생성 후 우편번호 누락 여부를 확인하는 기능 추가

Postcodify 2.1

2014년 10월 26일

  • 레이어 팝업을 사용하여 검색창을 생성하는 기능 추가
  • 건물명 검색에 두 개 이상의 검색 키워드를 사용할 수 있도록 개선
  • 읍·면으로 검색하는 기능 추가
  • SIR 및 XE krzip API 에뮬레이션 기능 추가
  • 무료 API 서버에 CloudFlare를 적용하고 SSD 기반의 클라우드 서버로 이전하여 검색속도 향상
  • 익스플로러 6.0 호환성 개선 (네, 여전히 IE6을 사용하는 대한민국 0.1%가 있습니다.)
  • 일부 건물명이 행정구역명으로 잘못 해석되는 문제 해결

Postcodify 2.0

2014년 10월 12일

  • PHP 라이브러리를 객체지향적으로 리팩토링하고 오토로더를 제공하여 이용 및 유지보수 편의를 도모
  • PHP 5.2에서도 인덱서를 구동할 수 있도록 하고 DB 쿼리도 저장 프로시저에 의존하지 않도록 하여 호환성 향상
  • DB 스키마 및 쿼리 방식을 개선하여 DB 용량을 절반으로 줄임 (기존 6~8GB, 개선 4GB 내외)
  • 인덱서의 각 쓰레드에 주어진 시간을 최대한 활용하도록 하여 실행 속도를 30~50% 향상
  • 인덱서를 시험구동하는 기능 추가 (실제 DB를 생성하지 않고 데이터 로딩 및 파싱 기능만 테스트)
  • 업데이트 프로그램을 개선하여 데이터 누락을 방지하고 실행 속도 향상
  • 서버측 API에서 사용하는 모든 상수에 POSTCODIFY_를 붙여 다른 프로그램과의 충돌 가능성 배제
  • mysqli 및 mysql 모듈 사용시 안정성 향상
  • 관련지번 목록에서 일부 지번이 누락되는 문제 해결
  • 사서함 검색시 사서함 번호 순서대로 정렬되지 않는 문제 해결
  • 도로명주소와 지번주소를 일부 혼합하여 검색하는 경우에도 결과가 나오도록 개선
  • 우편번호 및 기초구역번호로 검색하는 기능 삭제 (결과 수가 너무 많아서 무의미함)
  • 최신 브라우저에서는 JSONP에 의존하지 않고 CORS를 활용한 일반적인 AJAX 요청을 하도록 하여 안정성 및 오류처리 정확성 향상
  • 생성하는 태그들에 postcodify_* 클래스를 추가 (기존의 postcode_* 클래스는 그대로 유지)
  • 건물번호 또는 지번을 반드시 입력하도록 하여 검색 정확도를 높이는 옵션 추가

Postcodify 1.8

2014년 7월 6일

  • DB 스키마, JSON 스키마 등에 큰 변화가 있어 이전 버전의 검색서버와는 호환되지 않음 (이전 버전의 클라이언트는 새 버전의 검색서버를 계속 이용할 수 있음)
  • 영문 주소 검색 기능 추가 (“세종대로 110” → “110 Sejong-daero”)
  • 영문으로 검색할 경우 에러 메시지도 영문으로 표시
  • 우편번호 및 기초구역번호로 검색하는 기능 추가
  • 복잡한 도로명에서 “번길”을 적지 않은 경우에도 어느 정도 검색이 가능하도록 개선
  • 도로명주소로 검색시 도로명주소 순으로 정렬, 지번으로 검색시 지번 순으로 정렬
  • 다음, 네이버, 구글 외의 지도 서비스와 연동을 원할 경우 mapLinkProvider 설정에 직접 URL을 입력할 수 있도록 함
  • 생성된 DB를 체크하는 스크립트 추가
  • 그 외 다수 버그수정

Postcodify 1.7

2014년 6월 29일

  • jQuery 플러그인을 CDN에서 로딩하도록 변경
  • 메인 검색서버 연결 실패시 백업서버에서 자동으로 재시도하는 기능 추가
  • DB를 SQLite로 변환하는 기능 추가

Postcodify 1.6

2014년 6월 27일

  • 다음, 네이버, 구글 지도 연동 기능 추가
  • 서버측에서 PHP 클래스를 직접 사용할 경우 DB 설정을 상수에 의존하지 않도록 변경
  • 검색 보조에 사용되는 시군구 목록의 오타와 잘못된 곳 몇 군데 수정

Postcodify 1.5

2014년 5월 24일

  • EUC-KR에서 표현이 되지 않거나 가운뎃점(·) 등의 특수문자가 포함된 도로명이 검색되지 않는 문제 수정
  • “남부순환로200길”을 “남부순환로 200길”로 쓰거나 “종로3가”를 “종로 3가”로 쓰는 등 불필요한 공백, “가산동 371-50”을 “가산동 371번지 50호” 등으로 늘려쓰는 경우, “철원군 철원읍”을 “철원군·읍”으로 줄여쓰는 등의 경우에도 검색이 되도록 개선
  • 검색 단추의 내용을 커스터마이징할 수 있도록 개선
  • 인덱서 실행에 필요한 파일들을 안전행정부와 우체국에서 자동으로 다운로드하는 스크립트 추가
  • 상세건물명 데이터도 인덱서에서 활용하도록 개선
  • 건물명 검색에 LIKE %검색어% 쿼리를 사용하도록 변경 (성능에 지장이 없다고 판단)
  • jQuery 플러그인에 콜백 함수 여러 개 추가
  • 그 외 다수 버그수정

Postcodify 1.4

2014년 4월 17일

  • 검색 결과에 영문 주소를 추가
  • 서버쪽 PHP API를 클래스로 정리하여 재사용 편의를 도모
  • 서버쪽 PHP 구동 환경을 PHP 5.3 이상에서 5.2 이상으로 변경하고 PDO 모듈이 없더라도 mysqli 또는 mysql 모듈을 사용할 수 있도록 하여 호환성을 개선
  • 무료 API 서버에 SSL 적용
  • 그 외 다수 버그수정

Postcodify 1.3

2014년 4월 10일

  • 라이센스를 GPLv3에서 LGPLv3으로 변경
  • DB 생성과 업데이트 적용 기능을 분리하여 각각 별도로 실행할 수 있도록 함
  • “동” 또는 “리”로 끝나는 건물명을 행정구역명으로 잘못 해석하는 문제 수정
  • jQuery 플러그인의 일부 콜백 함수에서 false를 반환하면 검색을 취소하는 기능 추가
  • 도로명주소와 참고항목 입력란을 동일한 <textarea>로 지정할 경우 정부 권고 형식대로 도로명주소와 참고항목 사이에 개행하는 기능 추가

Postcodify 1.2

2014년 3월 13일

  • 검색 결과에 지번주소를 추가
  • 검색 기능 강화 및 DB 스키마 최적화 작업

Postcodify 1.1

2014년 1월 19일

  • 오픈소스 최초 공개 (라이센스: GPLv3)
  • 검색 클라이언트를 jQuery 플러그인 형태로 리팩토링하여 재사용 편의를 도모

Postcodify 1.0

2013년 12월 24일

  • 최초 개발