OpenAPI

> OpenAPI > OpenAPI 매뉴얼 > 상가업소 조회

상가업소 조회 명세

오퍼레이션 내용

오퍼레이션 내용 설명
내용 상가업소를 조회하는 기능입니다.
앱/웹에서 사용할 수 있도록 반경, 사각형등의 영역에 포함되는 업소목록을 제공합니다.
형식

단일 상가업소 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/storeOne        

건물 단위 상가업소 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInBuilding

지번 단위 상가업소 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInPnu

행정동 단위 상가업소 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInDong

상권내 상가업소 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInArea

반경내 상가업소 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInRadius

사각형내 상가업소 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInRectangle

다각형내 상가업소 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInPolygon

업종별 상가업소 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInUpjong

수정일자기준 상가업소 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/storeListByDate

요청 메시지 (Request Parameter)

서비스 명세를 서비스명과 오퍼레이션 오퍼레이션명으로 표기
항목명 항목설명 기본값 필수항목 상세내용
    servicekey 서비스키 - 필수 공공데이터포털에서 발급받은 인증키
    key 상가업소번호 - 필수 상가업소번호를 입력
    key 건물관리번호 - 필수 건물관리번호를 입력
    key PNU코드 - 필수 PNU코드값을 입력
    divId 구분ID - 필수 시도는 ctprvnCd, 시군구는 signguCd, 행정동은 adongCd를 사용
    key 행정구역코드 - 필수 시도는 시도코드값, 시군구는 시군구코드값, 행정동은 행정동코드값을 사용 (행정동코드 조회 참조)
    key 상권번호 - 필수 상권번호를 입력
    radius 반경 - 필수 미터단위(반경제한:20,000m)
    cx 중심점 경도 - 필수 원형의 중심점의 경도값으로 WGS84 좌표계 사용
    cy 중심점 위도 - 필수 원형의 중심점의 위도값으로 WGS84 좌표계 사용
    minx 서쪽 경도 - 필수 사각형 바운더리에서 서쪽 경도좌표값으로 WGS84 좌표계 사용
    maxx 동쪽 경도 - 필수 사각형 바운더리에서 동쪽 경도좌표값으로 WGS84 좌표계 사용
    miny 남쪽 위도 - 필수 사각형 바운더리에서 남쪽 위도좌표값으로 WGS84 좌표계 사용
    maxy 북쪽 위도 - 필수 사각형 바운더리에서 북쪽 위도좌표값으로 WGS84 좌표계 사용
    key 다각형 좌표값 - 필수 다각형 좌표값을 입력. (경도 위도, ......, 경도 위도)
    divId 구분ID - 필수 대분류는 indsLclsCd, 중분류는 indsMclsCd, 소분류는 indsSclsCd를 사용
    key 업종코드값 - 필수 대분류는 대분류코드값, 중분류는 중분류코드값, 소분류는 소분류코드값을 사용 (업종코드 조회 참조)
    key 수정일자 - 필수 수정일자(YYYYMMDD 형식, 예:20151222)
    indsLclsCd 업종대분류코드 - 옵션 업종별 상가업소, 단일 상가업소 조회를 제외하고 업종을 제한 하는 용도로 사용할 수 있음.
    indsMclsCd 업종중분류코드 - 옵션 업종별 상가업소, 단일 상가업소 조회를 제외하고 업종을 제한 하는 용도로 사용할 수 있음.
    indsSclsCd 업종소분류코드 - 옵션 업종별 상가업소, 단일 상가업소 조회를 제외하고 업종을 제한 하는 용도로 사용할 수 있음.
    numOfRows 페이지당 건수 100 옵션 요청시 가져오는 페이지당 건수(최대 1000)
    pageNo 페이지번호 1 옵션 페이지번호
type 데이터유형 xml 옵션 xml, json

요청 예시

