오퍼레이션 내용

오퍼레이션 내용 설명
내용	전국 약 1,200개 주요상권의 영역좌표를 조회하는 기능입니다. 앱/웹에서 지도에 주요상권을 그리는 용도로 사용할 수 있도록 폴리곤 좌표 데이터를 제공합니다.
형식	지정 상권 http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneOne 반경내 상권조회 http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInRadius 사각형내 상권조회 http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInRectangle 행정구역 단위 상권조회 http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInAdmi

요청 메시지 (Request Parameter)

서비스 명세를 서비스명과 오퍼레이션 오퍼레이션명으로 표기
항목명	항목설명	기본값	필수항목	상세내용
key	상권번호	-	필수	상권번호를 입력
servicekey	서비스키	-	필수	공공데이터포털에서 발급받은 인증키
radius	반경	-	필수	미터단위(반경제한:20,000m)
cx	중심점 경도	-	필수	원형의 중심점의 경도값으로 WGS84 좌표계 사용
cy	중심점 위도	-	필수	원형의 중심점의 위도값으로 WGS84 좌표계 사용
minx	서쪽 경도	-	필수	사각형 바운더리에서 서쪽 경도좌표값으로 WGS84 좌표계 사용
maxx	동쪽 경도	-	필수	사각형 바운더리에서 동쪽 경도좌표값으로 WGS84 좌표계 사용
miny	남쪽 위도	-	필수	사각형 바운더리에서 남쪽 위도좌표값으로 WGS84 좌표계 사용
maxy	북쪽 위도	-	필수	사각형 바운더리에서 북쪽 위도좌표값으로 WGS84 좌표계 사용
divId	구분ID	-	필수	시도는 ctprvnCd, 시군구는 signguCd, 행정동은 adongCd를 사용
key	행정구역코드	-	필수	시도는 시도코드값, 시군구는 시군구코드값, 행정동은 행정동코드값을 사용 (행정동코드 조회 참조)
type	데이터유형	xml	옵션	xml, json

요청 예시

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneOne?key=상권번호&ServiceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneOne?key=1882&ServiceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInRadius?radius=반경&cx=중심점경도&cy=중심점위도&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInRadius?radius=500&cx=127.004528&cy=37.567538&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInRadius?minx=서쪽경도&maxx=동쪽경도&miny=남쪽위도&maxy=북쪽위도&ServiceKey=서비스키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInRadius?minx=126.571224&maxx=126.573906&miny=33.449233&maxy=33.449918&ServiceKey=서비스키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInAdmi?divId=구분ID&key=키값&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInAdmi?divId=ctprvnCd&key=11&serviceKey=서비스인증키

응답 메시지 (Response Message)

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

결과 항목 구성 (item)

응답 메시지 코드표 (공공데이터포털 제공)을 에러코드에 따라 에러메세지와 설명으로 표기
항목명	항목설명	데이터타입(길이)	항목샘플	상세내용
trarNo	상권번호	NUMBER(10)	9174	주요상권번호
mainTrarNm	상권명	VARCHAR2(100)	인사동	주요상권의 상권이름
ctprvnCd	시도코드	VARCHAR2(2)	11	광역시도코드
ctprvnNm	시도명	VARCHAR2(40)	서울특별시	광역시도명
signguCd	시군구코드	VARCHAR2(5)	11110	시군구코드
signguNm	시군구명	VARCHAR2(40)	종로구	시군구명
trarArea	면적	NUMBER	226875	상권의 면적(㎡, 평방미터)
coordNum	좌표개수	NUMBER(8)	21	상권영역 다각형의 좌표개수
coords	좌표값	CLOB(TEXT)	MULTIPOLYGON (((126.986059148338 37.5765234907315, 126.985943099285 37.5765933022497, ......, 126.986059148338 37.5765234907315)))	상권영역 다각형의 좌표값 문자열 MULTIPOLYGON ((경도 위도, ...., 경도 위도))
stdrDt	데이터기준일자	VARCHAR2(10)	2021-06-30	데이터 배포일자

출력 예시 (JSON ㅣ XML)

