Skip to contents

Returns the NHL Edge shot-location detail payload for a single skater (heatmap-style data). Wraps https://api-web.nhle.com/v1/edge/skater-shot-location-detail/{playerId}/.... When season is NULL (default) the /now endpoint is used to fetch the current season.

Usage

nhl_edge_skater_shot_location_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
areacharacterShot location area on the ice.
sogintegerShots on goal from the area.
goalsintegerGoals scored from the area.
shooting_pctgnumericShooting percentage from the area.
sog_percentilenumericLeague percentile rank for shots on goal.
goals_percentilenumericLeague percentile rank for goals.
shooting_pctg_percentilenumericLeague percentile rank for shooting percentage.

Examples

# \donttest{
  try(nhl_edge_skater_shot_location_detail(player_id = 8478402))
#> ── NHL Edge Skater Shot Location Detail ────────────── fastRhockey 1.0.0.9000 ──
#> ℹ Data updated: 2026-10-13 01:57:20 UTC
#> # A tibble: 17 × 7
#>    area                  sog goals shooting_pctg sog_percentile goals_percentile
#>    <chr>               <int> <int>         <dbl>          <dbl>            <dbl>
#>  1 Behind the Net          1     0         0              0.993            0.995
#>  2 Beyond Red Line         0     0        NA              0.856            0.988
#>  3 Center Point            1     0         0              0.951            0.988
#>  4 Crease                  1     0         0              0.933            0.905
#>  5 High Slot               3     1         0.333          0.974            0.986
#>  6 L Circle                0     0        NA              0.491            0.914
#>  7 L Corner                0     0        NA              0.970            0.995
#>  8 L Net Side              1     1         1              0.970            1    
#>  9 L Point                 0     0        NA              0.826            0.998
#> 10 Low Slot                3     0         0              0.713            0.634
#> 11 Offensive Neutral …     1     1         1              0.982            1    
#> 12 Outside L               0     0        NA              0.653            0.977
#> 13 Outside R               0     0        NA              0.724            0.982
#> 14 R Circle                1     0         0              0.806            0.924
#> 15 R Corner                0     0        NA              0.993            1    
#> 16 R Net Side              0     0        NA              0.787            0.977
#> 17 R Point                 0     0        NA              0.826            0.991
#> # ℹ 1 more variable: shooting_pctg_percentile <dbl>
# }