도로명과 지번이 달라 보여도 같은 곳일까? APICK 주소 동일성 판정 활용법
이 글은 에이픽 운영 측에서 AI의 도움을 받아 작성한 서비스 소개입니다. 공식 공개 문서를 확인했으며, 실제 고객 데이터 조회나 유료 API 실행 결과를 제시하는 체험 후기는 아닙니다.
거래 문서의 주소와 내부 지점 목록이 다르면 담당자는 두 장소가 같은지 다시 지도에서 찾아보게 됩니다. 표기 차이인지 실제 위치 차이인지 먼저 구분할 수 있다면 검토가 수월해집니다. 에이픽 주소 동일성 판정 API는 두 주소의 비교 결과를 제공하므로 지점 자료를 대조하는 화면에 연결해 볼 수 있습니다.
1. 두 주소가 어디에서 왔는지 함께 표시합니다
요청 항목은 addressA와 addressB입니다. 비교 화면에서는 “새 문서의 주소”와 “기존 지점 주소”처럼 각 입력의 출처를 구분하세요. 둘 중 어느 쪽이 최신인지 모르는 상태에서 결과를 보고 한쪽을 자동으로 덮어쓰면 원래 차이를 확인하기 어려워집니다.
가상의 지점 관리 업무라면 문서 번호, 내부 지점 번호, 양쪽 원문 주소를 연결한 비교 카드를 만들 수 있습니다. 한 건의 비교 결과는 그 주소 쌍에만 적용해야 합니다. 이름이 같은 다른 지점이나 근처 건물까지 같은 결과로 처리하지 않고, 비교 당시 사용한 입력값을 그대로 남기는 방식이 좋습니다.
2. same_parcel과 near를 다른 판단으로 읽습니다
공식 verdict 설명은 same_parcel, near, different를 구분합니다. same_parcel은 필지번호가 같은 경우이며, near는 필지번호가 다르거나 확인되지 않았지만 두 지점이 50m 이내인 경우입니다. 가까운 두 장소를 같은 장소로 확정하는 용도로 near를 사용하지 않는 것이 핵심입니다.
가상의 예로 큰 건물 주변 두 주소가 가까이 잡혔다면 지도에서 입구나 동을 더 확인할 질문이 생깁니다. “거리 30m이므로 동일 지점” 같은 자동 결론보다 “근접 위치, 추가 확인 필요”라는 검토 상태가 적절할 수 있습니다. 결과 분류를 우리 서비스의 확인 절차에 맞게 연결하되 원래 판정값도 함께 보관하세요.
3. 유사도와 필지 일치를 서로 대체하지 않습니다
similarity는 표준 표기로 바꾼 뒤 낱말이 겹치는 정도를 나타내는 0~1 값이라고 안내됩니다. 이것을 동일인 확률이나 계약 상대방의 신뢰 점수로 해석하면 안 됩니다. 주소 문자열이 비슷한 것과 필지번호가 같은 것은 다른 근거이므로 응답의 sameParcel, distanceM, reasons를 함께 읽어야 합니다.
같은 필지로 확인돼도 실제 호실이나 사용하는 공간까지 일치한다고 단정할 수는 없습니다. 여러 입주자가 있는 건물이라면 상세 주소와 업무상 지점 식별 정보를 별도로 확인하세요. 주소 비교의 목적이 방문 장소 확인인지 우편물 수령지 대사인지에 따라 필요한 확인 수준도 달라집니다.
4. 자동 병합보다 검토 근거를 보여 줍니다
화면에는 양쪽 표준화 결과와 거리, 판정 이유를 가까이 배치해 담당자가 비교 근거를 읽을 수 있게 하세요. 원문을 고치기로 했다면 확인한 사람과 변경 이유를 남기고, 판단이 불명확한 건은 보류할 수 있어야 합니다. 조회 결과가 나왔다는 이유만으로 계정이나 고객 기록을 합치는 작업은 피하는 편이 좋습니다.
도입 검토에서는 도로명·지번 표기가 다른 경우, 인접한 다른 건물, 상세 호실만 다른 경우를 별도 시험 자료로 준비해 보세요. 예시 주소는 설명용임을 표시하고 실제 개인 주소를 공개 문서에 넣지 않습니다. APICK의 비교 결과를 사용하면 사람이 확인해야 할 차이를 더 구체적으로 드러내는 작업 화면을 만들 수 있습니다.
주소 동일성 개발가이드의 verdict와 reasons를 확인해 보세요. 자동 확정이 필요한지보다 담당자에게 어떤 근거를 보여 줄지부터 설계하면 활용 방향이 선명해집니다.
공식 안내
공식 공개 자료와 화면을 바탕으로 작성했습니다. 화면별 촬영일은 캡션에 표시했습니다. 현재 이용 조건은 공식 안내에서 확인해 주세요.
댓글
댓글 쓰기