PING

The GridTracker server will always send a ping event which is used to inidicate the connection is alive. Ping messages will be sent every minute.

(CSV Data)
event_timestamp,event_structure_version,ping

(Data Description)
event_timestamp = the time the event occurred in UTC ms
event_structure_version = the version of this event structure; will be 2
ping = the name of the event; will always be ping

LOCATIONS V4

(CSV Data)
event_timestamp,event_structure_version,event_type<ball>,game_clock,play_clock,stop_flag,tag_serial_number,X,Y,Z,distance,Vx,Vy,V
event_timestamp,event_structure_version,event_type<player>,game_clock,play_clock,stop_flag,tag_serial_number,player_id,X,Y,Z,distance,Vx,Vy,V,Ax,Ay,A,direction
event_timestamp,event_structure_version,event_type<sky>,game_clock,play_clock,stop_flag,tag_serial_number,player_id,X,Y,Z,distance,Vx,Vy,V,Ax,Ay,A,direction

(Data Description)
event_timestamp = the time the event occurred in UTC ms
event_structure_version = the version of the event structure; event_structure_version = 4
event_type = player, sky or ball data; sky (skycam) is the same message structure as player with player_id always blank
game_clock = Placeholder for future gameclock - MM:SS.T formatted clock data, MM = minute, SS = second, T = subsecond (depending on time subsecond might be missing)
shot_clock = placeholder for future playclock - SS.T formatted clock data, SS = second, T = subsecond (depending on time subsecond might be missing)
stop_flag = placeholder for future gameclock - 0 if clock is running; 1 if clock is stopped
tag_serial_number = the unique serial number of the device
player_id = GridTracker player ID for player locations; not included for ball
X, Y, Z = mm location of the tag relative to the court coordinate system where the center of the field is 0,0
distance = distance the object has traveled since in the network, a running total in km
Vx, Vy = instantaneous velocities in the x and y directions in m/s
V = speed in m/s
Ax, Ay = acceleration in the x and y direction in m/s
A = absolute acceleration in m/s
direction = the direction of travel in degrees relative to the XY axis where 90 degrees is in the direction of the +Y axis and -90 degrees is the direction of the -Y axis

Sample:
1611805439518,4,player,,,,105645,18672,-6113,-23444,1763,1.2122,0.2122,-1.4215,1.4372,0,0,0,0
1611805439518,4,ball,,,,2147583169,-1004,-23,455,1.2122,0.2122,-1.4215,1.4372,0,0,0,0

Note: if game/shot clock is not available these fields will be empty

Click here to download an example of the v4 player/ball locations. The file is a UDP sample of 2 player tags and 1 ball. We will add additional test files for different testing conditions.

GAME BALL

Indicates a specific ball serial number is the active game ball in play.

(CSV Data)
event_timestamp,event_structure_version,gameball,tag_serial

(Data Description)
event_timestamp = the time the event occurred in UTC ms
event_structure_version = the version of the event structure; event_structure_version = 4
gameball = the name of the event; will always be gameball
tag_serial = the unique serial number of the device

PASS

The local server will auto generated a pass evemt based on the locations of players and ball on the field and is a realtime raw event This differs from the pass event seen in from the clouds logger events as those are human entered as opposed to system generated.

(CSV Data)
event_timestamp,data_version,pass,startpass_timestamp,caughtpass_timestamp,passer_id,receiver_id,maxheight,
distance_downfield,distance_air,receiver_max_velocity,receiver_avg_velocity,ball_max_velocity_xy,ball_avg_velocity_xy,ball_max_velocity_xyz,ball_avg_velocity_xyz

(Data Description)
event_timestamp = the time the event occurred in UTC ms
data_version = the version of the event structure; data_version = 3
pass = the name of the event; will always be pass
startpass_timestamp = the time the pass was made in UTC ms
caughtpass_timestamp = the time the pass was caught in UTC ms
passer_id = GridTracker player ID for the passer
receiver_id = GridTracker player ID for the receiver
maxheight = in millimeters
distance_downfield = in millimeters
distance_air = in millimeters
receiver_max_velocity = m/s
receiver_avg_velocity = m/s
ball_max_velocity_xy = m/s
ball_avg_velocity_xy = m/s
ball_max_velocity_xyz = m/s
ball_avg_velocity_xyz = m/s

LOGGER_EVENT Type

{
    "type": "playEvent",
    "data": {
        "possessingTeamId": <team id>,
        "name": "<Play Events Name>",
        "label": "<Play Events Label>",
        "playId": "<uuid of play>",
        "eventId": "<uuid of event>"
        "playData": [            // optional attribute
            {"type":"<Type of play data in dictionary>","<Field Name of play data in dictionary>":<value of play event data>}
        ]
    }
}

