오픈API Data 상세보기
편의점
XML WMS사용신청안내사항
공공데이터 제공제도
라이선스표시
- 공공데이터중 위치정보를 포함한 서비스를 사용하고자 하는 사업자는 '위치정보의 보호 및 이용 등에 관한 법률'에 따라 방송통신위원회에 '위치정보서비스 허가'를 받거나 '위치기반 서비스사업 신고'를 하여야 합니다.
- 이에 해당하는 사업자인 경우에는 첨부파일에 '위치기반서비스사업신고필증'을 첨부해 주시기 바랍니다.
- 활용신청 시 '위치기반서비스사업신고필증'이 등록되지 않으면 반려가 될 수 있으니 참고 하시기 바랍니다.
| 주요항목 | 전국 8개업종(음식, 소매업 등) 상가업소 데이터로 해당기준일에 영업중으로 파악된 업소 |
|---|
| 라이선스 |
생활안전지도는 “공공누리 4유형(출처표시,상업적이용금지, 변경금지)” 조건에 따라 이용할 수 있습니다.
|
|---|
| 분류체계 | 시설안전 | 제공기관 | 소상공인시장진흥공단 |
|---|---|---|---|
| 관리부서명 | 상권분석실 | 관리부서 전화번호 | - |
| API 유형 | REST | 데이터 포맷 | XML + WMS |
| 활용 신청 | 130 | 갱신주기 | 1년 |
| 수집일 | 2022년 | 수정일 | 2023-02-13 |
| 주요항목 | 전국 8개업종(음식, 소매업 등) 상가업소 데이터로 해당기준일에 영업중으로 파악된 업소 | ||
| XML 호출 URL | safemap.go.kr/openApiService/data/getConvenienceStoreData.do (아래 예제 참고) | ||
| WMS 호출 URL | safemap.go.kr/openApiService/wms/getLayerData.do (아래 예제 참고) | ||
| OBJT_ID | FCLTY_TY | FCLTY_CD | FCLTY_NM | ADRES | RN_ADRES | TELNO | CTPRVN_CD | SGG_CD | EMD_CD | X | Y | DATA_YR |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 209 | 편의점 | 509010 | 미니스톱 | 강원도 강릉시 주문진읍 교항리 179-1 | 강원도 강릉시 주문진읍 주문로 58-1 | - | 42 | 42150 | 42150250 | 14340832.08 | 4563769.378 | 2022 |
| 210 | 편의점 | 509010 | CU | 강원도 태백시 황지동 7-4 | 강원도 태백시 연지로 38 | - | 42 | 42190 | 42190101 | 14359206.72 | 4463743.334 | 2022 |
| 211 | 편의점 | 509010 | 미니스톱 | 강원도 원주시 문막읍 문막리 238-1 | 강원도 원주시 문막읍 문막시장1길 54 | - | 42 | 42130 | 42130250 | 14228399 | 4481784.829 | 2022 |
| 212 | 편의점 | 509010 | CU | 강원도 정선군 정선읍 애산리 581 | 강원도 정선군 정선읍 애산로 1 | - | 42 | 42770 | 42770250 | 14323458.89 | 4491138.207 | 2022 |
| 213 | 편의점 | 509010 | 정든편의점 | 강원도 원주시 학성동 331-3 | 강원도 원주시 평원로 106 | - | 42 | 42130 | 42130109 | 14243125.54 | 4488532.282 | 2022 |
| 214 | 편의점 | 509010 | CU | 강원도 평창군 용평면 장평리 339-3 | 강원도 평창군 용평면 경강로 1656 | - | 42 | 42760 | 42760350 | 14295096.96 | 4521113.779 | 2022 |
| 215 | 편의점 | 509010 | 코링아세븐 | 강원도 속초시 청학동 482-444 | 강원도 속초시 중앙로 84-2 | - | 42 | 42210 | 42210105 | 14314043.52 | 4607923.622 | 2022 |
| 216 | 편의점 | 509010 | 정선세븐일레븐파인앤유점 | 강원도 정선군 고한읍 고한리 440 | 강원도 정선군 고한읍 고한7길 20 | - | 42 | 42770 | 42770253 | 14344722.8 | 4466248.742 | 2022 |
| 217 | 편의점 | 509010 | 우남 | 강원도 원주시 단계동 866-1 | 강원도 원주시 장미공원길 69 | - | 42 | 42130 | 42130110 | 14241017.82 | 4487435.611 | 2022 |
| 218 | 편의점 | 509010 | CU죽도서프비치점 | 강원도 양양군 현남면 시변리 25-3 | 강원도 양양군 현남면 인구중앙길 99 | - | 42 | 42830 | 42830340 | 14333378.13 | 4575684.534 | 2022 |
편의점 정보조회 서비스
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|
| 인증키 | serviceKey | 필 | 인증키 (URL Encode) | 공공데이터포털에서 발급받은 인증키 |
| 한 페이지 결과 수 | numOfRows | 필 | 10 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 필 | 1 | 페이지 번호 |
| 데이터 타입 | dataType | 옵 | XML | 요청자료형식(XML/JSON) Default : XML |
| 필터 | Fclty_Cd | 필 | 509010 | 편의점 : 509010 |
공통결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기(byte) | 항목타입 |
|---|---|---|---|
| 결과코드 | resultCode | 2 | NUMBER |
| 결과메시지 | resultMsg | 50 | VARCHAR2 |
| 한 페이지 결과 수 | pageIndex | 4 | NUMBER |
| 데이터 총 개수 | totCnt | 4 | NUMBER |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기(byte) | 항목타입 |
|---|---|---|---|
| 일련번호 | OBJT_ID | 38 | NUMBER |
| 상권업종 | FCLTY_TY | 500 | VARCHAR2 |
| 시설코드 | FCLTY_CD | 6 | VARCHAR2 |
| 상호명 | FCLTY_NM | 500 | VARCHAR2 |
| 지번주소 | ADRES | 500 | VARCHAR2 |
| 도로명주소 | RN_ADRES | 500 | VARCHAR2 |
| 전화번호 | TELNO | 20 | VARCHAR2 |
| 시도코드 | CTPRVN_CD | 2 | VARCHAR2 |
| 시군구코드 | SGG_CD | 5 | VARCHAR2 |
| 읍면동코드 | EMD_CD | 8 | VARCHAR2 |
| X좌표 | X | NUMBER | |
| Y좌표 | Y | NUMBER | |
| 데이터기준일자 | DATA_YR | 20 | VARCHAR2 |
제공 데이터 예제
/* JAVA 샘플 코드 */
StringBuilder strBuilder = new StringBuilder("http://safemap.go.kr/openApiService/data/getConvenienceStoreData.do"); /*URL*/
strBuilder.append("?" + URLEncoder.encode("serviceKey","UTF-8") + "=서비스키"); /*Service Key*/
strBuilder.append("&" + URLEncoder.encode("pageNo","UTF-8") + "=" + URLEncoder.encode("1", "UTF-8")); /*페이지번호*/
strBuilder.append("&" + URLEncoder.encode("numOfRows","UTF-8") + "=" + URLEncoder.encode("10", "UTF-8")); /*한 페이지 결과 수*/
strBuilder.append("&" + URLEncoder.encode("type","UTF-8") + "=" + URLEncoder.encode("xml", "UTF-8")); /*xml(기본값), JSON*/
URL url = new URL(strBuilder.toString());
HttpURLConnection con = (HttpURLConnection) url.openConnection();
*서비스 범례 호출(XML)
layer=레이어명&style=스타일명 (스타일명이 없는 서비스의 경우 layer 만 입력)
예) http://www.safemap.go.kr/legend/legendApiXml.do?apikey=인증키&layer=A2SM_CMMNPOI&style=A2SM_CMMNPOI_08
편의점
요청변수(Request Parameter)
| 항목명 | 샘플데이터 | 항목설명 |
|---|---|---|
| serviceKey | 인증키 (URL Encode) | 발급받은 인증키 |
| layername | 주제도명 | 서비스 주제도명 |
| styles | 스타일명 | 서비스 스타일명 |
제공 데이터 예제
*서비스 호출
param = { name:'편의점', serverUrl:'www.safemap.go.kr/openApiService/wms/getLayerData.do?apikey=[APIKEY]', layername:'A2SM_CMMNPOI', styles:'A2SM_CMMNPOI_08' }; var wmsLayer = new OpenLayers.Layer.WMS ( param.name, param.serverUrl, { layers: ''+param.layername, styles:param.styles, format: 'image/png', exceptions:'text/xml', transparent: true }, { isBaseLayer: false } );
*서비스 범례 호출(XML)
layer=레이어명&style=스타일명 (스타일명이 없는 서비스의 경우 layer 만 입력) 예) http://www.safemap.go.kr/legend/legendApiXml.do?apikey=인증키&layer=A2SM_CMMNPOI&style=A2SM_CMMNPOI_08
param = { name:'편의점', serverUrl:'www.safemap.go.kr/openApiService/wms/getLayerData.do?apikey=[APIKEY]', layername:'A2SM_CMMNPOI', styles:'A2SM_CMMNPOI_08' }; var wmsLayer = new OpenLayers.Layer.WMS ( param.name, param.serverUrl, { layers: ''+param.layername, styles:param.styles, format: 'image/png', exceptions:'text/xml', transparent: true }, { isBaseLayer: false } );
*서비스 범례 호출(XML)
layer=레이어명&style=스타일명 (스타일명이 없는 서비스의 경우 layer 만 입력) 예) http://www.safemap.go.kr/legend/legendApiXml.do?apikey=인증키&layer=A2SM_CMMNPOI&style=A2SM_CMMNPOI_08