🗺️ 주소 지오코딩 API 매칭 실패율 극복 및 폴백 알고리즘 설계

안녕하세요, 리치로드 프로젝트에서 GIS(지리정보시스템) 엔지니어링과 지도 시각화 컴포넌트 설계를 이끈 K입니다. 저희 서비스에서 유저 만족도가 가장 높은 기능은 바로 고위공직자들의 부동산 보유 현황을 전국 지도에 핀으로 뿌려 시각적으로 보여주는 '자산 지도(Asset Map)'입니다. 텍스트로 된 아파트 및 토지 주소를 경위도 좌표로 바꾸는 과정을 지오코딩(Geocoding)이라고 합니다. 이 간단해 보이는 변환 과정에서 마주한 끔찍한 주소의 현실과, 저희 개발팀이 구현한 기발한 해결책인 '스마트 폴백 알고리즘'을 소개합니다.

1. 비표준 주소 데이터의 난무: 주소계의 난장판

공직자들이 작성해 낸 부동산 주소 텍스트는 표준 도로명 주소 체계와는 천만광년 떨어진 야생의 텍스트였습니다. 예컨대 다음과 같은 형식의 불규칙한 주소들이 무수히 쏟아졌습니다.

• "경기도 성남시 분당구 삼평동 624 봇들마을 7단지 아파트 701동 [본인소유]" (소유 관계 괄호 문구 삽입)
• "경상북도 안동시 풍천면 갈전리 1600번지 외 3필지" (지번 혼용 및 다중 필지 표기)
• "서울 종로구 혜화동 15-10번지 지상 2층 주택 중 201호 (배우자소유 지분 1/2)" (지분 정보 결합)

이 상태 그대로 카카오 맵 로컬 API나 국토부 브이월드(V-world) 지오코딩 API에 집어넣으면 API 엔진은 "주소 검색 결과 없음 (Status Code 404)" 에러를 뱉으며 변환율이 50% 미만으로 뚝 떨어졌습니다. 지도의 절반 이상이 하얗게 비어버리는 참극이 발생한 것입니다.

2. 리치로드 주소 정제 및 스마트 폴백 파이프라인

이 문제를 해결하기 위해 저희는 데이터 정제 파이프라인 전면에 정규표현식 클렌저(Cleanser)와 Y분석 폴백 엔진을 가동했습니다. 흐름은 다음과 같습니다.

1. 노이즈 괄호 문구 제거: 주소 뒷부분에 붙은 "[본인소유]", "(배우자지분 1/2)", "외 2필지" 등의 정형 노이즈 텍스트를 Regex 패턴으로 전부 제거하고 표준 형태의 문자열만 발라냅니다.
2. 1차 정밀 지오코딩 시도: 정제된 주소 전체로 API를 호출해 정밀 좌표(지번/도로명 수준) 변환을 노립니다.
3. 번지수 순차적 절삭 폴백 (스마트 폴백): 1차 변환 실패 시, 주소 문자열의 우측 끝 단어(호실 번호, 동 번호, 상세 지번)를 스페이스 기준으로 하나씩 잘라가며 API 재시도를 반복합니다. Y-폴백 알고리즘이 적용된 자바스크립트 모사 코드는 다음과 같습니다.

async function geocodeWithFallback(rawAddress) {
  // 1단계: 괄호 주석 및 노이즈 제거
  let cleanAddress = rawAddress.replace(/\s*\[.*?\]|\s*\(.*?\)/g, "").trim();
  cleanAddress = cleanAddress.split(" 외 ")[0].trim(); // 외 필지 제거

  const addressTokens = cleanAddress.split(" ");
  
  // 2단계: 번지수 자르며 폴백 루프 실행
  for (let i = addressTokens.length; i > 1; i--) {
    const trialAddress = addressTokens.slice(0, i).join(" ");
    try {
      const response = await callGeocodingAPI(trialAddress);
      if (response.success) {
        return {
          coords: response.coords,
          precision: i === addressTokens.length ? "EXACT" : "APPROXIMATE",
          level: i // 매칭에 성공한 주소 토큰 깊이 저장
        };
      }
    } catch (e) {
      console.error("Geocoding Error:", e);
    }
  }
  return null; // 최종 실패
}

3. 97.2% 매칭 성공의 결과와 GIS 시사점

스마트 Y-폴백 알고리즘 도입 결과, 리치로드의 주소-좌표 변환 성공률은 기존 48.7%에서 무려 97.2%로 비약적으로 향상되었습니다. 완벽한 지번 주소가 아니더라도 최소한 읍·면·동 단위 혹은 구·군 단위의 중심 좌표(APPROXIMATE 수준)로 지도 상에 공직자의 부동산 보유 현황이 촘촘히 맵핑되었습니다. 이러한 기술적 땀방울이 모여, 일반 시민 누구나 지도로 공직자 부동산 보유 클러스터를 입체적으로 확인할 수 있게 되었습니다. 오픈소스 GIS 데이터 정제의 실전 모범 사례로서 타 프로젝트에도 큰 보탬이 되기를 바랍니다.