Play Event Object Notes:

• type (string) is always "playEvent" for play event objects

• data.possessingTeamId (number) the id of the team possessing the ball when the event occured

• data.name (string) is a human readable label for the play event

• data.label (string) is a unique identifier for the kind of play event that occurred and is used by GridTracker cloud services for statistic calculations and third-party interfaces

• data.playId (string) the grouping id of the event

• data.eventId (string) the event id

• data.playData (array) is an optional array of play data objects where each play data object provides additional information associated with the play

Play Events

The following game events are captured by GridTracker:

Play Event Notes:

• For certain play events, additional data is captured by the logger

• See Play Events Data Dictionary section for a full description of captured play event data

• The event label is a unique play event identifier used by GridTracker for statistic calculations

• Penalty events can occur either during normal game play or as a consequence of a game penalty

Play Data Dictionary

** AT Structure **

• team (number) the side of the field denoted by the defending team id; i.e. “The Chiefs (team) 25”

• yardage (number) the yard line on that side of the field; i.e. “The Chiefs 25 (yardage)”

SERVER_EVENT Type

PASS

A system generated event that represents location details of a pass. The fields match the same values on the location pass CSV event including the teamIds.

{"type":"SERVEREVENT",
"data":{
  "startTimestamp":1649780242167,
  "caughtTimestamp":1649780250717,
  "passer":{
    "id":"6844",
    "sensorId":"65575",
    "teamId":"515"
  },
  "receiver":{
    "id":"6844",
    "sensorId":"65575",
    "teamId":"515"
  },
  "maxHeight":5203, // mm
  "distanceDownfield":2079, // mm
  "distanceAir":4279, // mm
  "receiverMaxVelocity":80.2, // m/s
  "receiverAvgVelocity":50.2, // m/s
  "ballMaxVelocityxy": 20.2, // m/s
  "ballAvgVelocityxy": 10.0, // m/s
  "ballMaxVelocityxyz": 20.2, // m/s
  "ballAvgVelocityxyz": 10.0 // m/s
},
"label":"PASS","playData":[{"passedBy":6844}],"possessingTeamId":0}

SNAP Type

A system generated event that occurs when the ball is snapped and indicates the play direction.

{"type":"SERVEREVENT",
"data":{
  "ballSensorId": "98700101",
  "losX": 11,
  "losY": 12,
  "direction": "SOUTH",
  "fieldPosition": {                  
    "side": "NORTH",
    "rawYardsFromCenter": 0.0,
    "yardLine": 50
  }
},
"label":"SNAP","playData":[],"possessingTeamId":0}

TACKLE Type

A system generated event that represents players locations around the ball at the end of play.

{"type":"SERVEREVENT",
"data":{
  "ballSensorId": "98700101",
  "playerSensorId": "65575",
  "playerId": "6844",
  "teamId": "515",
  "playerX": 1693,
  "playerY": 9211,
  "playerZ": 0,
  "sideOfFieldTeamId": 515,
  "distanceDownfield": 2079, // mm
  "defensivePlayersNumber": 1,
  "defensivePlayers": [
    {
      "id": "8462",
      "sensorId": "65726",
      "teamId": "461"
    }
  ]
},
"label":"TACKLE","playData":[],"possessingTeamId":0}

ACTIVE_BALL Type

Returns a string that indicates the serial number of the active ball. This value will change as the ball changes throughout the game.

COMPLETED_PASS Type

A derived event that represents a completed pass. The fields match the same values on the location pass CSV event including the teamIds.

{
  "startTimestamp":1649780242167,
  "caughtTimestamp":1649780250717,
  "passer":{
    "id":"6844",
    "sensorId":"65575",
    "teamId":"515",
    "location": [1, 2]  // x,y
  },
  "receiver":{
    "id":"6844",
    "sensorId":"65575",
    "teamId":"515",
    "location": [3, 4]  // x,y
  },
  "maxHeight":5203, // mm
  "distanceDownfield":2079, // distance from the start of the pass; in mm
  "distanceAir":4279, // mm
  "distanceGained": 2000, // distance from line of scrimmage; in mm 
  "afterCatchDistance": {
    "downfield": 1000, // mm
    "total": 1500 // mm
  },
  "receiverMaxVelocity":80.2, // m/s
  "receiverAvgVelocity":50.2, // m/s
  "ballMaxVelocityxy": 20.2, // m/s
  "ballAvgVelocityxy": 10.0, // m/s
  "ballMaxVelocityxyz": 20.2, // m/s
  "ballAvgVelocityxyz": 10.0, // m/s
  "playId": "73a96e6a-bf54-401e-8f9a-ee066b2e52ae"
}

