{ "opencollection": "1.0.0", "info": { "name": "장소 혼잡도", "version": "1.0" }, "request": { "auth": { "type": "apikey", "key": "appkey", "value": "{{appkey}}", "placement": "header" } }, "items": [ { "info": { "name": "Place", "type": "folder" }, "items": [ { "info": { "name": "데이터 제공 가능 장소", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/meta/pois", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ] }, "docs": "* 장소 혼잡도 데이터를 조회할 수 있는 관심 장소(POI)의 ID 및 장소 이름을 제공합니다.\n" }, { "info": { "name": "데이터 제공 가능 상권", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/meta/areas", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ] }, "docs": "* 혼잡도 데이터를 조회할 수 있는 상권(AREA)의 ID 및 상권 이름을 제공합니다.\n" } ] }, { "info": { "name": "Congestion", "type": "folder" }, "items": [ { "info": { "name": "실시간 장소 혼잡도", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/congestion/rltm/pois/:poiId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "poiId", "value": "", "type": "path", "description": "관심장소(POI) ID" }, { "name": "lat", "value": "", "type": "query", "description": "주변 혼잡도를 구할 중심 위도값" }, { "name": "lng", "value": "", "type": "query", "description": "주변 혼잡도를 구할 중심 경도값" } ] }, "docs": "특정 장소의 실시간 혼잡도를 제공합니다.\n* 조회 시점으로부터 가장 최근에 집계된 혼잡도 정보를 제공합니다.\n* 조회 시점 기준 1시간 동안의 혼잡도(1㎡ 단위 면적당 추정 방문자 수)와 1~4 단계로 구분된 혼잡도 레벨 정보를 제공합니다.\n* 데이터 제공 가능 장소의 poiId로 요청할 경우 특정 장소의 혼잡도 정보를 조회할 수 있습니다. 위경도 좌표를 요청 정보에 추가하면, 특정 좌표 주변의 혼잡도를 조회할 수 있습니다.\n" }, { "info": { "name": "시간대별 장소 혼잡도", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/congestion/stat/raw/hourly/pois/:poiId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "date", "value": "", "type": "query", "description": "기준 일자(YYYYMMDD) 또는 어제(ystday)를 지정, startDate, endDate 입력이 우선합니다." }, { "name": "poiId", "value": "", "type": "path", "description": "관심장소(POI) ID" } ] }, "docs": "특정 장소의 시간대별 혼잡도를 제공합니다.\n* 검색 기준 일자의 시간대별 혼잡도(1 ㎡ 단위 면적당 추정 방문자 수)와 4단계로 구분된 혼잡도 레벨 정보를 제공합니다.\n* 기준 일자(date)를 입력하지 않으면 요청 시간을 기준으로 하루 전(D-1일) 일자의 장소 혼잡도 값을 반환합니다.\n* 기준 일자가 오늘(today)이거나 30일 이상 경과된 일자인 경우 응답에 실패하며 400 에러가 발생합니다.\n" }, { "info": { "name": "통계성 장소 혼잡도", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/congestion/stat/hourly/pois/:poiId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "dow", "value": "", "type": "query", "description": "요일" }, { "name": "poiId", "value": "", "type": "path", "description": "관심장소(POI) ID" } ] }, "docs": "특정 장소의 요일 및 시간대별 통계성 혼잡도를 제공합니다.\n* 평일인 공휴일과 해당 장소의 휴무일을 제외한 최근 30일 동안의 요일 및 시간대별 평균 혼잡도(1㎡ 단위 면적당 추정 방문자 수)와 4단계로 구분된 혼잡도 레벨 정보를 제공합니다.\n" }, { "info": { "name": "실시간 상권 혼잡도", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/congestion/rltm/areas/:areaId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "areaId", "value": "", "type": "path", "description": "상권(AREA) ID" } ] }, "docs": "특정 상권의 실시간 혼잡도를 제공합니다.\n* 조회 시점으로부터 가장 최근에 집계된 혼잡도 정보를 제공합니다.\n* 조회 시점 기준 1시간 동안의 혼잡도(1㎡ 단위 면적당 추정 방문자 수)와 1~4 단계로 구분된 혼잡도 레벨 정보를 제공합니다.\n* 데이터 제공 가능 상권의 areaId로 요청할 경우 특정 상권의 혼잡도 정보를 조회할 수 있습니다.\n" }, { "info": { "name": "시간대별 상권 혼잡도", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/congestion/stat/raw/hourly/areas/:areaId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "date", "value": "", "type": "query", "description": "기준 일자(YYYYMMDD) 또는 어제(ystday)를 지정, startDate, endDate 입력이 우선합니다." }, { "name": "areaId", "value": "", "type": "path", "description": "상권(AREA) ID" } ] }, "docs": "특정 상권의 시간대별 혼잡도를 제공합니다.\n* 검색 기준 일자의 시간대별 혼잡도(1 ㎡ 단위 면적당 추정 방문자 수)와 4단계로 구분된 혼잡도 레벨 정보를 제공합니다.\n* 기준 일자(date)를 입력하지 않으면 요청 시간을 기준으로 하루 전(D-1일) 일자의 상권 혼잡도 값을 반환합니다.\n* 기준 일자가 오늘(today)이거나 30일 이상 경과된 일자인 경우 응답에 실패하며 400 에러가 발생합니다.\n" }, { "info": { "name": "통계성 상권 혼잡도", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/congestion/stat/hourly/areas/:areaId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "dow", "value": "", "type": "query", "description": "요일" }, { "name": "areaId", "value": "", "type": "path", "description": "상권(AREA) ID" } ] }, "docs": "특정 상권의 요일 및 시간대별 통계성 혼잡도를 제공합니다.\n* 평일인 공휴일과 해당 장소의 휴무일을 제외한 최근 30일 동안의 요일 및 시간대별 평균 혼잡도(1㎡ 단위 면적당 추정 방문자 수)와 4단계로 구분된 혼잡도 레벨 정보를 제공합니다.\n" } ] }, { "info": { "name": "Visit", "type": "folder" }, "items": [ { "info": { "name": "일자별 장소 방문자 수", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/visit/count/raw/daily/pois/:poiId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "gender", "value": "", "type": "query", "description": "조회 대상 성별" }, { "name": "ageGrp", "value": "", "type": "query", "description": "조회 대상 연령대" }, { "name": "startDate", "value": "", "type": "query", "description": "기준 시작 일자(YYYYMMDD)" }, { "name": "endDate", "value": "", "type": "query", "description": "기준 종료 일자(YYYYMMDD)" }, { "name": "date", "value": "", "type": "query", "description": "기준 일자(YYYYMMDD) 또는 어제(ystday)를 지정, startDate, endDate 입력이 우선합니다." }, { "name": "range", "value": "", "type": "query", "description": "기준일로부터 조회되는 날짜 범위" }, { "name": "poiId", "value": "", "type": "path", "description": "관심장소(POI) ID" } ] }, "docs": "특정 장소 주변에 10분 이상 체류한 SK텔레콤 회선 사용자 중 거주 인구 및 직장 인구를 제외한 사용자 수에 보정 계수를 곱해 추정 방문자 수를 산출합니다.\n" }, { "info": { "name": "장소 유입력", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/visit/distance/stat/daily/pois/:poiId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "poiId", "value": "", "type": "path", "description": "관심장소(POI) ID" } ] }, "docs": "특정 장소 주변에 10분 이상 체류한 SK텔레콤 회선 사용자 중 거주 인구 및 직장 인구를 제외한 방문자가 얼마나 멀리서 오는지 알 수 있는 중위값을 제공합니다.\n" }, { "info": { "name": "장소 방문자 연령 분포", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/visit/seg/stat/daily/pois/:poiId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "poiId", "value": "", "type": "path", "description": "관심장소(POI) ID" } ] }, "docs": "특정 장소 주변에 10분 이상 체류한 SK텔레콤 회선 사용자 중 거주 인구 및 직장 인구를 제외한 방문자의 연령 분포를 제공합니다.\n" }, { "info": { "name": "일자별 상권 방문자 수", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/visit/count/raw/daily/areas/:areaId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "gender", "value": "", "type": "query", "description": "조회 대상 성별" }, { "name": "ageGrp", "value": "", "type": "query", "description": "조회 대상 연령대" }, { "name": "startDate", "value": "", "type": "query", "description": "기준 시작 일자(YYYYMMDD)" }, { "name": "endDate", "value": "", "type": "query", "description": "기준 종료 일자(YYYYMMDD)" }, { "name": "date", "value": "", "type": "query", "description": "기준 일자(YYYYMMDD) 또는 어제(ystday)를 지정, startDate, endDate 입력이 우선합니다." }, { "name": "range", "value": "", "type": "query", "description": "기준일로부터 조회되는 날짜 범위" }, { "name": "areaId", "value": "", "type": "path", "description": "상권(AREA) ID" } ] }, "docs": "특정 상권에 10분 이상 체류한 SK텔레콤 회선 사용자 중 거주 인구 및 직장 인구를 제외한 사용자 수에 보정 계수를 곱해 추정 방문자 수를 산출합니다.\n" }, { "info": { "name": "상권 유입력", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/visit/distance/stat/daily/areas/:areaId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "areaId", "value": "", "type": "path", "description": "상권(AREA) ID" } ] }, "docs": "특정 상권에 10분 이상 체류한 SK텔레콤 회선 사용자 중 거주 인구 및 직장 인구를 제외한 방문자가 얼마나 멀리서 오는지 알 수 있는 중위값을 제공합니다.\n" }, { "info": { "name": "상권 방문자 연령 분포", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/visit/seg/stat/daily/areas/:areaId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "areaId", "value": "", "type": "path", "description": "상권(AREA) ID" } ] }, "docs": "특정 상권에 10분 이상 체류한 SK텔레콤 회선 사용자 중 거주 인구 및 직장 인구를 제외한 방문자의 연령 분포를 제공합니다.\n" }, { "info": { "name": "상권 방문자 유형 분포", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/visit/type/stat/daily/areas/:areaId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "areaId", "value": "", "type": "path", "description": "상권(AREA) ID" } ] }, "docs": "특정 상권에 10분 이상 체류한 SK텔레콤 회선 사용자의 유형 분포를 제공합니다.\n" } ] }, { "info": { "name": "Area Info", "type": "folder" }, "items": [ { "info": { "name": "상권 업종 분포", "type": "http" }, "http": { "method": "GET", "url": "https://apis.openapi.sk.com/puzzle/place/biz-category/stat/monthly/areas/:areaId", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "appKey", "value": "" } ], "params": [ { "name": "areaId", "value": "", "type": "path", "description": "상권(AREA) ID" } ] }, "docs": "특정 상권의 업종 대소분류별 업체 분포를 제공합니다.\n" } ] } ], "bundled": true }