바로가기 메뉴
본문내용 바로가기
메인메뉴 바로가기

로그인 닫기

로그인하기
닫기
오픈API

검색 API 1.0 레퍼런스

검색 API 1.0 레퍼런스입니다.
소개
  • 검색엔진을 이용한 주소 및 장소 검색 API
요청 URL
요청 URL
http://map.vworld.kr/search.do?apiKey=인증키&[검색 파라미터]
요청변수
요청변수
항목명 설명
callback output값이 json일 경우 callback함수를 지원
q 검색 키워드
category Poi / Jibun / Juso. 세종류의 값을 입력하여 해당하는 검색대상을 설정합니다.
Poi 는 장소 검색. Jibun은 지번주소 검색. Juso는 도로명주소 검색입니다. / default : Poi
pageUnit 한페이지에 나올 검색결과 갯수를 정의합니다.
output xml / json. 두 종류의 값을 입력하여 원하는 결과 형태를 설정합니다.
pageIndex 페이지 번호입니다.
apiKey 발급받은 api key 입니다.
사용예제
장소(POI) 검색 예제
  • http://map.vworld.kr/search.do?category=poi&q=공간정보산업진흥원&pageunit=10&output=json&pageindex=1&apiKey=[KEY]
지번주소(JIBUN) 검색 예제
  • http://map.vworld.kr/search.do?category=jibun&q=성남시 분당구 삼평동 624-1&pageunit=10&output=json&pageindex=1&apiKey=[KEY]
도로명주소(JUSO) 검색 예제
  • http://map.vworld.kr/search.do?category=juso&q=성남시 분당구 판교로 242&pageunit=10&output=json&pageindex=1&apiKey=[KEY]
응답변수(category=Poi)
응답변수(category=Poi)
항목명 타입 설명 비고
category 문자 Poi, 반환결과 카테고리 공통
Poi 문자 명칭(Poi) 검색건수 Poi
pagenationInfo - 검색결과의 페이지네비게이션 정보를 담는다. 공통
totalRecordCount 숫자 검색결과 합계건수 공통
totalPageCount 숫자 검색결과 페이지건수 공통
lastPageNo 숫자 현재페이지 기준 페이지그룹의 마지막 페이지번호 공통
firstPageNo 숫자 현재페이지 기준 페이지그룹의 첫번째 페이지번호 공통
currentPageNo 숫자 현재페이지번호 공통
LIST - 검색결과의 item 목록 공통
item - 검색결과의 item(output=xml) 공통
nameFull 문자 Poi 명칭 Poi
nameDp 문자 Poi 부명칭 Poi
codeName 문자 Poi 분류 Poi
nId 문자 Poi id Poi
njuso 문자 도로명주소 Poi
juso 문자 지번주소 Poi
xpos 숫자 경도 좌표(WG84) 공통
ypos 숫자 위도 좌표(WG84) 공통
PNU 문자 PNU Poi
NCODE 문자 Poi 분류코드 Poi
RD_NM 문자 도로명 Poi
응답변수(category=Jibun)
응답변수(category=Jibun)
항목명 타입 설명 비고
category 문자 Jibun, 반환결과 카테고리 공통
Jibun 숫자 지번(Jibun) 검색건수 Jibun
pagenationInfo - 검색결과의 페이지네비게이션 정보를 담는다. 공통
totalRecordCount 숫자 검색결과 합계건수 공통
totalPageCount 숫자 검색결과 페이지건수 공통
lastPageNo 숫자 현재페이지 기준 페이지그룹의 마지막 페이지번호 공통
firstPageNo 숫자 현재페이지 기준 페이지그룹의 첫번째 페이지번호 공통
currentPageNo 숫자 현재페이지번호 공통
LIST - 검색결과의 item 목록 공통
item - 검색결과의 item(output=xml) 공통
JUSO 문자 주소(지번주소) Jibun
xpos 숫자 경도 좌표(WG84) 공통
ypos 숫자 위도 좌표(WG84) 공통
응답변수(category=Juso)
응답변수(category=Juso)
항목명 타입 설명 비고
category 문자 Juso, 반환결과 카테고리 공통
Juso 숫자 도로명(Juso) 검색건수 Juso
pagenationInfo - 검색결과의 페이지네비게이션 정보를 담는다. 공통
totalRecordCount 숫자 검색결과 합계건수 공통
totalRecordCount 숫자 검색결과 합계건수 공통
lastPageNo 숫자 현재페이지 기준 페이지그룹의 마지막 페이지번호 공통
firstPageNo 숫자 현재페이지 기준 페이지그룹의 첫번째 페이지번호 공통
currentPageNo 숫자 현재페이지번호 공통
LIST - 검색결과의 item 목록 공통
item - 검색결과의 item(output=xml) 공통
JUSO 문자 주소(도로명주소) Juso
xpos 숫자 경도 좌표(WG84) 공통
ypos 숫자 위도 좌표(WG84) 공통
ZIP_CL 문자 우편번호 Juso
BLD_NM 문자 건물명 Juso
맨위로