<response>
	<header>
		<description>소상공인시장진흥공단 주요상권</description>
                <columns>상권번호,상권명,시도코드,시도명,시군구코드,시군구명,상권면적,좌표개수,좌표값,데이터기준일자</columns>
		<resultCode>00</resultCode>
		<resultMsg>NORMAL SERVICE</resultMsg>
	</header>
	<body>
		<items>
			<item>
				<trarNo>9174</trarNo>
				<mainTrarNm>인사동</mainTrarNm>
                                <ctprvnCd>11</ctprvnCd>
                                <ctprvnNm>서울특별시</ctprvnNm>
				<signguCd>11110</signguCd>
				<signguNm>종로구</signguNm>
                                <trarArea>226875</trarArea>
				<coordNum>21</coordNum>
				<coords>MULTIPOLYGON ((126.986059148338 37.5765234907315, 126.985943099285 37.5765933022497, 126.985003595935 37.5761584486461, 126.984321612825 37.5758475109755, 126.983682074805 37.5755861301059, 126.983073659879 37.5753743049793, 126.983019911215 37.5752819452711, 126.982977487921 37.5751693150508, 126.983105316596 37.573220945966, 126.983179233794 37.5718334337701, 126.983151246104 37.5705540242774, 126.983270142803 37.5703828545296, 126.983428633426 37.5703107995486, 126.985822713216 37.5702976242875, 126.98744706053 37.5703113418908, 126.987429831033 37.571653814357, 126.987588062984 37.5729782873447, 126.987372867362 37.5736044495484, 126.986789692656 37.5745999719345, 126.986195066917 37.5761631127724, 126.986059148338 37.5765234907315))</coords>
				<stdrDt>2020-12-31</stdrDt>
			</item>
		</items>
	</body>
</response>

{
    "header" : {
        "description" : "소상공인시장진흥공단 주요상권"
        ,"columns" : ["상권번호","상권명","시군구코드","시군구명","좌표수","좌표","기준일자"]
        ,"resultCode" : "00"
        ,"resultMsg" : "NORMAL SERVICE"
    },
    "body" : {
            "items" : [
                {
                "trarNo" : 9174
                ,"mainTrarNm" : "인사동"
                ,"signguCd" : "11110"
                ,"signguNm" : "종로구"
                ,"coordNum" : 21
                ,"coords" : "MULTIPOLYGON (((126.986059148338 37.5765234907315, 126.985943099285 37.5765933022497, 126.985003595935 37.5761584486461, 126.984321612825 37.5758475109755, 126.983682074805 37.5755861301059, 126.983073659879 37.5753743049793, 126.983019911215 37.5752819452711, 126.982977487921 37.5751693150508, 126.983105316596 37.573220945966, 126.983179233794 37.5718334337701, 126.983151246104 37.5705540242774, 126.983270142803 37.5703828545296, 126.983428633426 37.5703107995486, 126.985822713216 37.5702976242875, 126.98744706053 37.5703113418908, 126.987429831033 37.571653814357, 126.987588062984 37.5729782873447, 126.987372867362 37.5736044495484, 126.986789692656 37.5745999719345, 126.986195066917 37.5761631127724, 126.986059148338 37.5765234907315)))"
                ,"stdrDt" : "2021-06-30"
                }
            ]
    }
}

<response>
	<header>
		<description>소상공인시장진흥공단 주요상권</description>
                <columns>상권번호,상권명,시도코드,시도명,시군구코드,시군구명,상권면적,좌표개수,좌표값,데이터기준일자</columns>
		<resultCode>00</resultCode>
		<resultMsg>NORMAL SERVICE</resultMsg>
	</header>
	<body>
		<items>
			<item>
				<trarNo>9307</trarNo>
				<mainTrarNm>역삼역_1</mainTrarNm>
                                <ctprvnCd>11</ctprvnCd>
                                <ctprvnNm>서울특별시</ctprvnNm>
				<signguCd>11680</signguCd>
				<signguNm>강남구</signguNm>
                           <trarArea>292547</trarArea>
				<coordNum>10</coordNum>
				<coords>MULTIPOLYGON ((127.036815211166 37.5005428006801, 127.03667948655 37.5005068013092, 127.031261820465 37.4988234253835, 127.032188335121 37.4968770257367, 127.033476341605 37.4941826894817, 127.035195390987 37.4946957805607, 127.039052051268 37.4958929449688, 127.038193498687 37.4976771974333, 127.037221980889 37.4998038576353, 127.036815211166 37.5005428006801))</coords>
				<stdrDt>2020-12-31</stdrDt>
			</item>
			<item>
				<trarNo>9264</trarNo>
				<mainTrarNm>한양시장</mainTrarNm>
                                <ctprvnCd>11</ctprvnCd>
                                <ctprvnNm>서울특별시</ctprvnNm>
				<signguCd>11200</signguCd>
				<signguNm>성동구</signguNm>
                                <trarArea>27474</trarArea>
				<coordNum>13</coordNum>
				<coords>MULTIPOLYGON ((127.039950763124 37.5612193717558, 127.039333898475 37.5611677647271, 127.039342173306 37.5607465487395, 127.03879037715 37.5606656357102, 127.038863754862 37.5602871961497, 127.04000126676 37.5603904434357, 127.040020862679 37.5599827385097, 127.040292526237 37.5600457186529, 127.039872996841 37.5585592205209, 127.04066231052 37.5583720047665, 127.041226602068 37.5606918681935, 127.039964672609 37.5607576092885, 127.039950763124 37.5612193717558))</coords>
				<stdrDt>2020-12-31</stdrDt>
			</item>
		</items>
	</body>
