v1.48 Update - 18th December 2024
New - Centre Bounce Zone
This update introduces the Centre Bounce zone ('CB') to the AFL API. All match transactions that occur as part of a centre bounce have been re-zoned into the Centre Bounce zone. This allows clearer analysis of centre bounces, helping to identify activity that genuinely was part of the centre bounce, as opposed to afterwards in the midfield.
The CB zone affects the AFL API in two places: the match transactions endpoint, and the match statistics endpoints.
Match Transactions
The following transactions' zoneLogical value is now set to 'CB'. This has been applied to all existing AFL Premiership and AFLW matches.
| Code | Name |
|---|---|
| CEBO | Centre Bounce |
| CETU | Centre Bounce Throw Up |
| CBVS | Centre Bounce Ruck Contest |
| CBHO | Centre Bounce Hitout |
| CBHAD | Centre Bounce Hitout to Advantage |
| CBHSK | Centre Bounce Hitout Shark |
| CBHSD | Centre Bounce Hitout Sharked |
| CBSM | Centre Bounce Hitout Smash |
| CBFP | Centre Bounce First Possession |
| CBCL | Centre Bounce Clearance |
Match Statistics
Both the GET and POST endpoints now provide a 'CB' zone for the zone parameters. All stats based off transactions that occurred in the CB zone are now also assigned to the CB zone. Prior to this update, these stats were only returned if zone was unfiltered or set to 'MID'.
Centre Bounce Hitouts are assigned to zoneLogical = ‘CB’. Previously the sum of the metric ‘HITOUT’ by zone was not equal to the sum of the metric if not filtered by zone.
Previously: match_id = 216085122. squad_id = 130 (St. Kilda)
Metric = HITOUT
- HITOUT if no zone filter is applied: 30
- HITOUT in F50 zone = 0
- HITOUT in AM zone = 8
- HITOUT in DM = 2
- HITOUT in D50 = 6
So the sum of HITOUT by zone is 16. Adding the CB zone shows that HITOUT in CB = 14
AFLW 2017 - 2020 Seasons (incl. Conferences)
This update adds the remaining AFLW season from 2017 - 2020. As the 2019 & 2020 seasons were divided into two Conferences (A and B), this update also includes some API changes to accommodate conferences, as follows:
- A new season conferences endpoint that returns which squads are in each conference
- The season ladder endpoint now provides a conference parameter, which when supplied a value instructs the endpoint to only return that conference's ladder
- This endpoint also now reports each squad's conference ladder position in addition to the whole league ladder position
Metrics
Kick In Launch Locations
This update adds three new Kick In metrics that return the number of kick ins recoreded on the left/right/centre of the field. These metrics are available at both Squad and Player levels.
| Metric | Details | Availability |
|---|---|---|
| KICK_IN_LAUNCH_LEFT Kick In Launch Left | Kick Ins where the first location recorded is on the left side of the field relative to the defensive goals | AFL Premiership; AFLW |
| KICK_IN_LAUNCH_RIGHT Kick In Launch Right | Kick Ins where the first location recorded is on the right side of the field relative to the defensive goals | AFL Premiership; AFLW |
| KICK_IN_LAUNCH_CENTRE Kick In Launch Centre | Kick Ins where the first location recorded is in the centre portion of the field | AFL Premiership; AFLW |
Inside 50 Target Chance Percentages
This update adds 10 new Inside 50 metrics that return the percentage of Inside 50 targets that performed a follow-on action. These metrics are available at both Squad and Player levels.
| Metric | Details | Availability |
|---|---|---|
| INSIDE_50_TARGET_CHANCE_PCT Inside 50 Target Chance Percentage | The percentage of all inside 50 targets where a player had a chance of winning possession of the ball | AFL Premiership; AFLW |
| INSIDE_50_TARGET_CHANCE_PLAYER_BEHI_PCT Inside 50 Target Player Behind Percentage | The percentage of all inside 50 targets that resulted in the target player converting the entry into a behind | AFL Premiership; AFLW |
| INSIDE_50_TARGET_CHANCE_PLAYER_GOAL_PCT Inside 50 Target Player Goal Percentage | The percentage of all inside 50 targets that resulted in the target player converting the entry into a goal | AFL Premiership; AFLW |
| INSIDE_50_TARGET_CHANCE_PLAYER_RETAIN_MARK_PCT Inside 50 Target Player Mark Retention Percentage | The percentage of all inside 50 targets that resulted directly in a mark to the targeted player | AFL Premiership; AFLW |
| INSIDE_50_TARGET_CHANCE_PLAYER_RETAIN_PCT Inside 50 Target Player Retention Percentage | The percentage of all inside 50 targets that resulted directly in a possession to the targeted player | AFL Premiership; AFLW |
| INSIDE_50_TARGET_CHANCE_PLAYER_SCORE_PCT Inside 50 Target Player Score Percentage | The percentage of all inside 50 targets that resulted in the target player converting the entry into a score | AFL Premiership; AFLW |
| INSIDE_50_TARGET_CHANCE_TEAM_BEHI_PCT Inside 50 Target Team Behind Percentage | The percentage of all inside 50 targets that led to a behind to the team in possession | AFL Premiership; AFLW |
| INSIDE_50_TARGET_CHANCE_TEAM_GOAL_PCT Inside 50 Target Team Goal Percentage | The percentage of all inside 50 targets that led to a goal to the team in possession | AFL Premiership; AFLW |
| INSIDE_50_TARGET_CHANCE_TEAM_RETAIN_PCT Inside 50 Target Team Retention Rate | The percentage of all inside 50 targets that resulted directly in a teammate's possession | AFL Premiership; AFLW |
| INSIDE_50_TARGET_CHANCE_TEAM_SCORE_PCT Inside 50 Target Team Score Percentage | The percentage of all inside 50 targets that led to a score to the team in possession | AFL Premiership; AFLW |