Skip to contents

On-court stints of every player of one finished game (the rotation chart).

Endpoint: GET https://api.preciser.io/game/rotation/chart/o/plg/gameId/{uuid}

Usage

pleague_preciser_rotation(uuid, gid = NULL)

Arguments

uuid

Required. The Preciser game uuid the site's game page embeds (uuid of pleague_game; empty before 2022-23, which have no vendor data), e.g. 'e6f98675-3e5b-11ed-949e-5d17350689cf' (gid 197).

gid

Optional. The site's game id for this uuid. When given the runtime also fetches the site's game page and box (cached) and checks the vendor body against them (uuid, final score, made shots, roster and minutes); the uuid must be the game page's. Without it only the checks the body allows by itself run.

Value

A hoopR_data tibble: On-court stints of every player of one finished game (the rotation chart). An empty valid answer is a zero-row tibble with these columns, in this order (sportsdataverse-py pleague_preciser_rotation):

col_nametypedescription
game_uuidcharacterPreciser game uuid (key space: the vendor's games, a version-1 uuid), the uuid asked for; uuid of pleague_game.
sidecharacterWhich team the row belongs to: home or away.
name_zhcharacterPlayer name (Traditional Chinese); equals the site box name_zh, which is how the runtime checks the roster.
jerseyintegerShirt number (an integer here; the box prints it as a string).
startedlogicalTrue when the player started the game.
stint_nointeger1-based position of the stint among the player's stints, in game order.
start_periodcharacterPeriod in which the stint starts (Q1-Q4, OT1, ...).
start_clockcharacterClock REMAINING in start_period when the stint starts, 'm:ss'.
start_secondsintegerSeconds elapsed on the game clock when the stint starts (cumulative across periods).
end_periodcharacterPeriod in which the stint ends.
end_clockcharacterClock REMAINING in end_period when the stint ends, 'm:ss'.
end_secondsintegerSeconds elapsed on the game clock when the stint ends (cumulative across periods).

Details

Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in pleague_preciser_shots().

 pleague_preciser_rotation(uuid = "e6f98675-3e5b-11ed-949e-5d17350689cf")