Shots Location Velocity Defender

The shots_location_velocity_defender section in the markings response contains defender location and movement context for shots.

Overview

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

Sample Response

json

{
  "markings": {
    "shots_location_velocity_defender": [
      {
        "chance_id_ctg": "chance_51bfc1fda2cc0deb125bee9988859667",
        "defender_acceleration": -2.47,
        "defender_feet_from_rim_at_shot": 5.65,
        "defender_feet_from_shot_location_0p2s_after_shot": 1.49,
        "defender_feet_from_shot_location_0p4s_after_shot": 0.05,
        "defender_feet_from_shot_location_0p6s_after_shot": 1.33,
        "defender_feet_from_shooter_0p2s_before_shot": 2.77,
        "defender_feet_from_shooter_0p4s_before_shot": 3.93,
        "defender_feet_from_shooter_0p6s_before_shot": 5.91,
        "defender_feet_from_shooter_0p8s_before_shot": 7.9,
        "defender_feet_from_shooter_1p0s_before_shot": 9.45,
        "defender_feet_from_shooter_at_shot": 3.1,
        "defender_id_nba": 1642852,
        "defender_location_at_first_touch_x": 41.64,
        "defender_location_at_first_touch_y": -4.56,
        "defender_location_at_rebound_x": null,
        "defender_location_at_rebound_y": null,
        "defender_location_at_shot_x": 36.2,
        "defender_location_at_shot_y": 1.04,
        "defender_location_at_shot_end_x": 37.39,
        "defender_location_at_shot_end_y": -0.04,
        "defender_region_at_first_touch": "ra",
        "defender_region_at_rebound": null,
        "defender_region_at_shot_end": "ra",
        "defender_rim_movement_angle_before_shot": 18.87,
        "defender_velocity_angle_to_shooter": 3.98,
        "defender_velocity_after_shot": 7.38,
        "defender_velocity_before_shot": 9.86,
        "game_id_nba": "0022500404",
        "pbp_event_id": 7,
        "period": 1,
        "rim_shooter_defender_angle_at_shot": -115.7,
        "shooter_id_nba": 203076,
        "shot_id_ctg": "shot_105f89542695fcebf740bb7c426ac4c3",
        "shot_start_he_frame": 749
      }
    ]
  }
}

Fields

Identifiers

`game_id_nba`

Type: string

NBA game ID

`shot_id_ctg`

Type: string

CTG-generated unique identifier for the shot

`pbp_event_id`

Type: integer | Nullable

NBA play-by-play event ID for the shot

`chance_id_ctg`

Type: string | Nullable

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

`shooter_id_nba`

Type: integer

NBA player ID of the shooter

`defender_id_nba`

Type: integer

NBA player ID of the defender

Timing

`period`

Type: integer

Period in which the shot occurred

`shot_start_he_frame`

Type: integer

Hawk-Eye frame when the shot began

Location And Movement

`defender_location_at_shot_x`

Type: float | Unit: feet

Defender x coordinate at the shot frame

`defender_location_at_shot_y`

Type: float | Unit: feet

Defender y coordinate at the shot frame

`defender_location_at_shot_end_x`

Type: float | Unit: feet | Nullable

Defender x coordinate at the shot end frame

`defender_location_at_shot_end_y`

Type: float | Unit: feet | Nullable

Defender y coordinate at the shot end frame

`defender_region_at_shot_end`

Type: string | Nullable

Court region label for the defender at the shot end frame

`defender_location_at_first_touch_x`

Type: float | Unit: feet | Nullable

Defender x coordinate when the ball is first touched after the shot ends

`defender_location_at_first_touch_y`

Type: float | Unit: feet | Nullable

Defender y coordinate when the ball is first touched after the shot ends

`defender_region_at_first_touch`

Type: string | Nullable

Court region label for the defender when the ball is first touched after the shot ends

`defender_location_at_rebound_x`

Type: float | Unit: feet | Nullable

For missed shots, defender x coordinate when the ball is first possessed after the shot ends, or when play stops before that possession is established. null for made shots.

`defender_location_at_rebound_y`

Type: float | Unit: feet | Nullable

For missed shots, defender y coordinate when the ball is first possessed after the shot ends, or when play stops before that possession is established. null for made shots.

`defender_region_at_rebound`

Type: string | Nullable

For missed shots, court region label for the defender when the ball is first possessed after the shot ends, or when play stops before that possession is established. null for made shots.

`defender_velocity_before_shot`

Type: float | Unit: feet/sec

Defender speed before the shot frame

`defender_velocity_after_shot`

Type: float | Unit: feet/sec

Defender speed after the shot frame

`defender_acceleration`

Type: float | Unit: feet/sec

Change from the defender's speed before the shot frame to their speed after the shot frame

`defender_rim_movement_angle_before_shot`

Type: float | Unit: degrees