</response>

<response>
	<header>
		<description>소상공인시장진흥공단 주요상권</description>
		<resultCode>00</resultCode>
		<resultMsg>NORMAL SERVICE</resultMsg>
	</header>
	<body>
		<items>
			<item>
				<trarNo>41489</trarNo>
				<mainTrarNm>통일종합시장</mainTrarNm>
				<signguCd>28170</signguCd>
				<signguNm>미추홀구</signguNm>
				<coordNum>7</coordNum>
				<coords>MULTIPOLYGON ((126.678080737177 37.4492493258884, 126.678042693527 37.4488096419853, 126.678058499836 37.4487793816842, 126.678754138777 37.4487386624191, 126.678761176885 37.4487482020259, 126.678807411696 37.4492012296178, 126.678080737177 37.4492493258884))</coords>
				<stdrDt>2020-12-31</stdrDt>
			</item>
			<item>
				<trarNo>9394</trarNo>
				<mainTrarNm>장한평역_1</mainTrarNm>
				<signguCd>11230</signguCd>
				<signguNm>동대문구</signguNm>
				<coordNum>28</coordNum>
				<coords>MULTIPOLYGON ((127.06634405916 37.5637891358265, 127.066318588581 37.5637846448881, 127.066049446617 37.5634063766007, 127.065757641491 37.5629943328863, 127.065440334745 37.5625372527258, 127.065057882855 37.5619991176613, 127.06508046181 37.5619315311682, 127.06523586455 37.5616701598644, 127.065165027859 37.5615553218242, 127.066002474032 37.561439990024, 127.066772032365 37.5613517196347, 127.067567026783 37.5612318952881, 127.068098908665 37.5611527591758, 127.068141375735 37.5611797648948, 127.068161278968 37.5612878725471, 127.068246511311 37.5616752503777, 127.0682154245 37.5617180650471, 127.067890068153 37.561765550822, 127.068383130635 37.5625694062622, 127.06836056859 37.5626527607061, 127.067964612916 37.5628624650396, 127.067698245618 37.562427886968, 127.067545524103 37.5625135667851, 127.067090196943 37.5627818658489, 127.066830006556 37.5629329263316, 127.066524529701 37.5630704963776, 127.066822036023 37.5635253320813, 127.06634405916 37.5637891358265))</coords>
				<stdrDt>2020-12-31</stdrDt>
			</item>
		</items>
	</body>
</response>

<response>
	<header>
		<description>소상공인시장진흥공단 주요상권</description>
		<resultCode>00</resultCode>
		<resultMsg>NORMAL SERVICE</resultMsg>
	</header>
	<body>
		<items>
			<item>
				<trarNo>9307</trarNo>
				<mainTrarNm>역삼역_1</mainTrarNm>
                                <ctprvnCd>11</ctprvnCd>
                                <ctprvnNm>서울특별시</ctprvnNm>
				<signguCd>11680</signguCd>
				<signguNm>강남구</signguNm>
                                <trarArea>292547</trarArea>
				<coordNum>10</coordNum>
				<coords>MULTIPOLYGON ((127.036815211166 37.5005428006801, 127.03667948655 37.5005068013092, 127.031261820465 37.4988234253835, 127.032188335121 37.4968770257367, 127.033476341605 37.4941826894817, 127.035195390987 37.4946957805607, 127.039052051268 37.4958929449688, 127.038193498687 37.4976771974333, 127.037221980889 37.4998038576353, 127.036815211166 37.5005428006801))</coords>
				<stdrDt>2020-12-31</stdrDt>
			</item>
		</items>
	</body>
</response>

OpenAPI

상권 조회 명세