Player Possession

A continuous span over which one specific player is the active ball-carrier. Distinct from team_possession: a single team-possession span typically contains many player-possession spans as the ball moves between teammates.

Category: Possession

Properties

Property	Type	Description	Values
confidence_identity	float32	Identity confidence [0,1]. Null for non-actor events and for rows where the jersey/player_id was not resolved (team-only actor rows have this null).	—
model_source	str	Player-possession source: which model produced the span (short / long / mix).	short, long, mix

Property Values

model_source

Which player-possession model produced the span. Exposed so downstream consumers can slice quality metrics by model: the two horizons have different precision and recall trade-offs, and mix is informative in its own right (it correlates with handoff regions). Adding new values is purely additive.

Value	Description
short	Span produced by the short-horizon player-possession model.
long	Span produced by the long-horizon player-possession model.
mix	Blended source within the span. Both models contributed.

Querying

{
  "filters": [
    { "type": "player_possession", "players": ["0-10"] }
  ]
}

Response

Events of this type appear in the Events endpoint response:

{
  "start": 125.5,
  "end": 135.5,
  "label": "0-10",
  "event_type": "player_possession"
}

The label is the player ID or name.