>OPEN API>검색 API

검색 API

도로명주소 검색

웹 사이트에서 손쉽게 서울시 도로명주소안내시스템의 도로명주소 검색결과(XML)를 이용하실 수 있습니다.

요청 URL

http://juso.seoul.go.kr/OpenApi/Search_ApiEx.aspx

요청 변수 (Request Parameter)

요청변수 목록
요청변수 설명
key string (필수) 이용 등록을 통해 받은 key 스트링을 입력합니다.
target string (필수) newaddress
page integer (필수) 검색결과 출력 페이지 번호를 입력합니다.
rpp integer (필수) 결색결과 출력 페이지당 레코드 건수를 입력합니다. 결색결과 전체 출력 : page=1&rpp=0
sggnm string (선택) 시 명칭을 입력합니다. 
emdcd string (선택) 시 코드(5자리) 또는 동 코드(8자리)를 입력합니다.
emdnm string (선택) 동 명칭을 입력합니다.
rdnm string (선택) 도로구간 명칭. 구 단위별 도로구간 검색시 도로구간 코드 6자리와 함께 사용하십시오. 
jibun1 integer (선택) 건물번호 본번
jibun2 integer (선택) 건물번호 부번

샘플 URL

예 1) 강남구 (구코드)
http://juso.seoul.go.kr/OpenApi/Search_ApiEx.aspx?key=test&target=newaddress&emdcd=11680&rdnm=&jibun1=&jibun2=&page=1&rpp=10

예 2) 강남구 개포동 (동코드)
http://juso.seoul.go.kr/OpenApi/Search_ApiEx.aspx?key=test&target=newaddress&emdcd=11680103&rdnm=&&jibun1=&jibun2=&page=1&rpp=10

예 3) 강남구 개포동 개포로 (동코드+도로구간(코드+명칭))
http://juso.seoul.go.kr/OpenApi/Search_ApiEx.aspx?key=test&target=newaddress&emdcd=11680103&rdnm=%EA%B0%9C%ED%8F%AC%EB%A1%9C&jibun1=&jibun2=&page=1&rpp=10

예 4) 강남구 개포동 개포로 303 (동코드+도로구간(코드+명칭)+건물번호본번)
http://juso.seoul.go.kr/OpenApi/Search_ApiEx.aspx?key=test&target=newaddress&emdcd=11680103&rdnm=%EA%B0%9C%ED%8F%AC%EB%A1%9C&jibun1=303&jibun2=&page=1&rpp=10

출력 결과 구조(Response XML)

<BUILDINGS> <!-- XML 루트 --> <RESULTS> <!-- 검색결과 --> <ROWCOUNT>6</ROWCOUNT> <!-- 검색결과 개수 --> </RESULTS> <BUILDING> <SEQ>1</SEQ> <!-- 일련번호 --> <BD_MGT_SN>299278</BD_MGT_SN> <!-- 건물일련번호 --> <SGG_CD>11680</SGG_CD> <!-- 구 코드 --> <SGG_NM>강남구</SGG_NM> <!-- 구 명칭 --> <EMD_CD>1168010300</EMD_CD> <!-- 동 코드 --> <EMD_NM>개포동</EMD_NM> <!-- 동 명칭 --> <LNDN_MA_SN>653</LNDN_MA_SN> <!-- 지번 본번 --> <LNDN_SB_SN>0</LNDN_SB_SN> <!-- 지번 부번 --> <BD_NM>현대1차아파트</BD_NM> <!-- 건물명 --> <DET_BD_NM>104동</DET_BD_NM> <!-- 상세건물명 --> <RD_NM>개포로</RD_NM> <!-- 도로번호 --> <BD_MA_SN>303</BD_MA_SN> <!-- 건물번호 본번 --> <BD_SB_SN>0</BD_SB_SN> <!-- 건물번호 부번 --> </BUILDING> <BUILDING> <SEQ>2</SEQ> <BD_MGT_SN>299279</BD_MGT_SN> <SGG_CD>11680</SGG_CD> <SGG_NM>강남구</SGG_NM> <EMD_CD>1168010300</EMD_CD> <EMD_NM>개포동</EMD_NM> <LNDN_MA_SN>653</LNDN_MA_SN> <LNDN_SB_SN>0</LNDN_SB_SN> <BD_NM>현대1차아파트</BD_NM> <DET_BD_NM>102동</DET_BD_NM> <RD_NM>개포로</RD_NM> <BD_MA_SN>303</BD_MA_SN> <BD_SB_SN>0</BD_SB_SN> </BUILDING> ... <BUILDINGS>

보고/에러 메시지

100 : 인증되지 않은 도메인에서는 사용할 수 없습니다!
사용자가 브라우저에서 직접 호출시 발생합니다. 웹 서버에서 운영중일 때에는 발생하지 않습니다.

101 : KEY 값이 NULL 이거나 비어있습니다. KEY 값을 확인하십시오!
검색API 호출시 key가 없으면 오류를 발생합니다. 발급된 key와 함께 호출하십시오.

102 : KEY 값이 유효하지 않습니다!
등록한 도메인의 key값이 유효하지 않습니다!

103 : 요청한 값이 NULL 이거나 비어있습니다. 요청한 값을 확인하십시오!
요청 변수 및 값이 잘못 되었습니다. 2. 요청 변수를 참고 하십시오!

500 : 서버 에러
검색API 호출시 서버에서 오류가 발생하였습니다. OpenApi 가이드를 참고하십시오!