Golf Statistics Feeds

Transcription

1 Golf Statistics Feeds SPORTRADAR GOLF STATISTICS FEEDS

2 Table of Contents Golf Statistics Feeds... 3 Coverage... 4 Tournament Information... 6 Venue Information... 9 Course Information Player Information Match & Tee Time Information Round & Tee Time Information Scoring Per Round Match Play Scoring Per Round Stroke Play & Summary Information Match Play & Summary Information Stroke Play Frequently Asked Questions Document Change History SPORTRADAR GOLF STATISTICS FEEDS

3 Golf Statistics Feeds We package our comprehensive stats collection into the following feeds, each focused on serving specific information needs: provides all changes related to player, tournaments, schedules, and statistics Official World Golf Ranking provides Official World Golf Rankings and points for top the 200 players Player Profile detailed player information including height, weight, place of birth, date of birth, residence, and college season statistics for all golfers who have earned Fed Ex Cup points. Season statistics are validated and corrected on a weekly basis. Scorecards per Round detailed round scoring including player information, course information, player scoring per hole, and overall tournament scoring per player Tee Times per Round round information including pairings and starting positions detailed information on how the field fared on each hole of a tournament detailed tournament statistics including player statistics at tournament and perround level schedule of tournaments for the season including date, location, course layouts, and tournament purse summary information concerning the current tournament including location, course layout and tournament field - detailed tournament statistics including player statistics at tournament and per-round level, pushed as they occur - detailed round scoring including player information, player scoring per hole, and overall tournament scoring per player, pushed as they occur 3 SPORTRADAR GOLF STATISTICS FEEDS

4 Coverage We provide coverage of three different types of calendar events to ensure maximum coverage. We combine coverage levels with the correct feeds to ensure you are getting the most comprehensive data offering in the most efficient manner possible. PGA Tour calendar events - We cover all PGA Tour events in which Fex Ex Cup points are awarded, including the World Golf Championship events. In addition, we also cover the President s Cup and Ryder Cup events. Euro Tour calendar events - We cover all traditional match and stroke play events on the Euro Tour schedule that award Race to Dubai points, including Majors and World Golf Championship events. In addition, we also cover the President's Cup and Ryder Cup events. Olympic calendar events We cover the Olympic Men s Golf Competition event that appears in the schedule. The Olympic Men s Golf Competition is also available via our Olympics API. Hero World Challenge We cover the events in the Hero World Challenge. This event will not be reflected in player seasonal statistics, as the event does not award Fed Ex Cup points. This tournament is listed in our PGA Tour Schedule. 4 SPORTRADAR GOLF STATISTICS FEEDS

5 Tour & Season Information Season Id Season Year Tour Alias Tour Currency Tour Id Tour Name Player Profile Player Profile Player Profile Player Profile Player Profile Player Profile season id GUID season year Integer tour alias String tour currency String tour id GUID tour name String 5 SPORTRADAR GOLF STATISTICS FEEDS

6 Tournament Information Bracket Id Bracket Name Course Timezone Coverage End Date Event Type Fed Ex Points Id bracket id GUID bracket name String tournament course_timezone String tournament coverage String tournament end_date Date tournament event_type String Note: Please see the FAQ section for more information. tournament points Decimal tournament id GUID 6 SPORTRADAR GOLF STATISTICS FEEDS

7 Name tournament name String Purse tournament purse Decimal Purse Currency tournament currency String Scoring System tournament scoring_system String Start Date tournament start_date Date Status tournament status String Note: Please see the FAQ section for more information. Weather Conditions weather condition String Weather Temperature weather temp String Weather Wind Direction wind direction String Weather Wind Speed wind speed Integer Winners Share of Purse tournament winning_share Decimal 7 SPORTRADAR GOLF STATISTICS FEEDS

8 8 SPORTRADAR GOLF STATISTICS FEEDS

9 Venue Information City Country Id Name State Zip Code venue city String venue country String venue id GUID venue name String venue state String venue zipcode String 9 SPORTRADAR GOLF STATISTICS FEEDS

10 Course Information Note: Course information found in the reflects a course s normal layout and yardage. The feed provides the updated course layout and yardage for the specific tournament. Hole Number hole number Integer Id course id GUID Name course name String Par Score for Course course par Integer Par Score for Hole hole par Integer Total Yardage course yardage Integer Yardage for Hole hole yardage Integer 10 SPORTRADAR GOLF STATISTICS FEEDS