Defender movement angle relative to the rim before the shot frame

`defender_velocity_angle_to_shooter`

Type: float | Unit: degrees

Direction of travel for the defender before the shot frame, where 0 means the defender is moving directly toward the shooter on the defender-to-shooter line

`rim_shooter_defender_angle_at_shot`

Type: float | Unit: degrees

Angle between the rim, shooter, and defender at the shot frame

`defender_feet_from_shooter_at_shot`

Type: float | Unit: feet

Defender distance from the shooter at the shot frame

`defender_feet_from_rim_at_shot`

Type: float | Unit: feet

Defender distance from the rim at the shot frame

`defender_feet_from_shooter_0p2s_before_shot`

Type: float | Unit: feet

Defender distance from the shooter shortly before the shot frame

`defender_feet_from_shooter_0p4s_before_shot`

Type: float | Unit: feet

Defender distance from the shooter before the shot frame

`defender_feet_from_shooter_0p6s_before_shot`

Type: float | Unit: feet

Defender distance from the shooter before the shot frame

`defender_feet_from_shooter_0p8s_before_shot`

Type: float | Unit: feet

Defender distance from the shooter before the shot frame

`defender_feet_from_shooter_1p0s_before_shot`

Type: float | Unit: feet

Defender distance from the shooter before the shot frame

`defender_feet_from_shot_location_0p2s_after_shot`

Type: float | Unit: feet

Defender distance from the shot location shortly after the shot frame

`defender_feet_from_shot_location_0p4s_after_shot`

Type: float | Unit: feet

Defender distance from the shot location after the shot frame

`defender_feet_from_shot_location_0p6s_after_shot`

Type: float | Unit: feet

Defender distance from the shot location after the shot frame

Shots Location Velocity Defender ​

Overview ​

Sample Response ​

Fields ​

Identifiers ​

game_id_nba ​

shot_id_ctg ​

pbp_event_id ​

chance_id_ctg ​

shooter_id_nba ​

defender_id_nba ​

Timing ​

period ​

shot_start_he_frame ​

Location And Movement ​

defender_location_at_shot_x ​

defender_location_at_shot_y ​

defender_location_at_shot_end_x ​

defender_location_at_shot_end_y ​

defender_region_at_shot_end ​

defender_location_at_first_touch_x ​

defender_location_at_first_touch_y ​

defender_region_at_first_touch ​

defender_location_at_rebound_x ​

defender_location_at_rebound_y ​

defender_region_at_rebound ​

defender_velocity_before_shot ​

defender_velocity_after_shot ​

defender_acceleration ​

defender_rim_movement_angle_before_shot ​

defender_velocity_angle_to_shooter ​

rim_shooter_defender_angle_at_shot ​

defender_feet_from_shooter_at_shot ​

defender_feet_from_rim_at_shot ​

defender_feet_from_shooter_0p2s_before_shot ​

defender_feet_from_shooter_0p4s_before_shot ​

defender_feet_from_shooter_0p6s_before_shot ​

defender_feet_from_shooter_0p8s_before_shot ​

defender_feet_from_shooter_1p0s_before_shot ​

defender_feet_from_shot_location_0p2s_after_shot ​

defender_feet_from_shot_location_0p4s_after_shot ​

defender_feet_from_shot_location_0p6s_after_shot ​

Shots Location Velocity Defender

Overview

Sample Response

Fields

Identifiers

`game_id_nba`

`shot_id_ctg`

`pbp_event_id`

`chance_id_ctg`

`shooter_id_nba`

`defender_id_nba`

Timing

`period`

`shot_start_he_frame`

Location And Movement

`defender_location_at_shot_x`

`defender_location_at_shot_y`

`defender_location_at_shot_end_x`

`defender_location_at_shot_end_y`

`defender_region_at_shot_end`

`defender_location_at_first_touch_x`

`defender_location_at_first_touch_y`

`defender_region_at_first_touch`

`defender_location_at_rebound_x`

`defender_location_at_rebound_y`

`defender_region_at_rebound`

`defender_velocity_before_shot`

`defender_velocity_after_shot`

`defender_acceleration`

`defender_rim_movement_angle_before_shot`

`defender_velocity_angle_to_shooter`

`rim_shooter_defender_angle_at_shot`

`defender_feet_from_shooter_at_shot`

`defender_feet_from_rim_at_shot`

`defender_feet_from_shooter_0p2s_before_shot`

`defender_feet_from_shooter_0p4s_before_shot`

`defender_feet_from_shooter_0p6s_before_shot`

`defender_feet_from_shooter_0p8s_before_shot`

`defender_feet_from_shooter_1p0s_before_shot`

`defender_feet_from_shot_location_0p2s_after_shot`

`defender_feet_from_shot_location_0p4s_after_shot`

`defender_feet_from_shot_location_0p6s_after_shot`