주소정제 서비스 내재화 과정과 기술적 도전
스토리 · 컬리 테크 · 2025.01.20
컬리(Kurly)에서 외부 API 의존도를 낮추기 위해 진행한 주소정제 서비스 내재화 과정에 대한 기술 블로그입니다. 전국 약 1,080만 개의 건물 DB를 구축하여 단독건물에 대한 주소정제를 직접 수행하는 시스템을 설계했습니다. AddressSearchParam 객체를 통해 도로명과 지번주소를 추출하고, 건물 DB를 조회하여 단일건물 여부를 판단하는 로직을 구현했습니다. 특히 사용자의 오입력(띄어쓰기 누락 등)을 보정하기 위한 정규식 활용과, 행정구역 명칭 변경(전라북도 $
ightarrow$ 전북특별자치도 등)과 같은 예외 상황에 유연하게 대응할 수 있도록 설계한 점이 핵심입니다. 이를 통해 단독건물 요청에 대한 외부 API 호출량을 약 60% 절감하는 성과를 거두었습니다.