11 Player Information Birthday Player Profile player birthday Date Birthplace Player Profile player birth_place String College Player Profile player college String Official World Golf Ranking Country Representing Player Profile player country String Official World Golf Ranking First Name Player Profile player first_name String Height Player Profile player height Integer Id Official World Golf Ranking Player Profile player id GUID Official World Golf Ranking Last Name Player Profile player last_name String Name player name String Prior Rank Official World Golf Ranking player prior_rank Integer Rank Official World Golf Ranking player rank Integer Residence Player Profile player residence String Team Id team id Id Team Name team name String 11 SPORTRADAR GOLF STATISTICS FEEDS

12 Tied Official World Golf Ranking player tied Boolean Tournament Seed player seed Integer Weight Player Profile player weight Integer Year turned pro Player Profile player turned_pro Integer 12 SPORTRADAR GOLF STATISTICS FEEDS

13 Match & Tee Time Information Format match match_format String Note: Please see the FAQ section for more information. Id match id GUID Player Sequence participant sequence Integer Sequence match sequence Integer Starting Point match back_nine Boolean Status match status String Tee Time match tee_time DateTime Title match title String Type match type String Note: Please see the FAQ section for more information. 13 SPORTRADAR GOLF STATISTICS FEEDS

14 Round & Tee Time Information Pairing Id pairing id GUID Pairing Sequence pairing sequence Integer Pairing Starting Point pairing back_nine Boolean Pairing Tee Time pairing tee_time DateTime Note: Please see the FAQ section for more information. Playoff Round Id playoff-round id GUID Playoff Round Number playoff-round number Integer Playoff Round Status playoff-round status String Note: Please see the FAQ section for more information. Round Id Scorecards per Round round id GUID Round Number Scorecards per Round round number Integer Scorecards per Round Round Status round status String Note: Please see the FAQ section for more information. 14 SPORTRADAR GOLF STATISTICS FEEDS

15 Scoring Per Round Match Play Hole Number hole number Integer Hole Outcome hole outcome String Hole - Par Score hole par Integer Hole Sequence hole sequence Integer Hole Yardage hole yardage Integer Holes Completed player thru Integer Holes not Played player unplayed Integer Match Score hole match_score String Score player score Integer Strokes for Hole hole strokes Integer 15 SPORTRADAR GOLF STATISTICS FEEDS

16 Scoring Per Round Stroke Play Birdies player birdies Integer Bogeys player bogeys Integer Double Bogeys player double_bogeys Integer Eagles player eagles Integer Hole - Number hole number Integer Hole - Par Score hole par Integer Hole - Yardage hole yardage Integer Holes Completed player thru Integer Holes in One player holes_in_one Integer Other Scores player other_scores Integer Pars player pars Integer Score player score Integer Strokes for Hole hole strokes Integer Team Birdies team birdies Integer Team Bogeys team bogeys Integer Team Double Bogeys team double_bogeys Integer Team Eagles team eagles Integer Team Holes in One team holes_in_one Integer Team Other Scores team other_scores Integer Team Pars team pars Integer Team Score team score String Team Status team status Integer Team Strokes team strokes Integer Team Thru team thru Integer Total Strokes player strokes Integer 16 SPORTRADAR GOLF STATISTICS FEEDS

17 & Summary Information Match Play Birdies match birdies Integer Bogeys match bogeys Integer Double Bogeys match bogeys Integer Eagles match eagles Integer Holes Completed match thru Integer Holes in One match holes_in_one Integer Holes not Played match unplayed Integer Losses player losses Integer Money Earned player money Decimal Other Scores match other_scores Integer Pars match pars Integer Points Earned player points Decimal Position player position Integer Score match score Integer Team Money team money Decimal Team Points team points Decimal Team Position team position Integer Wins player wins Integer 17 SPORTRADAR GOLF STATISTICS FEEDS

18 & Summary Information Stroke Play Leaderboard Position player position Integer Note: Position does not show up until a golfer has completed his first hole of the first round. Money Won player money Integer Playoff - Position player position Integer Playoff Score player score Integer Playoff Strokes player strokes Integer Points Earned player points Decimal Round - Birdies round birdies Integer Round - Bogeys round bogeys Integer Round - Double Bogeys round double_bogeys Integer Round Eagles round eagles Integer Round - Holes Completed round thru Integer Round Holes in One round holes_in_one Integer Round - Other Scores round other_scores Integer Round Pars round pars Integer Round - Round Number round sequence Integer Round - Strokes round strokes Integer Round - Score round score Integer Tied player tied Boolean Tournament - Score player score Integer Tournament - Strokes player strokes Integer 18 SPORTRADAR GOLF STATISTICS FEEDS

