피드로 돌아가기
컬리 기술블로그Backend
원문 읽기
주소정제 서비스 내재화 - 1화 ( 줄줄 새는 돈 )
컬리가 외부 주소정제 서비스 의존성을 제거하기 위해 도로명주소 내재화 프로젝트 시작, 월 300~700만원 비용 절감 목표
AI 요약
Context
컬리는 배송 주소정제를 외부 업체 API에 의존하며 월 300~700만원(최대 3,000만원)의 비용을 지불하고 있었다. 신축 아파트 등 신규 주소가 외부 서비스에 반영되지 않아 하드코딩 대응이 필요했고, 서비스 확장 시 외부 의존성이 병목이 될 우려가 있었다.
Technical Solution
- 도로명주소 내재화 의사결정: 23년 5월부터 대한민국 주소체계 도메인 지식 학습 및 리서치 진행
- 주소정제 목적 재정의: 고객 입력주소(지번 또는 도로명)를 올바른 도로명주소로 변환 + 정확한 위경도 산출
- 복합건물 처리 전략: 기본주소(도로명+건물번호)만으로는 부족한 경우, 상세주소의 동 정보를 활용해 정확한 건물 특정
- 오입력 케이스 대응: 시/도 명칭 통일(서울시→서울특별시), 도로명과 건물번호 분리, 누락 정보 보충, 지번→도로명 변환
- 건물관리번호 활용: 행정안전부에서 관리하는 25자리 건물 고유식별자(건물관리번호)를 주소정제의 기본 단위로 설정
Impact
프로젝트 완료 기간: 23년 5월 리서치 시작 → 24년 9월 30일 완전 내재화(약 1년 3개월) 월간 외부 서비스 비용: 300~700만원 지출 제거
Key Takeaway
주소정제는 단순한 위경도 조회가 아니라 다양한 입력 형식을 표준화하고 오배송을 방지하는 데이터 정제 프로세스다. 국가 공공데이터(건물관리번호, 도로명주소 API)와 도메인 이해를 기반으로 외부 서비스 의존성을 제거할 수 있다.
실천 포인트
이커머스·배송 서비스에서 주소정제를 외부 API에 의존할 때, 국가 행정안전부의 공개 API(도로명주소 조회)와 건물관리번호를 기반으로 내재화를 검토하면 월간 수백만원대 비용을 절감하고 신규 주소 지원 시간을 단축할 수 있다.