INCOMPLETED_PASS Type

A derived event that represents an incompleted pass. The fields match the same values on the location pass CSV event including the teamIds.

{
  "startTimestamp":1649780242167,
  "caughtTimestamp":1649780250717,
  "passer":{
    "id":"6844",
    "sensorId":"65575",
    "teamId":"515",
    "location": [1, 2]  // x,y
  },
  "receiver":null,
  "maxHeight":5203, // mm
  "distanceDownfield":2079, // distance from the start of the pass; in mm
  "distanceAir":4279, // mm
  "distanceGained": 0, // distance from line of scrimmage; in mm 
  "afterCatchDistance": {
    "downfield": 0, // mm
    "total": 0 // mm
  },
  "receiverMaxVelocity":80.2, // m/s
  "receiverAvgVelocity":50.2, // m/s
  "ballMaxVelocityxy": 20.2, // m/s
  "ballAvgVelocityxy": 10.0, // m/s
  "ballMaxVelocityxyz": 20.2, // m/s
  "ballAvgVelocityxyz": 10.0, // m/s
  "playId": "73a96e6a-bf54-401e-8f9a-ee066b2e52ae"
}

INTERCEPTION Type

A derived event that represents an intercepted pass. The fields match the same values on the location pass CSV event including the teamIds.

{
    "startTimestamp": 1649780242167,
    "caughtTimestamp": 1649780250717,
    "passer": {
      "id": "8462",
      "sensorId": "65726",
      "teamId": "461",
      "location": [1, 2]  // x,y
    },
    "receiver": {
      "id": "6844",
      "sensorId": "65575",
      "teamId": "515",
      "location": [3, 4]  // x,y
    },
    "maxHeight": 5203, // mm
    "distanceDownfield": 2079, // distance from the start of the pass; in mm
    "distanceAir": 4279, // mm
    "distanceGained": 2000, // distance from line of scrimmage; in mm 
    "afterCatchDistance": {
      "downfield": 1000, // mm
      "total": 1500 // mm
    },
    "receiverMaxVelocity":80.2, // m/s
    "receiverAvgVelocity":50.2, // m/s
    "ballMaxVelocityxy": 20.2, // m/s
    "ballAvgVelocityxy": 10.0, // m/s
    "ballMaxVelocityxyz": 20.2, // m/s
    "ballAvgVelocityxyz": 10.0, // m/s
    "playId": "73a96e6a-bf54-401e-8f9a-ee066b2e52ae"
  }
}

POSSESSION Type

A system generated event that represents the exact point in time and location a player either “GOT” or “LOST” possesssion of the football. The fieldPosition object contains the side (NORTH (or right side) or SOUTH (or left side) from a broadcast viewpoint) and the yardline values.

{"type":"PLAYEVENT",
"data":{
  "type":"LOST",  // possible values are GOT or LOST
  "playerSensorId":"65586",
  "playerX":1693,
  "playerY":9211,
  "playerZ":0,
  "playerId":6846,
  "teamId":123,
  "ballSensorId":"2147582453",
  "downfieldDistance":4500,  // mm, determined with LOST possession; always 0 for GOT possession
  "totalDistance":5000,  // mm, determined with LOST possession; always 0 for GOT possession
  "maxVelocity":10.5,  // m/s, determined with LOST possession; always 0.0 for GOT possession
  "avgVelocity":8.0,  // m/s, determined with LOST possession; always 0.0 for GOT possession
  "fieldPosition": {
    "side":"NORTH",
    "rawYardsFromCenter":10.07,
    "yardLine":40
  }
},
"label":"UNDEFINED","playData":[],"possessingTeamId":0}

RUSH Type

A derived event that represents specific rush attributes from a HANDOFF or RUN logger event.

{
  "startTimestamp": 1649780242167,
  "endTimestamp": 1649780247000,
  "passer": {
    "id": 6846,
    "sensorId": "65586",
    "teamId": 12,
    "locations": {
      "atStart": [1, 2],  // x,y
      "atEnd": [] // x,y
    }
  },
  "receiver": { // in the case of a RUN the passer and receiver will be the same player
    "id": 6897,
    "sensorId": "65587",
    "teamId": 12,
    "locations": {
      "atStart": [3, 4],  // x,y
      "atEnd": [5, 6] // x,y
    }
  },
  "distance": {
    "downfield": 20000, // distance from the start of the rush; in mm
    "total": 21500, // scramble distance; in mm
    "gained": 19000 // distance from line of scrimmage; in mm 
  },
  "speed": {
    "maxVelocity": 20.5, // in m/s
    "avgVelocity": 15.0  // in m/s
  },
  "playId": "73a96e6a-bf54-401e-8f9a-ee066b2e52ae"
}