19 Average Difference hole avg_diff Decimal Birdies hole birdies Integer Bogeys hole bogeys Integer Double Bogeys hole double_bogeys Integer Eagles hole eagles Integer Hole Number hole number Integer Holes in One hole holes_in_one Integer Number of Players hole players Integer Other Scores hole other_scores Integer Par Score hole par Integer Pars hole pars Integer Sequence hole sequence Integer Strokes hole strokes Integer Strokes Average hole strokes_avg Decimal 19 SPORTRADAR GOLF STATISTICS FEEDS

20 Note: We provide season statistics for all golfers who have earned Fed Ex Cup points. Season statistics are validated and corrected on a weekly basis. All Around Ranking Player Statisitcs statistics all_around_ranking Integer Average Drive Distance statistics drive_avg Decimal Average Points Official World Golf Rankings statistics avg_points Decimal Birdies Per Round statistics birdies_per_round Decimal Cuts Made statistics cuts_made Integer Cuts Missed statistics cuts Integer Drive Accuracy Percentage statistics drive_acc Decimal Earnings Rank statistics earnings_rank Integer Official World Golf Rankings statistics events_played Integer Events Played Note: The OWGR displays this data point as the rankings rolling average, whereas the displays the number based on the current season. Fed Ex Points Rank statistics points_rank Integer Official World Golf Rankings statistics points Integer Fed Ex Points / OWGR Points Note: The OWGR displays this data point as the rankings rolling average, whereas the displays the number based on the current season. First Place Finishes statistics first_place Integer Greens in Regulation statistics gir_pct Decimal Holes Per Eagle statistics holes_per_eagle Decimal Points Gained Official World Golf Rankings statistics points_gained Decimal Points Lost Official World Golf Rankings statistics points_lost Decimal Proximity to Hole Average statistics hole_proximity_avg Decimal Putting Average statistics putt_avg Decimal Sand Save Percentage statistics sand_saves_pct Decimal Scoring Average statistics scoring_avg Decimal Scrambling Percentage statistics scrambling_pct Decimal Season Earnings statistics earnings Decimal Second Place Finishes statistics second_place Integer Strokes Gained Putting statistics strokes_gained Decimal Strokes Gained Tee To Green statistics strokes_gained_tee_green Integer Strokes Gained Total statistics strokes_gained_total Integer Third Place Finishes statistics third_place Integer Top 10 Finishes statistics top_10 Integer Top 25 Finishes statistics top_25 Integer Total Driving statistics total_driving Integer Withdrawals statistics withdrawals Integer statistics world_rank Integer World Ranking Note: World Golf Rank for each season will reflect the players ranking following the completion of the Tour Championship, not the end of the year. 20 SPORTRADAR GOLF STATISTICS FEEDS

21 Metadata Information Locale Language metadata locale String Player metadata player String Round metadata round Integer Scoring System metadata scoring_system String Tour metadata tour String Tournament metadata tournament Id Tournament Type metadata tournament_type String Version metadata version Integer 21 SPORTRADAR GOLF STATISTICS FEEDS

22 Frequently Asked Questions Q: Where do I find a list of golfers participating in a particular tournament? A: The feed gives you a list of those golfers participating in the tournament. Q: What are the valid Event types? A: Here are the valid event types: stroke match cup team Q: What are the valid Match formats? A: Here are the valid match formats: singles fourball foursomes Q: What are the valid Match types? A: Here are the valid match types: regular semifinal championship consolation Q: What are the valid player statuses? A: The only player status revolves around a player s status for a particular tournament. If the player is still competing in the tournament, no status attribute will appear. Here are all remaining player statuses and their definitions: CUT The player has missed the cut of a tournament WD The player has withdrawn from a tournament MDF The player made the cut, but did not finish the tournament DQ The player has been disqualified DNS The player was scheduled to compete in the tournament, but never started Q: What are the valid tournament and round statuses and their definitions? A: Here are the valid tournament and round statuses 22 SPORTRADAR GOLF STATISTICS FEEDS