http://apis.data.go.kr/B553077/api/open/sdsc2/storeOne?key=상가업소번호&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeOne?key=MA010120220805494135&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInBuilding?key=건물관리번호&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInBuilding?key=3017011200113530000022216&indsLclsCd=I2&indsMclsCd=I212&indsSclsCd=I21201&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInPnu?key=PNU코드&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInPnu?key=1123010300207370002&indsLclsCd=I2&indsMclsCd=I212&indsSclsCd=I21201&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInDong?divId=구분ID&key=행정구역코드&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInDong?divId=ctprvnCd&key=11&indsLclsCd=I2&indsMclsCd=I212&indsSclsCd=I21201&numOfRows=2&pageNo=1&type=xml&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInArea?key=상권번호&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInArea?key=1882&indsLclsCd=I2&indsMclsCd=I212&indsSclsCd=I21201&numOfRows=2&pageNo=1&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInRadius?radius=반경&cx=중심경도&cy=중심위도&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInRadius?radius=500&cx=126.573301&cy=33.449826&indsLclsCd=I2&indsMclsCd=I212&indsSclsCd=I21201&numOfRows=2&pageNo=1
&type=xml&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInRectangle?minx=서쪽경도&miny=남쪽위도&maxx=동쪽경도&maxy=북쪽위도&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInRectangle?minx=126.571224&maxx=126.573906&miny=33.449233&maxy=33.449918&ServiceKey=서비스인증키 http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInRectangle?minx=127.034113&miny=37.509715&maxx=127.035730&maxy=37.510824&indsLclsCd=I2&indsMclsCd=I212
&indsSclsCd=I21201&numOfRows=2&pageNo=1&type=xml&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInPolygon?key=다각형좌표값&ServiceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInPolygon?key=POLYGON ((126.9204728 35.1523226,126.9192728 35.1531925,126.9181257 35.1522507,126.9193808 35.1514315,126.9204728 35.1523226))&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInUpjong?divId=구분ID&key=업종코드값&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInUpjong?divId=indsLclsCd&key=I2&numOfRows=1&pageNo=1&type=xml&serviceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListByDate?key=일자&ServiceKey=서비스인증키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeListByDate?key=20210602&indsLclsCd=I2&indsMclsCd=I212&indsSclsCd=I21201&numOfRows=1&pageNo=1&type=xml&serviceKey=서비스인증키

응답 메시지 (Response Message)

서비스 명세를 서비스명과 오퍼레이션 오퍼레이션명으로 표기
구분 항목 항목설명
header 데이터설명, 항목컬럼, 결과코드, 결과메시지를 가지고 있다.
description 데이터설명
columns 항목 리스트(배열)
stdrYm 기준년월
resultCode 결과코드값(응답 메시지 코드표 참고)
resultMsg 결과메시지
body 결과데이터 배열, 페이지번호, 페이지당 건수, 전체건수를 가지고 있다.
items 결과 항목(item) 배열
pageNo 페이지번호
numOfRows 페이지당 건수
totalCount 전체건수

결과 항목 구성 (item)