LINE_OF_SCRIMMAGE Type

A system generated event that represents the current line of scrimmage.

{"type":"SERVEREVENT",
"data":{
  "ballSensorId": "98700101",
  "ballX": 11,
  "ballY": 12,
  "ballZ": 13,
  "fieldPosition": {                  
    "side": "NORTH",
    "rawYardsFromCenter": 0.0,
    "yardLine": 50
  }
},
"label":"UNDEFINED","playData":[{"spottedAt":50}],"possessingTeamId":0}

CROSS_GOAL_LINE Type

A system generated event that occurs when a ball traverses the goal line.

{"type":"SERVEREVENT",
"data":{
  "ballSensorId": "98700101",
  "ballX": 11,
  "ballY": 12,
  "ballZ": 13,
  "fieldPosition": {                  
    "side": "NORTH",
    "rawYardsFromCenter": 0.0,
    "yardLine": 50
  }
},
"label":"UNDEFINED","playData":[{"spottedAt":50}],"possessingTeamId":0}

CROSS_SIDE_LINE Type

A system generated event that occurs when a ball traverses the side line.

{"type":"SERVEREVENT",
"data":{
  "ballSensorId": "98700101",
  "ballX": 11,
  "ballY": 12,
  "ballZ": 13,
  "fieldPosition": {                  
    "side": "NORTH",
    "rawYardsFromCenter": 0.0,
    "yardLine": 50
  }
},
"label":"UNDEFINED","playData":[{"spottedAt":50}],"possessingTeamId":0}

MARKER Type

Returns a string that marks the active state of the game.

Game Status Markers

• Example marker (application/json)

  {"seq":"5","type":"data","source":"marker","data":{"t":1665763312858,"gameId":"f29b2985-4bd7-11ed-9596-0242e9e2912e","status":"PLAY_START"}}

END_OF_PLAY Type

A system generated event that represents the pre-determined spot at the end of play.

{"type":"SERVEREVENT",
"data":{
  "ballSensorId": "98700101",
  "ballX": 11,
  "ballY": 12,
  "ballZ": 13,
  "distanceLos": "LOSS", // possible values are LOSS or GAIN
  "fieldPosition": {                  
    "side": "NORTH",
    "rawYardsFromCenter": 0.0,
    "yardLine": 50
  },
  "sideOfFieldTeamId": 515
},
"label":"SNAP","playData":[],"possessingTeamId":0}

END_OF_PLAY_SPOT Type

A system generated event that represents the actual spot at the end of play.

{"type":"SERVEREVENT",
"data":{
  "ballSensorId": "98700101",
  "ballX": 11,
  "ballY": 12,
  "ballZ": 13,
  "distanceLos": 3000,
  "fieldPosition": {                  
    "side": "NORTH",
    "rawYardsFromCenter": 0.0,
    "yardLine": 50
  },
  "sideOfFieldTeamId": 515
},
"label":"SNAP","playData":[],"possessingTeamId":0}

FIELD_GOAL Type

A system generated event that represents the positional data of the ball as it traverses through the uprights.

{"type":"SERVEREVENT",
"data":{
  "ballX": 11,
  "ballY": 12,
  "ballZ": 13,
  "kickX": 14,
  "kickY": 15,
  "fgMakeTimestamp": 1678823745000,
  "durationFlight": 4000,
  "maxHeight": 13716,
  "distance": 3000,
  "maxProjectedDistance": 2500,
  "maxVelocity": 10.5, // m/s
  "sideOfFieldTeamId": 515
},
"label":"UNDEFINED","playData":[],"possessingTeamId":0}

LOCATION_PUNT Type

A system generated event that represents players locations around the player at the punt.

{"type":"SERVEREVENT",
"data":{
  "playerSensorId": "65575",
  "playerId": "6844",
  "teamId": "515",
  "recvPlayerId": "6845",
  "recvTeamId": "512",
  "recvPlayerSensorId": "65576",
  "kickX": 1693,
  "kickY": 9211,
  "kickZ": 0,
  "kickTimestamp": 1678823745000,
  "recvX": 1721,
  "recvY": 8761,
  "recvZ": 0,
  "durationFlight": 4000,
  "maxHeight": 5203,
  "distance": 4279,
  "maxVelocity": 10.5,
  "sideOfFieldTeamId": 515
  ]
},
"label":"UNDEFINED","playData":[],"possessingTeamId":0}