CTG Pro Data Feed

Appearance

Dribbles Location Velocity Defender ​

The dribbles_location_velocity_defender section in the markings response contains defender location and movement context for dribble events.

Overview ​

Each record represents one defender for one dribble, so there will be five records for a given dribble--one for each defender on the court.

Sample Response ​

json
{
  "markings": {
    "dribbles_location_velocity_defender": [
      {
        "ball_handler_id_nba": 1642843,
        "chance_id_ctg": "chance_51bfc1fda2cc0deb125bee9988859667",
        "defender_acceleration": -0.59,
        "defender_feet_from_ball_handler_at_dribble": 5.11,
        "defender_feet_from_rim_at_dribble": 27.34,
        "defender_id_nba": 1627742,
        "defender_location_at_dribble_x": -18.24,
        "defender_location_at_dribble_y": 5.38,
        "defender_rim_movement_angle_before_dribble": 9.41,
        "defender_velocity_after_dribble": 6.79,
        "defender_velocity_before_dribble": 7.38,
        "dribble_he_frame": 241,
        "dribble_id_ctg": "dribble_f00be85fa245d2860c8f25018a840e62",
        "game_id_nba": "0022500404",
        "period": 1,
        "rim_ball_handler_defender_angle_at_dribble": 12.68
      }
    ]
  }
}

Fields ​

Identifiers ​

game_id_nba ​

Type: string

NBA game ID

dribble_id_ctg ​

Type: string

CTG-generated unique identifier for the dribble

chance_id_ctg ​

Type: string | Nullable

CTG-generated chance ID that contains this dribble. null if the dribble could not be associated with a chance.

ball_handler_id_nba ​

Type: integer

NBA player ID of the dribbler

defender_id_nba ​

Type: integer

NBA player ID of the defender

Timing ​

period ​

Type: integer

Period in which the dribble occurred

dribble_he_frame ​

Type: integer

Hawk-Eye frame when the dribble started

Location And Movement ​

defender_location_at_dribble_x ​

Type: float | Unit: feet

Defender x coordinate when the dribble started

defender_location_at_dribble_y ​

Type: float | Unit: feet

Defender y coordinate when the dribble started

defender_velocity_before_dribble ​

Type: float | Unit: feet/sec

Defender speed before the dribble started

defender_velocity_after_dribble ​

Type: float | Unit: feet/sec

Defender speed after the dribble started

defender_acceleration ​

Type: float | Unit: feet/sec

Change from the defender's speed before the dribble to their speed after the dribble

defender_rim_movement_angle_before_dribble ​

Type: float | Unit: degrees

Defender movement angle relative to the rim before the dribble

rim_ball_handler_defender_angle_at_dribble ​

Type: float | Unit: degrees

Angle between the rim, ballhandler, and defender when the dribble started

defender_feet_from_ball_handler_at_dribble ​

Type: float | Unit: feet

Defender distance from the ballhandler when the dribble started

defender_feet_from_rim_at_dribble ​

Type: float | Unit: feet

Defender distance from the rim when the dribble started