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.1.0 ──
#> ℹ Data updated: 2026-11-13 21:32:15 UTC
#> # A tibble: 17 × 7
#>    area                  sog goals shooting_pctg sog_percentile goals_percentile
#>    <chr>               <int> <int>         <dbl>          <dbl>            <dbl>
#>  1 Behind the Net          2     0         0              0.988            0.988
#>  2 Beyond Red Line         0     0        NA              0.675            0.966
#>  3 Center Point            1     0         0              0.825            0.958
#>  4 Crease                  4     2         0.5            0.972            0.982
#>  5 High Slot               5     1         0.2            0.881            0.927
#>  6 L Circle                7     1         0.143          0.944            0.940
#>  7 L Corner                0     0        NA              0.944            0.996
#>  8 L Net Side              1     1         1              0.818            0.988
#>  9 L Point                 1     0         0              0.837            0.978
#> 10 Low Slot               15     3         0.2            0.889            0.895
#> 11 Offensive Neutral …     2     1         0.5            0.950            0.998
#> 12 Outside L               2     0         0              0.810            0.934
#> 13 Outside R               3     0         0              0.911            0.942
#> 14 R Circle                9     1         0.111          0.968            0.946
#> 15 R Corner                0     0        NA              0.964            0.998
#> 16 R Net Side              3     1         0.333          0.960            0.996
#> 17 R Point                 0     0        NA              0.587            0.970
#> # ℹ 1 more variable: shooting_pctg_percentile <dbl>
# }