Concepts Overview
This section explains how to interpret the data returned by the API.
Core Concepts
| Concept | Description |
|---|---|
| Pitch Coordinates | Understanding the coordinate system |
| Player IDs | How players are identified |
| Possession | Interpreting possession data |
| Speed & Distance | Player movement metrics |
| Webhooks | Real-time event notifications |
Quick Reference
Coordinate System
- Pitch: 105m x 68m
- Origin: Bottom-left corner
- X: 0-105 (left to right)
- Y: 0-68 (bottom to top)
Player IDs
Format: {team}-{jersey}
0-10= Team 0, jersey #101-7= Team 1, jersey #7
Speed Buckets
| Category | Speed (km/h) |
|---|---|
| Walking | 0-7 |
| Jogging | 7-14 |
| Running | 14-21 |
| Sprinting | 21+ |
Possession
team_0= Left-starting teamteam_1= Right-starting teamunknown= Contested or unclear