주소검색 결과항목 안내

2016.09.19

링크허브에서 제공하는 주소 API를 이용하여 주소정보 검색시 결과로 반환되는 주소정보 항목에 대해 구체적으로 안내해 드리도록 하겠습니다. 주소검색 요청시 반환되는 정보는 검색결과 항목과 주소정보 항목으로 이루어져 있습니다. 주소링크가 제공하는 주소정보는 행정자치부와 연계하여 매일 업데이트되는 최신의 주소정보를 제공하며 2015년 8월 1일부터 시행되는 새우편번호 또한 제공하고 있습니다.

주소정보 검색결과 항목

주소 API를 통해 제공되는 주소정보에 대한 항목은 다음과 같습니다. 다음의 표를 참조하여 연동환경에 필요한 주소정보 항목들을 사용하시기 바랍니다.

항목명	변수명	타입 *	비고
< 검색결과 관련정보 >
검색어	searches	String	검색문자열
제외 단어 목록	deletedWord	List	차등 검색시 제외처리된 단어 목록
수정 제시어	suggest	String	오타수정에 따라 수정된 제시어
시도별 검색결과 수	sidoCount	Map	시도별 검색결과 수, 시도명은 영문으로 반환 GANGWON 강원도, GYEONGGI 경기도, GYEONGSANGNAM 경상남도, GYEONGSANGBUK 경상북도, GWANGJU 광주광역시, DAEGU 대구광역시, DAEJEON 대전광역시, BUSAN 부산광역시, SEOUL 서울특별시, SEJONG 세종특별자치시, ULSAN 울산광역시, INCHEON 인천광역시, JEOLLANAM 전라남도, JEOLLABUK 전라북도, JEJU 제주특별자치도, CHUNGCHEONGNAM 충청남도, CHUNGCHEONGNBUK 충청북도
총 검색 결과 수	numFound	Number
주소 개수	listSize	Number	페이지 목록의 주소 개수
총 페이지 수	totalPage	Number
과금 여부	chargeYN	Boolean	이전 검색어와 동일한 검색어로 호출하거나 검색결과 미응답시 과금되지 않음
< 주소정보 리스트 >
주소정보 리스트	juso	List	검색된 결과의 해당 페이지 목록
도로명주소	ㄴ roadAddr1	String	검색된 결과의 해당 페이지 목록
도로명주소 (참고항목)	ㄴ roadAddr2	String	(법정동명, 공동주택명)
지번주소	ㄴ jibunAddr	String	검색결과에 대한 지번주소
구우편번호	ㄴ zipcode	String
새우편번호	ㄴ sectionNum	String	새우편번호 (2015. 8. 1. 시행)
상세건물명 목록	ㄴ detailBuildingName	List	해당 도로명주소의 상세건물명 목록 ex) 101동, 102동, 103동
관련지번 목록	ㄴ relatedJibun	List	건축물대장에 기재된 대표지번 외에 해당건물과 관련된 지번목록
법정동 코드	ㄴ dongCode	String	법정동 구분을 위해 부여돈 10자리 코드 시도코드(2)+시군구코드(3)+읍면동코드(3)+리코드(2)
도로명 코드	ㄴ streetCode	String	도로명에 부여된 12자리 코드 시도코드(2)+시군구코드(3)+도로명번호(7)

지금까지 주소검색 결과항목에 대해 안내해 드렸습니다. SDK 연동개발에 필요한 추가적인 정보는 아래의 언어별 개발가이드를 참조하시기 바랍니다.

▼ [참고] 언어별 SDK 개발가이드

주소링크 서비스 주소 API 이용절차에 대한 정보는 아래의 링크를 참조하시기 바랍니다.

[참고] 주소링크 서비스 주소 API 이용절차 [바로가기]

고객님들의 편의를 위하여 이메일, 전화 등 다양한 채널을 열어놓고 있으니 언제든지 연락주시기 바랍니다.

링크허브 개발팀 정요한 대리 / T.1600-8536 / D. 070-4304-2991/ E. code@linkhub.co.kr

자주하는 질문

' 카테고리에 해당되는 글

주소검색 결과항목 안내 2016.09.19