Drive

A player carrying the ball with their feet without releasing it. The span covers consecutive frames where the same player is the active possessor and the ball stays bound to them.

Category: Ball action

Properties

Property	Type	Description	Values
body_part	str	Which body part contacted the ball. unknown is the engine-side placeholder for unmeasured rows.	head, both_hands, unknown
confidence_detection	float32	Detection confidence [0,1].	—
confidence_event	float32	Event [0,1]. Model confidence for this event class.	—
confidence_identity	float32	Identity confidence [0,1]. Null for non-actor events and for rows where the jersey/player_id was not resolved (team-only actor rows have this null).	—
length_cm	int32	Euclidean distance start → target, in cm (span events).	—
x_target	int16	Target x-coordinate in cm (corner-origin, same convention as top-level x/y).	—
y_target	int16	Target y-coordinate in cm (corner-origin, same convention as top-level x/y).	—

Property Values

body_part

Which body part contacted the ball.

Value	Description
head	Headed contact. Includes header, flick-on, headed pass, headed clearance.
both_hands	Two-handed throw. Used for throw-in restarts (paired with set_piece=throw_in).
unknown	Engine-side placeholder for rows where body part was not measured. Distinct from a positive identification of a non-standard body part.

Querying

Using event_property filter

{
  "filters": [
    {
      "type": "event_property",
      "event_type": "drive",
      "properties": []
    }
  ]
}

Filter by property

By body_part

{
  "filters": [
    {
      "type": "event_property",
      "event_type": "drive",
      "properties": [
        { "field": "body_part", "eq": "head" }
      ]
    }
  ]
}

Filter by player

{
  "filters": [
    {
      "type": "event_property",
      "event_type": "drive",
      "properties": [],
      "players": ["0-10"]
    }
  ]
}

Filter by team

{
  "filters": [
    {
      "type": "event_property",
      "event_type": "drive",
      "properties": [],
      "teams": ["team_0"]
    }
  ]
}

Response

Events of this type appear in the Events endpoint response:

{
  "start": 125.5,
  "end": 135.5,
  "label": "drive",
  "event_type": "drive"
}