Drive

A carry of at least 3 m: the player moved the ball somewhere under control. Derived from the carry with the same span, player and position, so every drive is also a carry. Carries without a measured length are never drives. Available on analyses from engine version 0.5.45.

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]. Not currently populated.
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).
direction_deg	int16	Heading of the carry start → end, degrees in [-180, 180], in the raw pitch frame (0 points toward increasing x). Not attack-relative; rotate with the game's left_start_team to make it so. Null when start/end xy are unavailable.
length_cm	int32	Euclidean distance start → target, in cm (span events).
min_opp_dist_m	float32	Closest the carrier came to any opponent over the carry span, in metres. Low values indicate the carrier engaged a defender (a take-on). Null when the carrier's identity is unresolved or no opponent was observed on-pitch during the span.
path_length_cm	int32	Distance travelled along the carry path, in cm (sum of the actor's frame-to-frame movement over the span). At least length_cm when tracking is dense (a weaving carry exceeds its straight-line distance); can fall below it where the track has gaps, since it sums only observed movement. Null when the actor has no resolved identity or no tracked path over the span.
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).
progressive	bool	True when the drive moved the ball at least 10 m toward the opponent goal, 5 m when it started in the attacking third, or ended in the opponent box; drives under 5 m never qualify. Null when the attacking direction or the half-time boundary is unknown.
take_on	bool	True when min_opp_dist_m is 1.5 m or less: a take-on attempt, never a verdict on whether the defender was beaten. Null when min_opp_dist_m is null.

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

Request body for Query Intervals.

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

properties constrains the metadata fields listed above, players and teams restrict the actor. See Event Property Filter.

Response

Shape of this event type in the Events endpoint response.

{
  "event_id": "06a0765b-0007-7007-8000-000000000007",
  "start": 617.92,
  "end": 618.72,
  "label": "drive",
  "event_type": "drive",
  "team_id": "team_0",
  "timeline_confidence": null
}

A span: end is at or after start. team_id is the actor's team. Null when the team is unknown.