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-02 03:50:54 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.992            0.990
#>  2 Beyond Red Line         0     0        NA              0.705            0.969
#>  3 Center Point            1     0         0              0.860            0.967
#>  4 Crease                  3     2         0.667          0.961            0.992
#>  5 High Slot               5     1         0.2            0.928            0.948
#>  6 L Circle                5     1         0.2            0.944            0.975
#>  7 L Corner                0     0        NA              0.957            0.996
#>  8 L Net Side              1     1         1              0.870            0.990
#>  9 L Point                 0     0        NA              0.670            0.986
#> 10 Low Slot                7     1         0.143          0.672            0.709
#> 11 Offensive Neutral …     2     1         0.5            0.969            1    
#> 12 Outside L               1     0         0              0.736            0.946
#> 13 Outside R               3     0         0              0.948            0.953
#> 14 R Circle                6     1         0.167          0.955            0.973
#> 15 R Corner                0     0        NA              0.969            0.998
#> 16 R Net Side              0     0        NA              0.627            0.946
#> 17 R Point                 0     0        NA              0.643            0.973
#> # ℹ 1 more variable: shooting_pctg_percentile <dbl>
# }