문서

주소정제 서비스 내재화 - 5화 ( 어질어질한 변화구들 )

이준환 컬리 · 컬리 기술 블로그

AI 핵심 요약

단독건물 주소정제만으로는 외부 API 호출 트래픽을 충분히 줄일 수 없어, 상세 동 정보가 필요한 아파트·빌라 등 복합건물 정제에 착수했다. 정제 결과를 EXACT부터 NONE까지 정확도 레벨로 나누고, 고객 입력과 행안부 건물 DB의 표기를 전처리해 비교했으며, 기본주소에서 동을 찾지 못하면 주변 건물을 탐색해 유일한 후보가 있을 때만 주소를 보정하는 HIGH 레벨 로직을 만들었다. 행안부 건물 관리 백오피스와 테스트 코드를 함께 활용해 데이터 오류와 다양한 입력 패턴을 관리하고, 배송 실패나 배송 불가 지역 판정 오류 가능성도 줄이고자 했다. 복합건물 정제 이후 외부업체 API 호출은 눈에 띄게 줄었고, 정확도 레벨은 운영 이슈를 분류하고 개선 우선순위를 정하는 기준이 됐다.

복합건물 주소는 기본주소만으로 배송 위치를 특정할 수 없으므로 상세 동 정보까지 정제해야 한다.
주변 건물 탐색은 반경과 건물관리번호 앞 14자리, 단지명 토큰을 활용하고, 후보가 하나일 때만 다른 단지 주소로 보정한다.
고객 입력과 행안부 건물명은 숫자·한글·알파벳 표기를 정규화한 뒤 비교하면 동호수 순서나 표기 차이에 대응할 수 있다.
정제 결과를 정확도 레벨로 분류하고 테스트 코드와 변경 이력을 관리하면 패치 영향과 운영 이슈를 추적하기 쉽다.
주소 관리 백오피스에 주변 건물 조회, 위치 수정, 변경 이력, 캐시 삭제 기능을 두면 데이터 보정과 CS 대응에 활용할 수 있다.

소개

복합건물 (아파트, 다세대 주택) 주소정제 정복

비슷한 학습 자료

컨퍼런스 당근 밋업

복잡한 공간 데이터를 가볍고 빠르게 서빙하기 | 2025 당근 플랫폼 밋업

컨퍼런스 당근 밋업

이 세션에서는 행정구역·아파트·역세권 등 다양한 영역에 대한 좌표의 존재 판정을, 매번 무거운 공간 연산을 반복하지 않고 사전 계산된 영역을 기반으로 가볍고 빠르게 처리하는 방법을 소개합니다. 또한 서로 다른 출처의 공간 데이터를 세트(Set)·버전(Version)·식별자(ID) 모델로 표준화하고 스냅샷 기반 버저닝으로 일관성과 재현성을 확보하는 방법과 함께 데이터 파이프라인·증분 업데이트·품질 검증 프로세스를 아파트와 지하철 역세권 사례로 간단히 공유하고자 합니다. 🥕 복잡한 공간 데이터를 가볍고 빠르게 서빙하기 👉 발표 자료 보러가기: https://daangn.notion.site/2025-platform-meetup-slide 👉 당근 채용공고 보기: https://about.daangn.com/jobs/

데이터베이스 데브옵스 · 인프라