CTG Pro Data Feed

Appearance

Possession Touches Location Velocity Defender ​

The possession_touches_location_velocity_defender section in the markings response contains defender location and movement context for possession touches.

Overview ​

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

Sample Response ​

json
{
  "markings": {
    "possession_touches_location_velocity_defender": [
      {
        "ball_handler_id_nba": 1630180,
        "chance_id_ctg": "chance_4c33ded97f95174cc013b446c3981347",
        "defender_acceleration": -0.74,
        "defender_feet_from_ball_handler_at_touch": 4.82,
        "defender_feet_from_rim_at_touch": 23.17,
        "defender_id_nba": 1627742,
        "defender_location_at_touch_end_x": -34.25,
        "defender_location_at_touch_end_y": 8.44,
        "defender_location_at_touch_start_x": -18.32,
        "defender_location_at_touch_start_y": -8.51,
        "defender_rim_movement_angle_before_touch": -8.36,
        "defender_velocity_after_touch": 6.21,
        "defender_velocity_before_touch": 6.95,
        "game_id_nba": "0022500404",
        "is_three_point_touch": false,
        "period": 1,
        "possession_touch_id_ctg": "possession_touch_71435614ec7ccbc094fe1f0bb3b8e98c",
        "rim_ball_handler_defender_angle_at_touch": 14.71,
        "touch_end_he_frame": 1906,
        "touch_start_he_frame": 1731
      }
    ]
  }
}

Fields ​

Identifiers ​

game_id_nba ​

Type: string

NBA game ID

possession_touch_id_ctg ​

Type: string

CTG-generated unique ID for the possession touch

chance_id_ctg ​

Type: string | Nullable

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

ball_handler_id_nba ​

Type: integer

NBA player ID of the player with the ball

defender_id_nba ​

Type: integer

NBA player ID of the defender

Timing ​

period ​

Type: integer

Period in which the touch occurred

touch_start_he_frame ​

Type: integer

Hawk-Eye frame when the possession touch began

touch_end_he_frame ​

Type: integer

Hawk-Eye frame when the possession touch ended

Location And Movement ​

is_three_point_touch ​

Type: boolean

true if the ballhandler's touch started in a three-point court region.

defender_location_at_touch_start_x ​

Type: float | Unit: feet

Defender x coordinate at the start of the touch

defender_location_at_touch_start_y ​

Type: float | Unit: feet

Defender y coordinate at the start of the touch

defender_location_at_touch_end_x ​

Type: float | Unit: feet | Nullable

Defender x coordinate at the end of the touch. null if the defender location is unavailable at the touch end.

defender_location_at_touch_end_y ​

Type: float | Unit: feet | Nullable

Defender y coordinate at the end of the touch. null if the defender location is unavailable at the touch end.

defender_velocity_before_touch ​

Type: float | Unit: feet/sec

Defender speed before the touch start

defender_velocity_after_touch ​

Type: float | Unit: feet/sec

Defender speed after the touch start

defender_acceleration ​

Type: float | Unit: feet/sec

Change from the defender's speed before the touch start to their speed after the touch start

defender_rim_movement_angle_before_touch ​

Type: float | Unit: degrees

Defender movement angle relative to the rim before the touch start

rim_ball_handler_defender_angle_at_touch ​

Type: float | Unit: degrees

Angle between the rim, ballhandler, and defender at the touch start

defender_feet_from_ball_handler_at_touch ​

Type: float | Unit: feet

Defender distance from the ballhandler at the touch start

defender_feet_from_rim_at_touch ​

Type: float | Unit: feet

Defender distance from the rim at the touch start