Retrieve data for specified Statistics Canada data product for last N periods for specific coordinates
Source:R/cansim_vectors.R
get_cansim_data_for_table_coord_periods.RdAllows for the retrieval of data for a Statistics Canada data table with specific table and coordinates.
This allows partial targeted download of tables and can be effectively combined with the get_cansim_table_template
function to help pinpoint data series of interest.
The StatCan API can only process 300 coordinates at a time,
if more than 300 coordinates are specified the function will batch the requests to the API.
Usage
get_cansim_data_for_table_coord_periods(
tableCoordinates,
periods = NULL,
language = "english",
refresh = FALSE,
timeout = 200,
factors = TRUE,
default_month = "07",
default_day = "01"
)Arguments
- tableCoordinates
Either a list with vectors of coordinates by table number, or a (filtered) data frame as returned by
get_cansim_table_template.- periods
Optional numeric value for number of latest periods to retrieve data for, default is
NULLin which case data for all periods is downloaded. Alternatively this can be specified by coordinate if tableCoordinates is a data frame, this argument will be ignored if that data frame as a "periods" column.- language
"en"or"english"for English and"fr"or"french"for French language versions (defaults to English)- refresh
(Optional) When set to
TRUE, forces a reload of data table (default isFALSE)- timeout
(Optional) Timeout in seconds for downloading cansim table to work around scenarios where StatCan servers drop the network connection.
- factors
(Optional) Logical value indicating if dimensions should be converted to factors. (Default set to
TRUE).- default_month
The default month that should be used when creating Date objects for annual data (default set to "07")
- default_day
The default day of the month that should be used when creating Date objects for monthly data (default set to "01")