When you use the TraceVision API, you will create sessions and later retrieve the results of processing those sessions. The types of results you can request include

• tracking: Metadata showing where identified people and things are located over time
• highlights: Metadata of when events of interest occurred
• videos: Pre-edited video (coming later)

A session is soccer footage you want to analyze. For example, a session could be

• a single panned & zoomed video covering a soccer game. The footage starts when the camera is set up before the game, continues throughout play, and ends when the camera is taken down after the final whistle
• an iPhone video filmed around the pitch that capture pieces of the action

When you create a session, you'll need to tell us a bit about it: what kind of footage you want to process, plus some metadata about it.

• To process soccer footage, you'll use the session type soccer_game , and include metadata about the teams that played including their team name, jersey color, and the final score of the game.

The TraceVision backend will process the session and deliver tracking, highlight, and/or video results depending on the session type and what you requested when setting up the session.

Getting started walks through how to create a session and retrieve results.

If you're planning on processing soccer footage, you can also check out our sample code for querying existing sessions, creating a new session, and working with session results.

Identity is critical for understanding the "who" or the "what" over time. We aim to deliver consistent identity for players across the whole sesssion, so if a player has the same label during the session, it's the same person.

• For soccer footage, we label players by their team and jersey number, like "home #7", "away #11". We use players' jersey colors to understand which team they're on.

Tracking data follows a single identity over time and shows where that player appears in the video.

Tracking results can power features like:

• Video overlays highlighting one or more specific players in a sports game, e.g. "halo"-like overlays
• Creating personalized videos that zoom in on a specific player

Check out Using your results for more details about tracking results. Our code samples also include code for working with the tracking results of a processed session.

For footage of soccer games, highlights include times when players touch the ball, or passing sequences

Highlights tell you "when", "what" and "who". They can power features like

• Highlight reels and playlists
• Game recaps

Check out Using your results for more details about higlights. Our code samples include code for working with the highlights results of a processed session.

(Coming soon...)

Pre-edited videos that combine tracking and highlights in some way. We've done the video manipulation so you don't have to.

---