Skip to contents

Returns the NHL Edge skating-distance detail payload for a single skater (distance covered, strides, etc.). Wraps https://api-web.nhle.com/v1/edge/skater-skating-distance-detail/{playerId}/.... When season is NULL (default) the /now endpoint is used to fetch the current season.

Usage

nhl_edge_skater_skating_distance_detail(
  player_id,
  season = NULL,
  game_type = 2
)

Arguments

player_id

Integer NHL player ID (e.g., 8478402 for Connor McDavid).

season

Optional 4-digit end-year (e.g., 2025 for the 2024-25 season), an 8-character API season (e.g., "20242025"), or NULL (default) for the current season via the /now endpoint.

game_type

Integer game type. 1 = preseason, 2 = regular season (default), 3 = playoffs.

Value

A data frame (fastRhockey_data) with the following columns:

col_nametypesdescription
game_center_linkcharacterLink to the NHL game center page.
game_datecharacterGame date.
player_on_home_teamlogicalWhether the player was on the home team.
toi_allintegerTotal time on ice across all strengths (seconds).
toi_evenintegerTime on ice at even strength (seconds).
toi_pkintegerTime on ice on the penalty kill (seconds).
toi_ppintegerTime on ice on the power play (seconds).
distance_skated_all_imperialnumericDistance skated at all strengths in miles.
distance_skated_all_metricnumericDistance skated at all strengths in kilometers.
distance_skated_even_imperialnumericDistance skated at even strength in miles.
distance_skated_even_metricnumericDistance skated at even strength in kilometers.
distance_skated_pk_imperialnumericDistance skated on the penalty kill in miles.
distance_skated_pk_metricnumericDistance skated on the penalty kill in kilometers.
home_team_abbrevcharacterHome team abbreviation.
home_team_slugcharacterHome team URL slug.
home_team_common_name_defaultcharacterHome team common name.
home_team_place_name_with_preposition_defaultcharacterHome team place name with preposition (English).
home_team_place_name_with_preposition_frcharacterHome team place name with preposition (French).
home_team_team_logo_lightcharacterHome team light logo URL.
home_team_team_logo_darkcharacterHome team dark logo URL.
away_team_abbrevcharacterAway team abbreviation.
away_team_slugcharacterAway team URL slug.
away_team_common_name_defaultcharacterAway team common name.
away_team_place_name_with_preposition_defaultcharacterAway team place name with preposition (English).
away_team_place_name_with_preposition_frcharacterAway team place name with preposition (French).
away_team_team_logo_lightcharacterAway team light logo URL.
away_team_team_logo_darkcharacterAway team dark logo URL.
distance_skated_pp_imperialnumericDistance skated on the power play in miles.
distance_skated_pp_metricnumericDistance skated on the power play in kilometers.

Examples

# \donttest{
  try(nhl_edge_skater_skating_distance_detail(player_id = 8478402))
#> ── NHL Edge Skater Skating Distance Detail ──────────────── fastRhockey 1.0.0 ──
#>  Data updated: 2026-06-13 04:21:14 UTC
#> # A tibble: 6 × 29
#>   game_center_link  game_date player_on_home_team toi_all toi_even toi_pk toi_pp
#>   <chr>             <chr>     <lgl>                 <int>    <int>  <int>  <int>
#> 1 /gamecenter/edm-… 2026-04-… FALSE                  1489     1407     82     NA
#> 2 /gamecenter/ana-… 2026-04-… TRUE                   1449     1118     NA    331
#> 3 /gamecenter/edm-… 2026-04-… FALSE                  1172      999    113     60
#> 4 /gamecenter/edm-… 2026-04-… FALSE                  1430     1201     54    175
#> 5 /gamecenter/ana-… 2026-04-… TRUE                   1447      924    110    413
#> 6 /gamecenter/ana-… 2026-04-… TRUE                   1490     1214     51    225
#> # ℹ 22 more variables: distance_skated_all_imperial <dbl>,
#> #   distance_skated_all_metric <dbl>, distance_skated_even_imperial <dbl>,
#> #   distance_skated_even_metric <dbl>, distance_skated_pk_imperial <dbl>,
#> #   distance_skated_pk_metric <dbl>, home_team_abbrev <chr>,
#> #   home_team_slug <chr>, home_team_common_name_default <chr>,
#> #   home_team_place_name_with_preposition_default <chr>,
#> #   home_team_place_name_with_preposition_fr <chr>, …
# }