Loads shot events scraped from the WNBA Stats API
(shotchartdetail-style outputs). One row per shot attempt with court
coordinates, shot type, distance, and made/missed flag. Backed by the
wehoop-wnba-stats-data pipeline that reads raw JSONs from
wehoop-wnba-stats-raw and publishes parquet/rds artifacts to the
wnba_stats_shots release tag.
load_wnba_stats_shots_manifest() returns the per-season
manifest CSV (season, row_count, generated_at_utc,
source_endpoint) for the WNBA Stats shots release tag without
downloading any season's full data.
Usage
load_wnba_stats_shots(
seasons = most_recent_wnba_stats_season(),
...,
dbConnection = NULL,
tablename = NULL
)
load_wnba_stats_shots_manifest()Arguments
- seasons
A vector of 4-digit years associated with given WNBA seasons. (Min: 1997)
- ...
Additional arguments passed to an underlying function that writes the season data into a database.
- dbConnection
A
DBIConnectionobject, as returned byDBI::dbConnect()- tablename
The name of the shots data table within the database
Value
Returns a wehoop_data tibble with one row per shot attempt.
| col_name | types | description |
| season | integer | Season identifier (4-digit year or 'YYYY-YY' string). |
| game_id | character | Unique game identifier. |
| game_event_id | character | Unique identifier for game event. |
| player_id | character | Unique player identifier. |
| player_name | character | Player name. |
| team_id | character | Unique team identifier. |
| team_name | character | Full team display name (e.g. 'Las Vegas Aces'). |
| period | integer | Period of the game (1-4 quarters; 5+ for OT). |
| minutes_remaining | integer | Minutes remaining. |
| seconds_remaining | integer | Seconds remaining in the period. |
| event_type | character | Event / play type code (V2 PBP). |
| action_type | character | Action type label (e.g. 'Made Shot', 'Substitution'). |
| shot_type | character | Shot type label (e.g. 'Jump Shot', 'Layup'). |
| shot_zone_basic | character | Shot zone (e.g. 'Restricted Area', 'Mid-Range', 'Above the Break 3'). |
| shot_zone_area | character | Shot zone area ('Left Side', 'Right Side', 'Center'). |
| shot_zone_range | character | Shot zone range ('Less Than 8 ft.', '8-16 ft.', '16-24 ft.', etc.). |
| shot_distance | numeric | Shot distance from the basket, in feet. |
| loc_x | numeric | X coordinate on the court (units of inches; 0 = basket center). |
| loc_y | numeric | Y coordinate on the court (units of inches; baseline at 0). |
| coordinate_x | numeric | X coordinate on the court (half-court layout). |
| coordinate_y | numeric | Y coordinate on the court (half-court layout). |
| shot_attempted_flag | integer | 1 if a shot was attempted on this event. |
| shot_made_flag | integer | 1 if the shot was made; 0 if missed. |
See also
Other WNBA Stats loader functions:
load_wnba_stats_coaches(),
load_wnba_stats_draft(),
load_wnba_stats_game_rosters(),
load_wnba_stats_lineups(),
load_wnba_stats_officials(),
load_wnba_stats_pbp(),
load_wnba_stats_player_game_logs(),
load_wnba_stats_player_stats(),
load_wnba_stats_rosters(),
load_wnba_stats_schedule(),
load_wnba_stats_standings(),
load_wnba_stats_team_stats()
Examples
# \donttest{
try(load_wnba_stats_shots(seasons = most_recent_wnba_stats_season()))
#> ──────────────────────────────────────────────────────────────── wehoop 3.0.0 ──
#> # A tibble: 12,144 × 15
#> game_id season period clock team_id person_id action_type sub_type
#> <chr> <int> <dbl> <chr> <int> <int> <chr> <chr>
#> 1 1022600001 2026 1 PT09M44.00S 1.61e9 1642800 Missed Shot Jump Sh…
#> 2 1022600001 2026 1 PT09M25.00S 1.61e9 1627668 Made Shot Turnaro…
#> 3 1022600001 2026 1 PT09M17.00S 1.61e9 1641649 Made Shot Driving…
#> 4 1022600001 2026 1 PT08M34.00S 1.61e9 1629546 Made Shot Step Ba…
#> 5 1022600001 2026 1 PT08M21.00S 1.61e9 203398 Missed Shot Jump Sh…
#> 6 1022600001 2026 1 PT08M15.00S 1.61e9 1631136 Made Shot Running…
#> 7 1022600001 2026 1 PT07M56.00S 1.61e9 1631136 Made Shot Running…
#> 8 1022600001 2026 1 PT07M36.00S 1.61e9 203398 Made Shot Turnaro…
#> 9 1022600001 2026 1 PT07M20.00S 1.61e9 1629546 Missed Shot Step Ba…
#> 10 1022600001 2026 1 PT07M06.00S 1.61e9 204335 Missed Shot Running…
#> # ℹ 12,134 more rows
#> # ℹ 7 more variables: description <chr>, x_legacy <int>, y_legacy <int>,
#> # shot_distance <int>, shot_value <int>, shot_result <chr>,
#> # points_total <int>
# }