응답 메시지 코드표 (공공데이터포털 제공)을 에러코드에 따라 에러메세지와 설명으로 표기
항목명 항목설명 데이터타입(길이) 항목샘플 상세내용
bizesId 상가업소번호 가변문자형(20) MA010120220805494135 해당 상가업소에 부여된 일련번호
bizesNm 상호명 가변문자형(100) 땡땡땡다방 해당 상가업소의 상호명
brchNm 지점명 가변문자형(50) 대전땡땡병원점 해당 상가업소가 지점인 경우 지점명
indsLclsCd 상권업종대분류코드 문자형(1) I2 해당 상가업소의 상권업종대분류코드
indsLclsNm 상권업종대분류명 가변문자형(40) 음식점 해당 상가업소의 상권업종대분류명
indsMclsCd 상권업종중분류코드 문자형(3) I212 해당 상가업소의 상권업종중분류코드
indsMclsNm 상권업종중분류명 가변문자형(40) 비알코올 해당 상가업소의 상권업종중분류명
indsSclsCd 상권업종소분류코드 문자형(6) I21201 해당 상가업소의 상권업종소분류코드
indsSclsNm 상권업종소분류명 가변문자형(40) 카페 해당 상가업소의 상권업종소분류명
ksicCd 표준산업분류코드 가변문자형(5) I56221 해당 상가업소의 표준산업분류코드
ksicNm 표준산업분류명 가변문자형(40) 커피 전문점 해당 상가업소의 표준산업분류코드에 대한 명칭
ctprvnCd 시도코드 문자형(2) 30 해당 상가업소의 시도 코드
ctprvnNm 시도명 가변문자형(20) 대전광역시 해당 상가업소의 시도 명칭
signguCd 시군구코드 문자형(5) 30170 해당 상가업소의 시군구 코드
signguNm 시군구명 가변문자형(20) 서구 해당 상가업소의 시군구 명칭
adongCd 행정동코드 문자형(10) 30170640 해당 상가업소의 행정동 코드
adongNm 행정동명 가변문자형(20) 둔산2동 해당 상가업소의 행정동 명칭
ldongCd 법정동코드 문자형(10) 3017011200 해당 상가업소의 법정동 코드
ldongNm 법정동명 가변문자형(20) 둔산동 해당 상가업소의 법정동 명칭
lnoCd PNU코드 문자형(19) 3017011200113530000 해당 상가업소 지번주소에 해당하는 PNU코드
시도(2)+시군구(3)+읍면동(3)+리(2)+대지구분(1)+본번지(4)+부번지(4)
plotSctCd 대지구분코드 문자형(1) 1 해당 상가업소 지번주소의 대지구분 코드 (1, 2)
plotSctNm 대지구분명 가변문자형(2) 대지 해당 상가업소 지번주소의 대지구분 코드명 (대지, 산)
lnoMnno 지번본번지 숫자형(4) 1353 해당 상가업소 지번주소의 본번지
lnoSlno 지번부번지 숫자형(4) 해당 상가업소 지번주소의 부번지
lnoAdr 지번주소 가변문자형(100) 대전광역시 서구 둔산동 1353번지 해당 상가업소 지번기준 전체주소
rdnmCd 도로명코드 가변문자형(12) 301704298326 해당 상가업소 도로명주소 도로명코드
rdnm 도로명 가변문자형(30) 둔산로51번길 해당 상가업소 도로명주소 도로명코드에 대한 명칭
bldMnno 건물본번지 숫자형(5) 66 해당 상가업소 도로명주소 기준 건물 본번지
bldSlno 건물부번지 숫자형(5) 해당 상가업소 도로명주소 기준 건물 부번지
bldMngNo 건물관리번호 숫자형(25) 3017011200113530000022216 해당 상가업소 도로명주소 기준 건물관리번호
bldNm 건물명 가변문자형(40) 해당 상가업소 도로명주소 기준 건물명
rdnmAdr 도로명주소 가변문자형(100) 대전광역시 서구 둔산로51번길 66, (둔산동) 해당 상가업소 도로명 주소기준 전체주소
oldZipcd 구우편번호 문자형(6) 302830 해당 상가업소 구우편번호(개편전 우편번호)
newZipcd 신우편번호 문자형(5) 16618 해당 상가업소 신우편번호(개편후 우편번호)
dongNo 동정보 가변문자형(10) 해당 상가업소가 소재한 동정보
flrNo 층정보 가변문자형(10) 해당 상가업소가 소재한 층정보
hoNo 호정보 가변문자형(10) 해당 상가업소가 소재한 호정보
lon 경도 숫자형 127.380605 해당 상가업소의 WGS84기준 위도 좌표값
lat 위도 숫자형 36.354149 해당 상가업소의 WGS84기준 위도 좌표값
chgGb 변경구분 문자형(1) C,U,D 중1 (생성:C, 수정:U, 삭제:D) 해당 상가업소정보의 데이터 변경 구분값(수정일자기준 상가업소조회에서만 제공함)
chgDt 수정일자 문자형(8) 20151202 일자(YYYYMMDD 형식, 예:20151202)

출력 예시 (JSONXML)

맨위로 이동

소상공인시장진흥공단