fetch_strava_activities {Athlytics}R Documentation

(Internal) Fetch and Compile Strava Activities

Description

Helper function to get Strava activity data within a date range.

Usage

fetch_strava_activities(
  stoken,
  start_date = NULL,
  end_date = NULL,
  fetch_details = FALSE,
  required_cols = c("average_watts", "average_heartrate"),
  delay = 1
)

Arguments

stoken

A valid Strava token from 'rStrava::strava_oauth()'.

start_date

Optional. Start date (YYYY-MM-DD or Date/POSIXct) for fetching. Defaults to ~2009.

end_date

Optional. End date (YYYY-MM-DD or Date/POSIXct) for fetching. Defaults to now.

fetch_details

Fetch detailed data for each activity using 'get_activity()'? Needed for power/HR metrics but much slower and uses more API calls. Default 'FALSE'.

required_cols

If 'fetch_details = TRUE', which detailed columns to attempt to extract (e.g., 'c("average_watts", "average_heartrate")').

delay

Seconds to pause between 'get_activity' calls when 'fetch_details = TRUE' to manage API rate limits. Default 1.

Details

Retrieves a summary list of activities and optionally fetches detailed data for each activity if needed for specific metrics (e.g., power). Intended for internal use within the package.

This function wraps 'rStrava::get_activity_list' and 'rStrava::compile_activities'. If 'fetch_details' is enabled, it iteratively calls 'rStrava::get_activity' for each activity, which is the main performance bottleneck and API usage driver.

Value

A tibble of activity data. Columns vary based on 'fetch_details'. Includes a 'date' column derived from 'start_date_local'.


[Package Athlytics version 0.1.2 Index]