Match Timeline

A set of spans that place the match on the frame timeline, so every other event can be read against periods of play rather than raw frame numbers.

Category: Structure

Properties

Property	Type	Description	Values
period	str	Match-period span label. full_game is the whole-video extent; first_half/second_half/match are the detected play spans and their envelope.	full_game, first_half, second_half, match
timeline_confidence	float32	Confidence [0,1] in a detected match_timeline span. High (near 1.0) when a restart anchor and label-free priors agree on the half split; low (near 0.4) for a best-effort fallback boundary. full_game is exact (1.0). Null when unset.

Property Values

period

A set of spans that place the match on the frame timeline, so every other event can be read against periods of play rather than raw frame numbers.

Value	Description
full_game	A single span covering the whole video, from the first frame to the last.
first_half	The first period of play, from its opening restart to the last active play before the break.
second_half	The second period of play, from its opening restart to the last active play.
match	The regulation envelope from the first-half start to the second-half end, including the half-time break.

Querying

Request body for Query Intervals.

{
  "filters": [
    { "type": "match_timeline", "periods": ["full_game"] }
  ]
}

Response

Shape of this event type in the Events endpoint response.

{
  "event_id": "06a0765b-0004-7004-8000-000000000004",
  "start": 737.48,
  "end": 3512.48,
  "label": "first_half",
  "event_type": "match_timeline",
  "team_id": null,
  "timeline_confidence": 0.9
}

label is the period name. full_game is always emitted and spans the whole video. From analysis version 0.5.45 first_half, second_half and match are emitted too when the engine locates the halves; otherwise only full_game is.