소상공인진흥공단 상가업소 데이터 조회하기


PNG

파이썬 PublicDataReader 라이브러리를 이용하면 공공데이터포털에서 제공하는 소상공인진흥공단 상가업소 데이터를 쉽게 조회할 수 있습니다.


PublicDataReader

PublicDataReader는 공공 데이터를 자동으로 조회할 수 있는 파이썬 라이브러리입니다. 이 라이브러리로 공공데이터포털과 국가통계포털(KOSIS)과 같이 오픈 API 서비스로 제공하는 공공 데이터를 쉽게 조회할 수 있습니다. 인증키가 필요한 공공 데이터는 인증키를 사용하여 조회할 수 있고, 인증키가 필요하지 않은 데이터는 별도의 인증 절차 없이 조회할 수 있습니다. PublicDataReader를 이용하면 일반적인 공공 데이터 조회 과정에서 필요한 API 명세 찾기, 요청 작성, 반환된 데이터 정리 과정을 자동으로 처리할 수 있고, 웹에 공개된 데이터를 조회할 때도 데이터 수집과 가공 과정을 자동화할 수 있습니다. 이를 통해 코드 작성이 간결해지고 공공 데이터 조회 작업이 편리해집니다.


소상공인 상가업소 정보 조회 서비스

PublicDataReader를 통해 공공데이터포털에서 제공하는 Open API 서비스를 정상적으로 이용하려면 아래 서비스 신청 페이지 링크에 접속 후 서비스 이용 신청을 해야 합니다. 서비스 신청을 완료하면 Open API를 사용할 수 있는 서비스 키가 발급됩니다. 서비스 제공 기관에 따라 서비스 키 발급 후 약 1~2일이 지난 후 접근 권한이 부여될 수 있습니다. 충분한 시간이 지난 후에도 접근 권한이 부여되지 않는다면 서비스 제공처에 문의하는 것을 권장합니다.

서비스명 카테고리명
지정 상권조회 지정상권
반경내 상권조회 반경상권
사각형내 상권조회 사각형상권
행정구역 단위 상권조회 행정구역상권
단일 상가업소 조회 단일상가
건물단위 상가업소 조회 건물상가
지번단위 상가업소 조회 지번상가
행정동 단위 상가업소 조회 행정동상가
상권내 상가업소 조회 상권상가
반경내 상가업소 조회 반경상가
사각형내 상가업소 조회 사각형상가
다각형내 상가업소 조회 다각형상가
업종별 상가업소 조회 업종별상가
수정일자기준 상가업소 조회 수정일자상가
상권정보 업종 대분류 조회 업종대분류
상권정보 업종 중분류 조회 업종중분류
상권정보 업종 소분류 조회 업종소분류


PublicDataReader 설치하기

  1. 운영체제(OS)에 따라 아래 중 하나를 선택합니다.
  • Windows: CMD(명령 프롬프트) 실행
  • Mac: Terminal(터미널) 실행
  1. 아래 Shell 명령어를 입력 후 실행합니다.
pip install PublicDataReader --upgrade


오픈 API 서비스 키 입력하기

공공데이터포털에서 발급받은 서비스 키를 복사하여 다음과 같이 serviceKey 변수에 할당합니다. 오픈 API 서비스 키 발급 방법에 대해 궁금하신 분들은 구글에 ‘공공데이터포털 오픈 API 사용법‘을 검색하시면 여러 문서들을 참조할 수 있습니다.

service_key = "공공데이터포털에서 발급받은 서비스 키"


데이터 조회 세션 만들기

다음과 같이 발급받은 serviceKey 값을 이용해 부동산 실거래가 데이터를 조회할 si 세션을 만들어줍니다. 본 라이브러리를 정상적으로 이용하기 위해서는 소상공인 상가업소 정보 조회 서비스에 대한 OpenAPI 활용신청을 반드시 완료해야합니다.

# 상가업소 정보 조회 클래스 임포트하기
from PublicDataReader import SmallShop

# 데이터 조회 API 인스턴스 만들기
api = SmallShop(service_key)


데이터 조회하기

  • 지정 상권조회
