KOSIS 데이터 규모 및 API 호출 기간 산정 정보 계산
get_once_n.Rd이 함수는 KOSIS 데이터의 규모를 파악하고, API 호출 기간을 산정하는 데 필요한 정보를 계산합니다. 수 제한을 고려하여, 데이터의 기간별 셀 수를 계산하고, 이를 기반으로 API 호출 횟수와 각 호출에 필요한 기간 범위를 결정합니다.
Value
list. KOSIS 데이터 규모 및 API 호출 기간 산정 정보가 포함된 리스트 객체. 주요 요소는 다음과 같습니다:
- period_nm
기간 이름 (예: "월", "년" 등).
- period_cd
기간 코드 (예: "M", "Y" 등).
- period_de
기간 데이터 프레임. 각 기간의 시작과 종료 날짜를 포함.
- once_cell
KOSIS API 호출 시 한 번에 가져올 수 있는 최대 셀 수.
- have_n
전체 기간에 대한 셀 수.
- max_n
KOSIS API 호출 시 한 번에 가져올 수 있는 최대 기간 수.
- prd_period_df
API 호출에 필요한 기간 범위를 포함하는 데이터 프레임. 각 행은 API 호출에 필요한 시작과 종료 날짜를 나타냄.
Examples
# \donttest{
# Example usage
tbl_id <- "DT_1YL21171"
org_id <- "101"
get_once_n(tbl_id = tbl_id, org_id = org_id)
#> ℹ KOSIS API URL: https://kosis.kr/openapi/statisticsData.do?method=getMeta&apiKey=NzY0Y2E5MTQ5NDU1NzNjMTQ5ODA5ZWY2YmMwOGUxMjg=&format=json&type=ITM&orgId=101&tblId=DT_1YL21171&jsonVD=Y
#> ℹ KOSIS API URL: https://kosis.kr/openapi/statisticsData.do?method=getMeta&apiKey=NzY0Y2E5MTQ5NDU1NzNjMTQ5ODA5ZWY2YmMwOGUxMjg=&format=json&type=PRD&orgId=101&tblId=DT_1YL21171&jsonVD=Y
#> ℹ KOSIS API URL: https://kosis.kr/openapi/Param/statisticsParameterData.do?method=getList&apiKey=NzY0Y2E5MTQ5NDU1NzNjMTQ5ODA5ZWY2YmMwOGUxMjg=&format=json&orgId=101&tblId=DT_1YL21171&objL1=ALL&itmId=T10+T001+T002&prdSe=Y&objL2=&objL3=&objL4=&objL5=&objL6=&objL7=&objL8=&jsonVD=Y&startPrdDe=2025&endPrdDe=2025
#> $period_nm
#> [1] "년"
#>
#> $period_cd
#> 년
#> "Y"
#>
#> $period_de
#> [1] "2007" "2008" "2009" "2010" "2011" "2012" "2013" "2014" "2015" "2016"
#> [11] "2017" "2018" "2019" "2020" "2021" "2022" "2023" "2024" "2025"
#>
#> $once_cell
#> [1] 10332
#>
#> $have_n
#> [1] 738
#>
#> $max_n
#> [1] 3
#>
#> $prd_period_df
#> prd_start prd_end
#> 1 2007 2009
#> 2 2010 2012
#> 3 2013 2015
#> 4 2016 2018
#> 5 2019 2021
#> 6 2022 2024
#> 7 2025 2025
#>
# }