지점 주소록 정비, 같은 장소를 묶어도 원본 행은 남겨 두세요: APICK 활용법

이 글은 에이픽 운영 측에서 AI의 도움을 받아 작성한 서비스 소개입니다. 공식 공개 문서를 확인했으며, 실제 고객 데이터 조회나 유료 API 실행 결과를 제시하는 체험 후기는 아닙니다.

여러 팀이 지점 명부를 관리하다 보면 같은 장소가 서로 다른 표기로 들어갑니다. 그렇다고 비슷한 주소를 지우기만 하면 다른 점포나 원본 업무 기록까지 잃을 수 있습니다. 에이픽 주소록 중복·권역 정비 API를 이용해 장소 그룹을 만들고 원본 연결을 유지하는 정비 방법을 소개합니다.

1. 지울 목록이 아니라 묶어 볼 목록을 준비합니다

먼저 정비 대상 명부와 그 안의 각 행이 의미하는 것을 확인하세요. 한 행이 물리적 장소인지, 거래 계약인지, 담당팀의 방문 대상인지에 따라 같은 주소를 처리하는 방식이 달라집니다. 같은 건물에 있다는 이유로 계약 두 건을 하나로 합쳐서는 안 되므로 주소 정비와 업무 기록 병합을 분리하는 것이 출발점입니다.

공식 요청의 addresses는 최대 50건을 받습니다. 입력 전 내부 행 번호와 원본 주소를 남겨 두고 정비 결과를 새 검토표에 붙이는 방식으로 시작해 보세요. 처음부터 운영 명부를 덮어쓰거나 중복 후보를 삭제하지 않으면 결과를 비교하고 되돌릴 기준을 유지할 수 있습니다.

에이픽 주소 목록 정비 API 소개
주소 표준화·중복·정비 결과를 묶어 제공하는 API의 공식 소개입니다. 주소록의 장소 그룹과 권역을 정리하는 공개 API 소개입니다. 화면 출처

2. 같은 지점을 묶는 근거를 읽습니다

공식 안내는 필지번호, 법정동과 번지, 좌표 소수 4자리 순서로 같은 지점을 판정한다고 설명합니다. 이 중 좌표 기준은 약 10m 수준의 위치 구분이므로 같은 좌표 묶음이 동일 점포·동일 호실을 보증한다고 해석하지 마세요. 실제 명부에 필요한 장소 단위를 담당자가 따로 확인해야 합니다.

완전히 같은 문자열은 조회 전 한 번만 확인하고, 표기가 다르지만 같은 지점인 주소는 variants로 함께 돌려줍니다. 정비표에서는 표준 주소 하나만 남기기보다 어떤 원문들이 그 아래에 묶였는지 보여 주는 구성이 유용합니다. 잘못 묶인 것으로 보이는 후보는 원본 자료와 지도 등을 통해 다시 확인할 수 있습니다.

에이픽 주소록 정비 요청 명세
공식 문서의 요청 필드와 예시입니다. 실제 고객 주소를 전송하거나 API를 실행하지 않았습니다. 정비할 주소 목록을 전달하는 정적 요청 예시입니다. 화면 출처

3. sites와 indexes로 원본 연결을 보존합니다

응답에는 sites, districts, unmatched와 요약 정보가 안내돼 있습니다. 사이트별 variants와 indexes를 활용하면 장소 그룹을 원래 입력 행에 연결하는 구조를 만들 수 있습니다. 예를 들어 영업팀과 시설팀이 각자 보유한 주소가 한 지점으로 묶여도 두 팀의 원본 기록은 유지하고 공통 장소 번호만 연결하는 방식입니다.

같은 지점을 묶은 결과와 지역별 분포도 따로 읽어야 합니다. 지점 수가 줄었다고 영업 대상이나 계약 건수가 같은 비율로 줄었다는 뜻은 아닙니다. 보고서에는 입력 행 수, 확인된 장소 그룹 수, 확인하지 못한 주소 수를 나눠 표시하면 숫자가 달라진 이유를 설명하기 쉽습니다.

에이픽 주소록 정비 응답 명세
공식 문서에 제시된 정비 결과 응답 필드입니다. 실제 고객 데이터가 아닙니다. 그룹·원본 행·미확인 주소를 연결하는 공식 응답 안내입니다. 화면 출처

4. 미확인 주소를 별도 보완 작업으로 남깁니다

찾지 못한 주소는 unmatched에서 확인합니다. 대안 후보 확인은 최대 10건까지이며 includeSuggestions로 포함 여부를 정할 수 있다고 안내됩니다. 대안이 있다고 자동으로 원본을 바꾸기보다 왜 맞는지 담당자가 확인하게 하세요. 후보가 없는 행도 누락시키지 않고 보완 담당자와 상태를 연결하는 편이 좋습니다.

정비가 끝난 뒤에는 장소 그룹을 기준으로 지도나 지역별 현황을 만들고, 업무 기록은 기존 식별자로 이어 갈 수 있습니다. 공개 가능한 사업장 자료부터 검토하며 개인 주소를 필요 없이 결합하지 않습니다. 에이픽 주소록 정비는 중복을 찾아볼 연결을 제공하므로 원본을 보존하는 검토 절차와 함께 사용할 때 실무 활용도가 높아집니다.

에이픽 주소록 정비 기준과 부분 결과
대표 주소 묶음·중복 기준·부분 처리 조건을 설명한 공식 문서입니다. 같은 지점 판정과 대안 후보 범위를 확인하는 문구입니다. 실제 주소록을 병합·삭제하지 않았습니다. 화면 출처

주소록 중복·권역 정비 가이드의 variants·indexes·unmatched 구조를 살펴보고, 삭제 대신 연결부터 시작하는 명부 정비 흐름을 만들어 보세요.

공식 안내

공식 공개 자료와 화면을 바탕으로 작성했습니다. 화면별 촬영일은 캡션에 표시했습니다. 현재 이용 조건은 공식 안내에서 확인해 주세요.

댓글

이 블로그의 인기 게시물

[들려줄밤] 페가수스 프로젝트 | 7살 아이를 과거 전쟁터로 보낸 정부의 시간여행 실험?

도로명주소 조회 API로 주문서 주소 검색 만들기: 페이지 처리와 우편번호 보존

오늘 볼 영상 6편: 소비가 멈춘 하루부터 영상 제작 과정까지 (10월 22일)