PDF/비정형 공공 데이터를 JSON/CSV 정형 데이터셋으로 변환한 Lookup 최적화

Spanish Bank Codes and Postal Codes: Free Lookup Tables for Developers (2026)

ValidatorAPI2026년 5월 20일7분beginner

AI 요약

Context

스페인 IBAN 및 우편번호 시스템의 공식 데이터가 PDF나 비정형 벌크 다운로드 형태로 제공되어 개발자 접근성이 낮음. 특히 API 부재로 인해 매번 데이터를 스크래핑하고 클리닝해야 하는 높은 엔지니어링 비용이 발생함.

PDF 기반의 Banco de España 은행 레지스트리를 정형화된 JSON 포맷으로 변환하여 O(1) 시간 복잡도의 Key-Value Lookup 구조 설계
IBAN의 5~8번째 자리 Bank Code를 Key로 활용한 맵핑 테이블 구현을 통해 은행 식별 로직 단순화
우편번호 앞 2자리를 Province Prefix로 정의하여 52개 지역 매핑 테이블을 통한 빠른 지역 판별 로직 구축
INE 및 Correos의 복잡한 원천 데이터를 파싱 및 인코딩 오류 제거 과정을 거쳐 675개 행의 정제된 CSV/JSON 데이터셋으로 정규화
단순 지역 판별이 필요한 케이스를 위해 하드코딩된 Prefix 맵핑 함수를 제공하여 외부 의존성 없는 경량 구현 경로 제시

실천 포인트

1. 비정형 공공 데이터 기반 서비스 설계 시 API 존재 여부 확인 후 데이터셋 정규화 비용 산정

2. 빈번한 조회 작업이 필요한 도메인 데이터는 DB 쿼리보다 메모리 내 Lookup Table(Hash Map) 적용 검토

3. 전체 데이터셋 도입이 불필요한 경우 Prefix 기반의 Partial Mapping 전략으로 런타임 오버헤드 최소화

태그