Versions Compared

Version Old Version 2 New Version 3
Changes made by

Martin Kuks

Alexandru Iftimiciuc

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Example Ably LiveAccess URL: https://platform.matchstate.api.geniussports.com/api/v1/sources/GeniusPremium/sports/17/fixtures/10173048/liveaccess/telemetry



Players

Code Block
{
    "type": "players",
    "utcTimestamp": "2022-05-30T08:28:29.425Z",
    "units": {
            "distance": "Yards",
            "time": "Seconds"
    },
    "splitType": "Time",
    "chunks": [{
                "identifier": "2022-06-09T16:00:58.5100763Z",
                "telemetries": [
                    {
                        "playerId": "31051",
                        "teamId": "35168",
                        "speed": 1.13,
                        "signedAcceleration": -0.28,
                        "unsignedAcceleration": 0.43,
                        "distance": 0.11,
                        "orientation": 321.36,
                        "dirLoad": -0.01,
                        "latLoad": 0.01,
                        "direction": 329.48,
                        "isOnField": true,
                        "x": 12.63,
                        "y": 24.97,
                        "z": 0.0,
                        "dataQualityIndex": 98.58
                    },
                    ...
                ]
    }]
}

Element

Type

Description

type

string

Object identifier

utcTimestamp

String($date-time)

Timestamp of the message

units.distance

string($x-extensible-enum)

[ Meters, Yards ]

Unit used for space

units.time

string($x-extensible-enum)

[ Seconds ]

Unit used for time

splitType

string($x-extensible-enum)

[ Time, Frame]

How data are stored in the chunks

chunks.identifier

String

Identifier used for each chunk, it could be the frameId or the time in utc format according to the splitType 

playerId

String

Player Genius Id

teamId

String

Team Genius Id

speed

Float

Speed of the player (in yards)

signedAcceleration

Float

The signed acceleration value. it it can have negative values and not directional.

unsignedAcceleration

Float

Acceleration of the player

distance

Float

Distance since last timestamp (in yards)

orientation

Float

Orientation of the player

dirLoad

Float

Load acting coincident with the direction of travel

latLoad

Float

Load acting orthogonal to the direction of travel

direction

Float

Direction of the player

isOnField

Boolean

Indicates if the player is on the field

dataQualityIndex

Float

Quality of the tracking from 0 (bad) to 200 (exceptional)

x

Float

x-coordinate of the player

y

Float

y-coordinate of the player

z

Float

z-coordinate of the player

Balls

Code Block
{
    "type": "balls",
    "utcTimestamp": "2022-05-30T08:28:29.425Z",
    "units": {
            "distance": "Yards",
            "time": "Seconds"
    },
    "splitType": "Time",
    "chunks": [{
                "identifier": "2022-06-09T16:00:58.5100763Z",
                "telemetries": [
                    {
                        "ballId": "abcd",
                        "speed": 10.1,
                        "signedAcceleration": 10.1,
                        "unsignedAcceleration": 10.1,
                        "distance": 10.1,
                        "isActiveInThePlay": false,
                        "isOnField": true,
                        "x": 10.1,
                        "y": 10.1,
                        "z": 10.1,
                        "dataQualityIndex": 0.0
                    },
                    ...
                ]
    }]
}

Element

Type

Description

type

string

Object identifier

utcTimestamp

String($date-time)

Timestamp of the message

units.distance

string($x-extensible-enum)

[ Meters, Yards ]

Unit used for space

units.time

string($x-extensible-enum)

[ Seconds ]

Unit used for time

splitType

string($x-extensible-enum)

[ Time, Frame]

How data are stored in the chunks

chunks.identifier

String

Identifier used for each chunk, it could be the frameId or the time in UTC format according to the splitType 

ballId

String

Ball Id

speed

Float

Speed of the player (in yards)

signedAcceleration

Float

The signed acceleration value. it it can have negative values and not directional.

unsignedAcceleration

Float

Acceleration of the player

distance

Float

Distance since last timestamp (in yards)

isActiveInThePlay

Boolean

Indicates if it's the active ball

isOnField

Boolean

Indicates if the balls on the field

dataQualityIndex

Float

Quality of the tracking from 0 (bad) to 200 (exceptional)

x

Float

x-coordinate of the ball

y

Float

y-coordinate of the ball

z

Float

z-coordinate of the ball

Objects

Code Block
{
    "type": "objects",
    "utcTimestamp": "2022-05-30T08:28:29.425Z",
    "units": {
            "distance": "Yards",
            "time": "Seconds"
    },
    "splitType": "Time",
    "chunks": [{
                "identifier": "2022-06-09T16:00:58.5100763Z",
                "telemetries": [
                    {
                        "objectType": "CHAIN_UNIT_2",
                        "x": 60.0,
                        "y": 70.0,
                        "z": 80.0,
                        "dataQualityIndex": 90.0
                    },
                    ...
                ]
    }]
}

Element

Type

Description

type

string

Object identifier

utcTimestamp

String($date-time)

Timestamp of the message

units.distance

string($x-extensible-enum)

[ Meters, Yards ]

Unit used for space

units.time

string($x-extensible-enum)

[ Seconds ]

Unit used for time

splitType

string($x-extensible-enum)

[ Time, Frame]

How data are stored in the chunks

chunks.identifier

String

Identifier used for each chunk, it could be the frameId or the time in UTC format according to the splitType 

objectType

string($x-extensible-enum)

[ OFFICIAL_DOWN_INDICATOR_1, BACKUP_OFFICIAL_DOWN_INDICATOR_1, OFFICIAL_DOWN_INDICATOR_2, BACKUP_OFFICIAL_DOWN_INDICATOR_2, SECOND_BACKUP_OFFICIAL_DOWN_INDICATOR_2, BULLS_EYE, BACKUP_BULLS_EYE, CHAIN_UNIT_1, BACKUP_CHAIN_UNIT_1, CHAIN_UNIT_2, BACKUP_CHAIN_UNIT_2, DRIVE_START_MARKER, BACKUP_DRIVE_START_MARKER, PYLON_1, PYLON_2, PYLON_3, PYLON_4, PYLON_5, PYLON_6, PYLON_7, PYLON_8]

Type of object

dataQualityIndex

Float

Quality of the tracking from 0 (bad) to 200 (exceptional)

x

Float

x-coordinate of the object

y

Float

y-coordinate of the object

z

Float

z-coordinate of the object