OpenAPI

> OpenAPI > OpenAPI 매뉴얼 > 상가업소 통계

상가업소 통계 명세

오퍼레이션 내용

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

행정구역내 업종별 상가업소 통계 http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInAdmi

건물내 업종별 상가업소 통계 http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInBuilding

반경내 업종별 상가업소 통계 http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInRadius

사각형내 업종별 상가업소 통계 http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInRectangle

다각형내 업종별 상가업소 통계 http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInPolygon

요청 메시지 (Request Parameter)

서비스 명세를 서비스명과 오퍼레이션 오퍼레이션명으로 표기
항목명 항목설명 기본값 필수항목 상세내용
    divId 구분ID - 필수 시도는 ctprvnCd, 시군구는 signguCd, 행정동은 adongCd를 사용
    key 행정구역코드 - 필수 시도는 시도코드값, 시군구는 시군구코드값, 행정동은 행정동코드값을 사용 (행정동코드 조회 참조)
    key 건물관리번호 - 필수 건물관리번호를 입력
    radius 반경 - 필수 미터단위(반경제한:20,000m)
    cx 중심점 경도 - 필수 원형의 중심점의 경도값으로 WGS84 좌표계 사용
    cy 중심점 위도 - 필수 원형의 중심점의 위도값으로 WGS84 좌표계 사용
    minx 서쪽 경도 - 필수 사각형 바운더리에서 서쪽 경도좌표값으로 WGS84 좌표계 사용
    maxx 동쪽 경도 - 필수 사각형 바운더리에서 동쪽 경도좌표값으로 WGS84 좌표계 사용
    miny 남쪽 위도 - 필수 사각형 바운더리에서 남쪽 위도좌표값으로 WGS84 좌표계 사용
    maxy 북쪽 위도 - 필수 사각형 바운더리에서 북쪽 위도좌표값으로 WGS84 좌표계 사용
    key 다각형 좌표값 - 필수 다각형 좌표값을 입력(경도 위도, ......, 경도 위도)
    indsLclsCd 업종대분류코드 - 옵션 업종을 제한 하는 용도로 사용할 수 있음
    indsMclsCd 업종중분류코드 - 옵션 업종을 제한 하는 용도로 사용할 수 있음
    indsSclsCd 업종소분류코드 - 옵션 업종을 제한 하는 용도로 사용할 수 있음. ALL입력 또는, 파라미터만 입력시 소분류업종 전체가 대상이됨
type 데이터유형 xml 옵션 xml, json

요청 예시

http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInAdmi?divId=구분ID&key=키값&ServiceKey=서비스키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInAdmi?divId=signguCd&key=11680&ServiceKey=서비스키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInBuilding?key=건물관리번호&ServiceKey=서비스키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInBuilding?key=3017011200113530000022216&ServiceKey=서비스키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInRadius?radius=반경&cx=경도&cy=위도&ServiceKey=서비스키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInRadius?radius=500&cx=126.573301&cy=33.449826&ServiceKey=서비스키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInRectangle?minx=서쪽경도&maxx=동쪽경도&miny=남쪽위도&maxy=북쪽위도&ServiceKey=서비스키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInRectangle?minx=126.571224&maxx=126.573906&miny=33.449233&maxy=33.449918&ServiceKey=서비스키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInPolygon?key=다각형좌표값&ServiceKey=서비스키
http://apis.data.go.kr/B553077/api/open/sdsc2/storeStatsUpjongInPolygon?key=POLYGON ((126.9204728 35.1523226,126.9192728 35.1531925,126.9181257 35.1522507,126.9193808 35.1514315,126.9204728 35.1523226))&ServiceKey=서비스키

응답 메시지 (Response Message)

서비스 명세를 서비스명과 오퍼레이션 오퍼레이션명으로 표기
구분 항목 항목설명
header 데이터설명, 항목컬럼, 결과코드, 결과메시지를 가지고 있다.
description 데이터설명
columns 항목 리스트(배열)
resultCode 결과코드값(응답 메시지 코드표 참고)
resultMsg 결과메시지
body 결과데이터 배열을 가지고 있다.
items 결과 항목(item) 배열

결과 항목 구성 (item)

응답 메시지 코드표 (공공데이터포털 제공)을 에러코드에 따라 에러메세지와 설명으로 표기
항목명 항목설명 데이터타입(길이) 항목샘플 상세내용
indsLclsCd 상권업종대분류코드 문자형(1) Q 해당 상가업소의 상권업종대분류코드
indsLclsNm 상권업종대분류명 가변문자형(40) 음식 해당 상가업소의 상권업종대분류명
indsMclsCd 상권업종중분류코드 문자형(3) Q12 해당 상가업소의 상권업종중분류코드
indsMclsNm 상권업종중분류명 가변문자형(40) 커피점/카페 해당 상가업소의 상권업종중분류명
indsSclsCd 상권업종소분류코드 문자형(6) Q12A01 해당 상가업소의 상권업종소분류코드
indsSclsNm 상권업종소분류명 가변문자형(40) 커피전문점/카페/다방 해당 상가업소의 상권업종소분류명
statCnt 업소갯수 숫자형 6 업종에 해당되는 상가업소 갯수

출력 예시 (JSONXML)

맨위로 이동

소상공인시장진흥공단