Ball Drops and Penalty Strokes
A penalty stroke is an additional stroke (or strokes) added to a player's score for an infraction of the rules (e.g. hitting the ball out of bounds). A penalty can either be followed by a drop, or hit without the player taking a drop, depending on whether or not the ball is playable.
A drop is the act of a player dropping a ball back on the course, after the previous shot lands in a place that is unplayable. A drop can either follow an infraction of the rules. and is therefore preceded by a penalty stroke, or following a situation in which the player's ball is deemed unplayable, but with no previous infraction of the rules (i.e. behind a man made object).
Ball Drop Object
seqNum
integer
The sequence number of the packet.
groupNo
integer
The group number of the player who did the event
groupId
integer
[Optional] The group ID of the player who did the event
teamNo
integer
The team ID of the player who did the event
playerId
integer
The player ID of the player who did the event
holeNo
integer
The hole in which the event took place
holeOrder
integer
The hole order of the hole in which the event took place (e.g. if a player starts a round on hole 10, this will be 1) – always starts at 1 and ends on 18
courseId
integer
The ID of the course where the event took place
strokeNo
integer
The stroke associated with the event
timestamp
date
The timestamp of the event, in UTC
timestampReceived
date
The server time of the moment that this packet has been processed
eventElementType
string
The type of event, in this case BallDrop
Full list of values include:
TglHammerThrown
RefereeCalled
HoleScoreUpdate
Correction
ModeChange
Penalty
RoundStatusUpdate
BallDrop
ProvisionalBallSelected
HitBall
AddressingBall
ApproximateLie
DetailedLie
BallHoled
dropType
string
Info on the type of drop. Possible values;
DropBehind, StrokeAndDistance, DropTwoClubLength, DropOppositeSide, FreeDrop, Other
strokesAssessed
integer
Current stroke assessed starting with 0.
roundNo
integer
Current round number
ballLie
object
See object below
player
object
See object below
provisionalIndex
integer
indicates if the event is part of a provisional ball. 0 if not, 1 if first provisional ball, 2 if second provisional ball for that stroke, e.t.c…
Ball Lie Object
Field Name
Type
Description
coordinates
object
See object below
distanceToPin
decimal
How far the ball is from the pin. Data returned in meters
surfaceType
string
Text string which describes the lie of the ball, can be inconsistent across different data collection systems / Tours. We recommend using the 3 letter codes.
See Surface Types table below.
surfaceTypeCode
string
3 letter enum code which describes the lie of the ball.
See Surface Types table below.
coordinates object:
x
decimal
X co-ordinate of the ball
y
decimal
Y co-ordinate of the ball
z
decimal
Z co-ordinate of the ball
zoneProbabilities Objects:
distanceToPinYards
float
Distance to Pin of the prediction
probabilityPercent
integer
Percentage of the where the ball is
zoneCode
string
zone code
zoneType
string
zone description
Player Object
displayName
string
The full name or display name of that player
country
string
The affiliated country (typically birthplace)
isAmateur
string
Is that player an amateur or not (true/false)
gender
string
the gender of the player
lastName
string
The surname of the player
firstName
string
The forename of that player
id
Integer
The Player's unique Id
Penalty Object
score
object
See object below
seqNum
Integer
The sequence number of the packet.
groupNo
Integer
[Optional] The group ID of the player who did the event
groupId
Integer
The group number of the player who did the event
teamNo
Integer
The team ID of the player who did the event
playerId
Integer
The player ID of the player who did the event
holeNo
Integer
The hole in which the event took place
holeOrder
Integer
The hole order of the hole in which the event took place (e.g. if a player starts a round on hole 10, this will be 1) – always starts at 1 and ends on 18
courseId
Integer
The ID of the course where the event took place
strokeNo
Integer
The stroke associated with the event
timestamp
date
The timestamp of the event, in UTC
eventElementType
string
The type of event, in this case Penalty
Full list of values include:
TglHammerThrown
RefereeCalled
HoleScoreUpdate
Correction
ModeChange
Penalty
RoundStatusUpdate
BallDrop
ProvisionalBallSelected
HitBall
AddressingBall
ApproximateLie
DetailedLie
BallHoled
penaltyStrokes
Integer
The number of strokes added to the player’s score for this penalty.
This will not be used in the future.
PLEASE NOTE: This is only available on the European Tour and will be deprecated.
penaltyType
string
The type of penalty. Possible values; Strokes, Disqualification.
PLEASE NOTE: This is only available on the European Tour and will be deprecated.
penaltyReason
string
describes reason of incurring the penalty by specific team. Possible values; OutOfBounds, ProvisionalBall, WaterHazard, Grounding.
PLEASE NOTE: This is only available on the European Tour and will be deprecated.
strokesAssessed
Integer
The stroke assessed, starts with 0.
roundNo
Integer
The current round number
player
object
See object below
provisionalIndex
Integer
indicates if the event is part of a provisional ball. 0 if not, 1 if first provisional ball, 2 if second provisional ball for that stroke, e.t.c…
Score Object
currentHoleStrokes
Integer
The number of strokes that the team is on for that hole; Can be greater than ‘stroke’ above in the instance that the team has been awarded a penalty
currentHolePar
Integer
The par score for the current hole
currentRoundScore
string
The team’s current ‘To Par’ score for the current round
overallScore
string
The team’s current ‘To Par’ score for the tournament
Player Object
displayName
string
The full name or display name of that player
country
string
The affiliated country (typically birthplace)
isAmateur
string
Is that player an amateur or not (true/false)
gender
string
The gender of the player
lastName
string
The surname of the player
firstName
string
The forename of that player
id
Integer
The Player's unique Id
Drop and Penalty Scenarios
There are broadly 5 combinations of drops and penalties that can occur on the golf course:
Penalty without drop
Penalty with drop
2 stroke penalty without drop
2 stroke penalty with drop
Free drop (i.e. drop without penalty)
Below are 5 examples of holes outlines each of these combinations
zoneProbabilities sample
Doc navigation
← Penalty StrokeSuspensions →
Last updated
Was this helpful?