df = api.get_data(
    service_name = "지정상권",
    key = "9301",
)
df.tail(1)
상권번호 상권명 시도코드 시도명 시군구코드 시군구명 면적 좌표개수 좌표값 데이터기준일자
0 9301 압구정 로데오거리_1 11 서울특별시 11680 강남구 193739 19 MULTIPOLYGON (((127.04700219001 37.52446081421... 2021-06-30
  • 반경내 상권조회
df = api.get_data(
    service_name = "반경상권",
    cx = 127.042325940821,
    cy = 37.5272105674053,
    radius = 500,
)
df.tail(1)
상권번호 상권명 시도코드 시도명 시군구코드 시군구명 면적 좌표개수 좌표값 데이터기준일자
2 9316 청담사거리_1 11 서울특별시 11680 강남구 20169 21 MULTIPOLYGON (((127.045624467128 37.5237563085... 2021-06-30
  • 사각형내 상권조회
df = api.get_data(
    service_name = "사각형상권",
    minx = 127.0327683531071,
    miny = 37.495967935149146,
    maxx = 127.04268179746694,
    maxy = 37.502402894207286
)
df.tail(1)
상권번호 상권명 시도코드 시도명 시군구코드 시군구명 면적 좌표개수 좌표값 데이터기준일자
2 9308 역삼역_2 11 서울특별시 11680 강남구 51935 32 MULTIPOLYGON (((127.042493260333 37.5022663760... 2021-06-30
  • 행정구역 단위 상권조회
df = api.get_data(
    service_name = "행정구역상권",
    divId = 'adongCd',
    key = '1168058000'
)
df.tail(1)
상권번호 상권명 시도코드 시도명 시군구코드 시군구명 면적 좌표개수 좌표값 데이터기준일자
2 9323 포스코사거리_2 11 서울특별시 11680 강남구 79514 34 MULTIPOLYGON (((127.053620405866 37.5128036692... 2021-06-30
  • 단일 상가업소 조회
df = api.get_data(
    service_name = "단일상가",
    divId = 'adongCd',
    key = '11757465'
)
df.tail(1)
상가업소번호 상호명 지점명 상권업종대분류코드 상권업종대분류명 상권업종중분류코드 상권업종중분류명 상권업종소분류코드 상권업종소분류명 표준산업분류코드 ... 건물관리번호 건물명 도로명주소 구우편번호 신우편번호 동정보 층정보 호정보 경도 위도
0 11757465 스타벅스 방배점 Q 음식 Q12 커피점/카페 Q12A01 커피전문점/카페/다방 I56220 ... 1165010100108120002009897 None 서울특별시 서초구 방배로 211, (방배동) 137832 06562 None 1 None 126.99050928001 37.4919441682448

1 rows × 39 columns

  • 건물단위 상가업소 조회
df = api.get_data(
    service_name = "건물상가",
    key = '1168011000104940000004966'
)
df.tail(1)
상가업소번호 상호명 지점명 상권업종대분류코드 상권업종대분류명 상권업종중분류코드 상권업종중분류명 상권업종소분류코드 상권업종소분류명 표준산업분류코드 ... 건물관리번호 건물명 도로명주소 구우편번호 신우편번호 동정보 층정보 호정보 경도 위도
82 28508108 아모레퍼시픽백화점갤러리아압구정 None D 소매 D16 화장품소매 D16A01 화장품판매점 G47813 ... 1168011000104940000004966 갤러리아백화점 서울특별시 강남구 압구정로 343, (압구정동) 135902 06008 None 1 None 127.04008070443 37.5284986430328

1 rows × 39 columns

  • 지번단위 상가업소 조회
df = api.get_data(
    service_name = "지번상가",
    key = '1165010100108120002'
)
df.tail(1)
상가업소번호 상호명 지점명 상권업종대분류코드 상권업종대분류명 상권업종중분류코드 상권업종중분류명 상권업종소분류코드 상권업종소분류명 표준산업분류코드 ... 건물관리번호 건물명 도로명주소 구우편번호 신우편번호 동정보 층정보 호정보 경도 위도
1 17875647 키무브필라테스스튜디오 None N 관광/여가/오락 N05 요가/단전/마사지 N05A01 요가/단식 S96129 ... 1165010100108120002009897 None 서울특별시 서초구 방배로 211, (방배동) 137832 06562 None 5 None 126.990621865291 37.4919811723816

1 rows × 39 columns

  • 행정동 단위 상가업소 조회
df = api.get_data(
    service_name = "행정동상가",
    divId = 'adongCd',
    key = '1168064000',
    indsLclsCd = 'Q'
)
df.tail(1)
상가업소번호 상호명 지점명 상권업종대분류코드 상권업종대분류명 상권업종중분류코드 상권업종중분류명 상권업종소분류코드 상권업종소분류명 표준산업분류코드 ... 건물관리번호 건물명 도로명주소 구우편번호 신우편번호 동정보 층정보 호정보 경도 위도
999 17078682 투썸플레이스 강남역KR타워점 Q 음식 Q12 커피점/카페 Q12A01 커피전문점/카페/다방 I56220 ... 1168010100108250026024506 None 서울특별시 강남구 강남대로84길 13, (역삼동) 135934 06232 None None None 127.029572455617 37.4968668925481

1 rows × 39 columns

  • 상권내 상가업소 조회
df = api.get_data(
    service_name = "상권상가",
    key = '9368',
    indsLclsCd = 'Q'
)
df.tail(1)
상가업소번호 상호명 지점명 상권업종대분류코드 상권업종대분류명 상권업종중분류코드 상권업종중분류명 상권업종소분류코드 상권업종소분류명 표준산업분류코드 ... 건물관리번호 건물명 도로명주소 구우편번호 신우편번호 동정보 층정보 호정보 경도 위도
188 9136408 KFC역삼점 역삼점 Q 음식 Q05 닭/오리요리 Q05A08 후라이드/양념치킨 I56193 ... 1168010100106420010026120 송암II빌딩 서울특별시 강남구 논현로 509, (역삼동) 135910 06132 None 1 None 127.036078078957 37.5019210138113

1 rows × 39 columns

  • 반경내 상가업소 조회
df = api.get_data(
    service_name = "반경상가",
    radius = '500',
    cx = 127.03641615737838,
    cy = 37.50059843782878,
    indsLclsCd = 'Q'
)
df.tail(1)
상가업소번호 상호명 지점명 상권업종대분류코드 상권업종대분류명 상권업종중분류코드 상권업종중분류명 상권업종소분류코드 상권업종소분류명 표준산업분류코드 ... 건물관리번호 건물명 도로명주소 구우편번호 신우편번호 동정보 층정보 호정보 경도 위도
847 9136408 KFC역삼점 역삼점 Q 음식 Q05 닭/오리요리 Q05A08 후라이드/양념치킨 I56193 ... 1168010100106420010026120 송암II빌딩 서울특별시 강남구 논현로 509, (역삼동) 135910 06132 None 1 None 127.036078078957 37.5019210138113

1 rows × 39 columns

  • 사각형내 상가업소 조회
df = api.get_data(
    service_name = "사각형상가",
    minx = 127.0327683531071,
    miny = 37.495967935149146,
    maxx = 127.04268179746694,
    maxy = 37.502402894207286,
    indsLclsCd = 'Q'
)
df.tail(1)
상가업소번호 상호명 지점명 상권업종대분류코드 상권업종대분류명 상권업종중분류코드 상권업종중분류명 상권업종소분류코드 상권업종소분류명 표준산업분류코드 ... 건물관리번호 건물명 도로명주소 구우편번호 신우편번호 동정보 층정보 호정보 경도 위도
579 9136408 KFC역삼점 역삼점 Q 음식 Q05 닭/오리요리 Q05A08 후라이드/양념치킨 I56193 ... 1168010100106420010026120 송암II빌딩 서울특별시 강남구 논현로 509, (역삼동) 135910 06132 None 1 None 127.036078078957 37.5019210138113

1 rows × 39 columns

  • 다각형내 상가업소 조회
df = api.get_data(
    service_name = "다각형상가",
    key = 'POLYGON((127.02355609555755 37.504264372557095, 127.02496157306963 37.50590702991155, 127.0270858825753 37.50486867039889, 127.02628121988377 37.503489842823114))',
    indsLclsCd = 'Q'
)
df.tail(1)
상가업소번호 상호명 지점명 상권업종대분류코드 상권업종대분류명 상권업종중분류코드 상권업종중분류명 상권업종소분류코드 상권업종소분류명 표준산업분류코드 ... 건물관리번호 건물명 도로명주소 구우편번호 신우편번호 동정보 층정보 호정보 경도 위도
47 26260692 신마포갈매기 신논현역점 Q 음식 Q01 한식 Q01A02 갈비/삼겹살 I56111 ... 1168010100108100000022737 None 서울특별시 강남구 강남대로110길 12, (역삼동) 135931 06123 None 2 None 127.025806325949 37.5038461003511

1 rows × 39 columns

  • 업종별 상가업소 조회
df = api.get_data(
    service_name = "업종별상가",
    divId = 'indsLclsCd',
    key = 'Q'
)
df.tail(1)
상가업소번호 상호명 지점명 상권업종대분류코드 상권업종대분류명 상권업종중분류코드 상권업종중분류명 상권업종소분류코드 상권업종소분류명 표준산업분류코드 ... 건물관리번호 건물명 도로명주소 구우편번호 신우편번호 동정보 층정보 호정보 경도 위도
999 11181582 내수한우마을 None Q 음식 Q01 한식 Q01A01 한식/백반/한정식 I56111 ... 4371025041001700005054390 None 충청북도 청주시 청원구 내수읍 청암로 111, (학평리) 363934 28146 None 1 None 127.542578061469 36.7252477746175

1 rows × 39 columns

  • 수정일자기준 상가업소 조회
df = api.get_data(
    service_name = "수정일자상가",
    key = '20200101',
    indsLclsCd = 'Q'
)
df.tail(1)
상가업소번호 상호명 지점명 상권업종대분류코드 상권업종대분류명 상권업종중분류코드 상권업종중분류명 상권업종소분류코드 상권업종소분류명 표준산업분류코드 ... 건물명 도로명주소 구우편번호 신우편번호 동정보 층정보 호정보 경도 위도 chgGb
2 25852182 그랜드테이블 None Q 음식 Q06 양식 Q06A05 패밀리레스토랑 I56114 ... 해운대그랜드호텔 부산광역시 해운대구 해운대해변로 217, (우동) 612821 48093 None 1 None 129.155174224526 35.1591175731937 U

1 rows × 40 columns

  • 상권정보업종 대분류 조회
df = api.get_data(
    service_name = "업종대분류",
)
df.tail(1)
상권업종대분류코드 상권업종대분류명 데이터기준일자
41 R 학문/교육 2015-12-17
  • 상권정보업종 중분류 조회
df = api.get_data(
    service_name = "업종중분류",
    indsLclsCd = 'Q'
)
df.tail(1)
상권업종대분류코드 상권업종대분류명 상권업종중분류코드 상권업종중분류명 데이터기준일자
31 Q 음식 Q01 한식 2015-12-17
  • 상권정보업종 소분류 조회
df = api.get_data(
    service_name = "업종소분류",
    indsLclsCd = 'Q',
    indsMclsCd = 'Q01'
)
df.tail(1)
상권업종대분류코드 상권업종대분류명 상권업종중분류코드 상권업종중분류명 상권업종소분류코드 상권업종소분류명 데이터기준일자
20 Q 음식 Q01 한식 Q01A18 황태전문 2015-12-17


참고

댓글남기기

참고

LLM 모델 저장 형식 GGML, GGUF

GPT와 같은 언어 모델에 사용되는 두 가지 혁신적 파일 형식, GGUF와 GGML에 대해 소개하겠습니다. 이들의 차이점과 각각의 장단점을 살펴보겠습니다. 이 글은 What is GGUF and GGML?의 내용을 한글로 번역/정리한 글입니다.

파이썬으로 구글 주소록 조회하기(feat.Google People API)

파이썬으로 구글 주소록에 저장된 연락처 목록을 조회하는 방법에 대해 알아본다. 이 기능을 구현하려면 구글 계정과 GCP 프로젝트가 필요하다. Google People API를 사용해 구글 주소록 서비스에 접근할 수 있다. 일반적으로 해당 API는 웹/앱 서비스에 통합해 사용자들 각...