PitchKit
API Reference@pitchkit/data-providersstatsbombInterfaces

StatsBombThreeSixtyFrame

Defined in: packages/data-providers/src/statsbomb/types.ts:301

One row of a match's three-sixty/{match_id}.json file — StatsBomb's optical tracking data: every player the broadcast camera could see at the moment of one event.

event_uuid is the matching StatsBombEvent's id — join the two files with indexThreeSixtyByEvent. Not every event has a frame — coverage varies by match (85% of events in one sampled World Cup match, for instance) since 360 tracking only runs on events with a camera view (StatsBomb's own coverage, not something this package filters) — so always check the join rather than assuming one exists.

Properties

PropertyModifierTypeDescriptionDefined in
event_uuidreadonlystring-packages/data-providers/src/statsbomb/types.ts:302
freeze_framereadonlyreadonly StatsBombThreeSixtyPlayer[]-packages/data-providers/src/statsbomb/types.ts:311
visible_areareadonlyreadonly number[]The pitch area the broadcast camera actually covered for this frame — a polygon as StatsBomb encodes it, a flat [x0, y0, x1, y1, ...] list of vertex pairs rather than [[x, y], ...]. freeze_frame only lists players StatsBomb could see inside it. Use visibleAreaPolygon to get point pairs for a PitchKit Polygon layer.packages/data-providers/src/statsbomb/types.ts:310

On this page