23 Round scheduled - The round is scheduled to occur. inprogress The round is in progress. delayed The round has been delayed. suspended - The round was suspended. canceled The round was canceled. complete The round is over, but stat validation is not complete. closed The round is over and the stats have been validated. reopened The round stats are in the process of being corrected. Tournament scheduled - The tournament is scheduled to occur. inprogress The tournament is in progress. delayed The tournament was delayed. canceled The tournament was canceled. complete The tournament is over, but stat validation is not complete. closed The tournament is over and the stats have been validated. playoff The tournament is in a playoff. reopened The tournament stats are in the process of being corrected. Q: What time zone are the date time fields presented in? A: All of our DateTime attributes are in UTC, presented in the ISO 8601 standard format. ex: T18:15:00+00:00 For more information: Q: Do you provide season statistics for all golfers? A: We provide season statistics for all golfers who have earned Fed Ex Cup points. Season statistics are validated and corrected on a weekly basis. World Golf Rank for each season will reflect the players ranking following the completion of the Tour Championship, not the end of the year. For more information on timing, please see our Golf Weekly Workflow document ( Q: Course information in the feed does not match the course information for a specific tournament, why is that? A: A full list of course attributes can be found in 2 feeds: and. The feed provides the generic course layout and yardage. Courses can be changed for a specific tournament. To find the official course layout and yardage for a specific tournament, you need to use the feed. Q: How do you handle the points reset associated with the Coca-Cola Championship and the Fed Ex Cup? A: The top 30 players have a points reset applied. We will reset the point total for each player involved in the Coca- Cola Championship tournament. Players ranked 31 and above will have their points reflect their correct total prior to the reset applied to those players who qualified. After the Coca-Cola Championship, the top 30 player s points will reflect the reset value plus points earned in the Coca-Cola Championship tournament. 23 SPORTRADAR GOLF STATISTICS FEEDS

24 Q: How is play-off data represented within the feeds? A: Play-off data will appear within the feed and Scorecard Per Round. In the Tournament Leaderboard feed, a play-off element will appear that includes all golfers taking part in the play-off. As with other rounds within the tournament, the play-off section will include the golfer s current score as well as a summary of their current round score. Here is an example: <playoff> <player first_name="jordan" last_name="spieth" country="united STATES" id="3e4963cb-6e cf- 2aecec453c4a" position="1" score="-1" strokes="10"> <rounds> <round score="-1" strokes="10" thru="3" eagles="0" birdies="1" pars="2" bogeys="0" double_bogeys="0" other_scores="0" holes_in_one="0" sequence="1"/> </rounds> </player> <player first_name="sean" last_name="o'hair" country="united STATES" id="e260788d-657a-4d f27a9c66ba" position="2" tied="true" score="0" strokes="11"> <rounds> <round score="0" strokes="11" thru="3" eagles="0" birdies="0" pars="3" bogeys="0" double_bogeys="0" other_scores="0" holes_in_one="0" sequence="1"/> </rounds> </player> <player first_name="patrick" last_name="reed" country="united STATES" id="12195ed9-3fcd-486a-86b4-1ec726d201cd" position="2" tied="true" score="0" strokes="11"> <rounds> <round score="0" strokes="11" thru="3" eagles="0" birdies="0" pars="3" bogeys="0" double_bogeys="0" other_scores="0" holes_in_one="0" sequence="1"/> </rounds> </player> </playoff> If a tournament plays a complete play off round to determine the winner, the golfer s round information will also be available in the Scorecard Per Round feed. You can generate the Scorecard By Round by substituting the rounds variable with playoff, like within the following example: 142ec55239a5/playoff/1/scores.xml?api_key= 24 SPORTRADAR GOLF STATISTICS FEEDS

25 Document Change History Date Section Change 05/24/2017 All Added support for the and feeds. 03/22/2017 Coverage Updated the coverage information for Euro tour. 02/24/2017 Player Info Added several data points to support the addition of the Official World Golf Ranking (OWGR) feed. Leaderboard & Summary 01/31/2017 Player Info Initial release for Added the team attribute to support team play in the Zurich Round Scoring Classic. Added additional tournament and round statuses to the FAQ. FAQ 01/31/2017 Corrected the documentation to include: Birdies Per Round, Holes Per Eagle, Putting Average, Sand Save Percentage, Strokes Gained Tee to Green, Strokes Gained Total, and Total Driving 11/08/2016 Player Information Updated documentation to remove ball_maker, club_maker, and member, as these data points are not supported. 09/23/2016 Tournament Information Updated documentation to include the scoring_system attribute for the Barracuda championship 09/16/2016 Coverage Updated coverage to include the Hero World Challenge 09/12/2016 Frequently Asked Questions Updated the definitions of when rankings will be changed 04/27/2016 Coverage Added a new section to the documentation 04/20/2016 Added a note regarding supported tours Frequently Asked Questions Added a question and answer concerning our coverage of the Euro Tour 12/15/2015 Removed duplicate round information 11/17/2015 Initial release for 2016 season 25 SPORTRADAR GOLF STATISTICS FEEDS