SEARCHADDRESS¶
종류: EGTools 전용 함수
주소를 검색합니다(도로명주소 juso.go.kr).
구문¶
=SEARCHADDRESS(텍스트, [출력항목], [행], [api_key])
인수¶
| 인수 | 필수 | 설명 |
|---|---|---|
| 텍스트 | 필수 | 검색할 주소 키워드 |
| 출력항목 | 선택 | 출력할 열 1~27, {1,2}처럼 배열 가능: 1 우편번호, 2 도로명주소(기본), 3 지번주소, 4 영문주소 |
| 행 | 선택 | 출력할 행 번호, 0/생략이면 전체 |
| api_key | 선택 | juso.go.kr 승인키, 1회 입력하면 레지스트리에 저장 |
반환¶
검색된 주소를 선택한 출력항목 열로 구성한 텍스트 배열로 반환하며 스필됩니다(행=0이면 전체, 최대 100건). 검색어가 비었거나 출력항목이 1~27을 벗어나면 #VALUE!, 결과가 없으면 #N/A를 반환하고, 키 누락·네트워크·서비스 오류는 "ERROR: …" 텍스트로 반환합니다.
예제¶
| 수식 | 결과 | 설명 |
|---|---|---|
=SEARCHADDRESS("세종대로 110") |
도로명주소 검색(네트워크·API 키 필요) | |
=SEARCHADDRESS("세종대로 110",{1,2},1) |
우편번호+도로명주소 1행(네트워크·API 키 필요) |
참고¶
- API 키는 배포되지 않습니다. 주소기반산업지원서비스에서 발급받아 마지막 인수로 1회 입력하면 레지스트리에 저장되어 이후 생략할 수 있습니다.
- 서비스가 키를 거부하면(만료/미등록) 저장된 키를 자동 삭제하고 재발급 안내를 반환합니다.
- 출력항목 전체 목록(1~27)은 아래 표와 같습니다. 기본값은 2(도로명주소)이며 {1,2}처럼 배열로 여러 열을 지정할 수 있습니다.
| 번호 | 필드 | 내용 |
|---|---|---|
| 1 | zipNo | 우편번호 |
| 2 | roadAddr | 전체 도로명주소(기본값) |
| 3 | jibunAddr | 지번주소 |
| 4 | engAddr | 도로명주소(영문) |
| 5 | roadAddrPart1 | 도로명주소(참고항목 제외) |
| 6 | roadAddrPart2 | 도로명주소 참고항목 |
| 7 | admCd | 행정구역코드 |
| 8 | rnMgtSn | 도로명코드 |
| 9 | bdMgtSn | 건물관리번호 |
| 10 | detBdNmList | 상세건물명 |
| 11 | bdNm | 건물명 |
| 12 | bdKdcd | 공동주택여부(1: 공동주택, 0: 비공동주택) |
| 13 | siNm | 시도명 |
| 14 | sggNm | 시군구명 |
| 15 | emdNm | 읍면동명 |
| 16 | liNm | 법정리명 |
| 17 | rn | 도로명 |
| 18 | udrtYn | 지하여부(0: 지상, 1: 지하) |
| 19 | buldMnnm | 건물본번 |
| 20 | buldSlno | 건물부번 |
| 21 | mtYn | 산여부(0: 대지, 1: 산) |
| 22 | lnbrMnnm | 지번본번(번지) |
| 23 | lnbrSlno | 지번부번(호) |
| 24 | emdNo | 읍면동일련번호 |
| 25 | hstryYn | 변동이력여부 |
| 26 | relJibun | 관련지번 |
| 27 | hemdNm | 관할주민센터 |
- 검색어·api_key에 배열을 지정하면 #VALUE!를 반환합니다(api_key는 저장 전에 거부되어 잘못된 키 저장을 방지) — 여러 건은 수식을 행별로 복사해 사용합니다.
- 지원: Excel 2010+. 모든 Excel 버전에서
SEARCHADDRESS이름 그대로 등록됩니다.