참조 데이터 및 인리치먼트
3,400만 행, 하나의 단계로
국가, 언어, 통화. 1,340만 개의 인구 밀집 지역과 지리적 지형. 1,900만 개의 이름 변형. 200만 개의 우편번호. 공항, 항만, 차량 브랜드. 65개 엔드포인트, 인증 불필요, 요금표 없음. 여러분의 워크플로가 이미 실행되는 같은 플랫폼 위에 있으니까요.
이것이 특별한 이유
다른 모든 자동화 도구에서 "이 주소 검증"은 유료 서드파티 통합이에요. 벤더를 찾고, 계정을 열고, 요금표에 합의하고, 키를 발급받고, 키를 저장하고, 할당량을 지켜보고, 사용량이 바뀌면 재협상해야 해요. 조회 자체는 20밀리초 걸리지만, 조달은 2주가 걸려요.
여기서는 선택기의 한 단계예요. 이 데이터는 공개 참조 데이터 — GeoNames, 공식 코드 목록, 공개 등록부 — 로, castomAPI가 정리하고 색인하고 제공해요. 이 제품군의 열두 제품이 같은 것을 필요로 했고, 열두 번 만드는 것보다 한 번 만드는 게 저렴했기 때문에 존재하는 서비스예요.
검색은 트라이그램(trigram) 기반이며 최소 세 글자가 필요해요. 그래서 이름의 일부만 입력하거나 철자가 틀려도 해당 장소를 찾을 수 있어요. 이 최소 글자 수는 의도된 거예요. 두 글자면 모든 항목이 일치해 버리고, 모든 것에 일치하는 조회는 아예 조회하지 않는 것보다 나쁘거든요.
사람들이 이걸로 하는 세 가지 일
검증 — 잘못된 데이터를 문 앞에서 막아요. 그 도시의 실제 우편번호인가요? 그 국가 코드가 존재하나요, 아니면 2019년에 누군가 입력한 이후 계속 전파되고 있는 오타인가요? PLN은 통화인가요, 그리고 이 고객에게 청구해야 할 바로 그 통화인가요?
정규화 — “Warsaw”, “Warszawa”, “Varsovie”, “Варшава”는 하나의 식별자를 가진 한 장소예요. 1,900만 개의 이름 변형이 존재하기 때문에, 고객 데이터베이스가 같은 도시의 네 가지 철자를 마치 네 개의 도시인 것처럼 보관할 필요가 없어요.
보강 — 도시 이름이 좌표, 시간대, 행정 구역, 인구 수치가 돼요. 공항 코드는 이름과 위치가 돼요. 우편번호는 계층 상위의 모든 정보가 돼요. 사람이 직접 입력했어야 할 여섯 개 필드가 20밀리초 만에, 공짜로 채워져요.
시간대는 조용한 존재예요
장소를 해석하면 그 시간대를 얻게 되고, 시간대야말로 “오전 아홉 시에 보내기”가 보내는 사람의 오전 아홉 시가 아니라 받는 사람의 오전 아홉 시를 의미하게 해줘요. 조용한 시간, 일정, 알림이 모두 국제 수신자 목록에서 정확해지고, 아무도 매핑 테이블을 관리할 필요가 없어요.
- 1입력“포프스탄추프 실롱스키흐 거리 5, 53-332 브로츠와프, 폴란드”
- 2우편번호 일치53-332 → 브로츠와프, 돌니실롱스크주, 폴란드.
- 3지역 확인 완료51.0938 N, 17.0226 E · Europe/Warsaw · 인구 674 079.
- 4기록됨사람이 직접 입력했어야 할 여섯 개의 필드가 채워졌어요.
- §비용결정론적 단계예요. 키도, 할당량도, 조회당 요금도 없어요.
소요 시간: 40 ms사용 가능한 엔드포인트 65개

3,400만 행. 단 한 단계.
실제 예제
빛을 발하는 순간
택배사에 도달하기 전에
배송 라벨을 구매하기 전에 주소를 검사하고 정규화해요. 거부된 라벨은 수수료와 하루를 잃게 하지만, 거부된 우편번호는 20밀리초밖에 잃지 않아요.
회계사에게 도달하기 전에
송장이 발행되기 전에 통화 코드와 국가 코드를 검증해요. 보낸 후에 검증하는 것보다 훨씬 저렴하죠.
목록 중복 제거
같은 도시를 두 가지 철자로 적은 두 레코드도, 두 도시가 같은 식별자로 해석되면 제대로 병합돼요.
지리 기반 라우팅
고객의 좌표와 창고의 좌표를 두면, 실행 시 가장 가까운 곳을 선택해요. 아무도 우편번호-창고 스프레드시트를 관리할 필요가 없어요.
언어, 정확하게
국가가 해당 언어들로 해석되기 때문에, 발송되는 메시지는 수신자가 아마 읽을 수 있는 언어로 나가요. 깃발에 대한 추측이 아니라 데이터로 결정되는 거죠.
차량과 물류
차량 제조사, 공항, 항구를 정규 레코드로 제공해요. 무언가가 물리적으로 이동하는 일이 포함된 워크플로를 위해서예요.
솔직한 한계
이것은 상업용 주소 검증 서비스가 아니라 공개 참조 데이터예요. 53-332가 Wrocław의 실제 우편번호라는 것과 해당 지역의 좌표는 알려주지만, 5번지에 212호가 실제로 존재하는지, 거기에 사는 사람이 있는지는 알려주지 않아요. 배송지 단위 검증이 필요하면 국가 우편 사업자의 제품을 사용하시고, 워크플로에서는 이것과 함께 HTTP로 호출할 수 있어요.
또한 개인 데이터의 출처도 아니에요. 여기에는 사람이 없어요. 장소, 코드, 등록부, 공개 사실만 담고 있어요 — 바로 그래서 인증 없이 제공될 수 있는 거예요.
신선도에 대해: 참조 데이터는 천천히 바뀌고, 이 데이터는 지속이 아니라 일정에 따라 갱신돼요. 새로 이름이 바뀐 마을이 같은 날 오후에 나타나지는 않아요. 시간 단위로 바뀌는 것이 필요하면 정확히 그 용도로 만들어진 이벤트 피드를 사용하세요.