Formula 1 Statistics Feeds

Transcription

1 Formula 1 Statistics Feeds 2018 Season 1 SPORTRADAR FORMULA 1 STATISTICS FEEDS

2 Table of Contents Formula 1 Statistics Feeds... 3 Competitor Information... 4 Team Information... 5 Stage Information... 6 Results Information... 7 Probability Information... 8 Venue Information... 9 Frequently Asked Questions...10 Document Change History SPORTRADAR FORMULA 1 STATISTICS FEEDS

3 Formula 1 Statistics Feeds We package our comprehensive stats collection into the following feeds, each focused on serving specific information needs: provides detailed driver information including debut date, first points, first pole, and first victories. Seasons - displays a listing of Formula 1 seasons with respective stage IDs. returns the outrights for each driver for a given race. returns stage and result information for each competitor and team. Team Profile provides detailed team information including car details, engine type, and debut date, first points, first pole, first victories, and relevant staff information. 3 SPORTRADAR FORMULA 1 STATISTICS FEEDS

4 Competitor Information Stat Feeds Element Attribute Format Car Nickname info car_nickname String Country Code competitor country_code String Date of Birth info dateofbirth Date Debut info debut Date First Points Date info first_points Date First Pole Date info first_pole Date First Victory Date info first_victory Date Gender competitor gender String Height info height Integer Id competitor id GUID Name competitor name String Nationality competitor nationality String Official Website info url_official String Origin Country info country String Origin Country Code info country_code String Place of Birth info placeofbirth String Salary info salary Integer WCS Won info wcs_won Integer Weight info weight Integer 4 SPORTRADAR FORMULA 1 STATISTICS FEEDS

5 Team Information Stat Feeds Element Attribute Format Back Wing Color Team Profile info back_wing_color String Car Chassis Team Profile info car_chassis String Car Construction Year Team Profile info car_construction_year Integer Car Engine Name Team Profile info car_engine_name String Car Engine Size Team Profile info car_engine_size Integer Car Fuel Type Team Profile info car_fuel_type String Car Name Team Profile info car_name String Car Tyres Team Profile info car_tyres String Chief Engineer Team Profile info chief_engineer String Country Code Team Profile team country_code String Debut Team Profile info debut Date F1 License Team Profile info f1_license Integer First Points Team Profile info first_points Date First Pole Team Profile info first_pole Date First Victory Team Profile info first_victory Date Foundation Year Team Profile info foundation_year Integer Front Color Team Profile info front_color String Front Wing Color Team Profile info front_wing_color String Gender Team Profile team gender String Id Team Profile team id GUID Location Team Profile info location String Middle Back Center Color Team Profile info middle_back_center_color String Middle Back Sides Color Team Profile info middle_back_sides_color String Middle Sides Color Team Profile info middle_sides_color String Name Team Profile team name String Nationality Team Profile team nationality String Official Website Team Profile info url_official String Origin Country Team Profile info country String Origin Country Code Team Profile info country_code String President Team Profile info president String Sports Director Team Profile info sports_director String Technical Director Team Profile info technical_director String 5 SPORTRADAR FORMULA 1 STATISTICS FEEDS

6 Stage Information Stat Feeds Element Attribute Format Air Temperature Description Humidity Id Laps Laps Completed Pit Open Scheduled Scheduled End Status Substatus Track Temperature Type Weather Seasons Seasons Seasons Seasons Seasons stage air_temperature Integer stage description String stage humidity Integer stage id GUID stage laps Integer stage laps_completed Integer stage pit_open Boolean stage scheduled Date/Time stage scheduled_end Date/Time stage status String stage substatus String stage track_temperature Integer stage type String stage weather String 6 SPORTRADAR FORMULA 1 STATISTICS FEEDS

7 Results Information Stat Feeds Element Attribute Format Fastest Lap Time Grid Laps Pitstop Count Points Position Status Substatus Time result fastest_lap_time String result grid Integer result laps Integer result pitstop_count Integer result points Integer result position Integer result status String result substatus String result time String 7 SPORTRADAR FORMULA 1 STATISTICS FEEDS

8 Probability Information Stat Feeds Element Attribute Format Market Name market name GUID Market Type market type String Outcome Id outcome id Date/Time Outcome Name outcome name String Outcome Probability outcome probability String 8 SPORTRADAR FORMULA 1 STATISTICS FEEDS

9 Venue Information Stat Feeds Element Attribute Format City Coordinates Country Country Code Curves Left Curves Right Debut Laps Length Name Official Website venue city String venue coordinates String venue country String venue country_code String venue curves_left Integer venue curves_right Integer venue debut Integer venue laps Integer venue length Integer venue name String venue official String 9 SPORTRADAR FORMULA 1 STATISTICS FEEDS

10 Frequently Asked Questions Q: How does the stage system work? A: The F1 API uses generic stage implementation. The core of the API is built around the concept of stages. For example, an event contains the following stage types: practice, qualifying, and race. Each of those stages, in turn, have stages (except Practice which has no sub-stages). The IDs of each stage are usable in the URL path to request information about that particular stage. Qualifying stages contain sub-stages known as "Qualifying Parts". In the Race stages, the sub-stages are laps. You can use the lap stage ID in the URL to get specific lap details, including driver times, and position. The F1 sport and seasons within it are stages as well. The sport stage consists of season stages for each annual season. Using the ID of a chosen season as a parameter in the endpoint you can "drill down" into each season. For example, using the 2018 season ID as a parameter in the endpoint, the sub-stages will be individual race events. From the race event, you can drill down into the practice, qualifying, race, and lap stages of a race using the same endpoint with different stage IDs. The best way to 'start' the navigation with the F1 API is using the Seasons endpoint. From there one can obtain the stage ID for the season required and use that as a parameter in the endpoint. Stage Type Sport Season Event Practice Qualifying Qualifying Part Race Lap Information Included Information about the seasons included. Which is limited to the current and previous season only. Note probabilities do not return valid data on this stage. Contains the season schedule, driver and team standings and statistics. Information about a single event, the competitors, the teams, and the circuit. Competitors and results of practice such as fastest time etc. Information pertaining to the qualifying stage of the event including conditions, competitors, and overall qualifying results. Information about the individual qualifying parts of the overall qualifying stage such as conditions, competitors, and results. Details of the race itself including the competitors, lap by lap, and overall results. Specific details on individual laps such as driver positions, times, etc. Note probabilities do not return valid data on this stage. Sub-stages Formula 1 seasons: 2017, Events on the F1 calendar for that season (eg: Melbourne Grand Prix, Abu Dhabi Grand Prix, etc.). Sessions (eg: Practice, Qualifying, Race) None Qualifying Parts None Laps None. 10 SPORTRADAR FORMULA 1 STATISTICS FEEDS

11 Q: What are the stage types I can expect to see in the feeds? A: Here are the Formula 1 stage: sport season event practice qualifying qualifying_part race lap Q: How do I see the Championship points table? A: Use the stage summary endpoint and a season stage ID as the parameter. The competitors node lists competitors, ranked with points, position, victories, races, races with points, and podiums. Q: How do I know what 'stage' I am currently looking at? A: Each stage has a 'stage' element. The stage element has an attribute 'type' displays stage type. The different valid stage types are listed above. Q: How do I get the probabilities for the entire Championship? Or only one race? A: You can use season, event, and race stage IDs as parameters for the probabilities endpoint. Probabilities are available for the individual driver to win the season, a single event, and race stage. Probabilities are not available on the Sport, Practice, Qualifying, or Lap stages. Q: How do I look up information about teams? A: Use the Team Profile endpoint with the required driver's competitor ID. The best place to get the driver's ID is the endpoint, using the season stage ID as the parameter. Most stages will include driver and team IDs. Q: How do I retrieve information about an individual driver? A: Use the endpoint with the required driver's competitor ID. The best place to get the driver's competitor ID is the endpoint, using the season stage ID. Q: What races are covered in the F1 API? A: The entire F1 Championship. Q: Is it updated in real-time? A: No, the F1 API provides lap by lap updates? Q: Does this API include Qualifying and Practice sessions? A: Yes, qualifying stages are all covered lap by lap. Practice sessions are updated post-session. 11 SPORTRADAR FORMULA 1 STATISTICS FEEDS

12 Q: Which plan should I choose ("Premium" or "Basic")? A: Races are only covered from a lap by lap perspective. Premium provides enough calls to allow you to call the race endpoint every 10s for fresh data. The Basic plan only provides a small number of calls per session to allow for retrieving only the results. Q: What are the possible statuses of a race or stage? A: Here are the possible race and stage statuses: cancelled finished running not_started completed closed preliminary Q: What is the Date format? A: When we present date only values we present these in the ISO 8601 standard format. ex: We use these for attributes that have date and no time (such as birthdate). For more information: Q: What time zone are the date time fields presented in? A: All our Date/Time attributes are in UTC, presented in the ISO 8601 standard format. ex: T18:15:00+00:00 For more information: 12 SPORTRADAR FORMULA 1 STATISTICS FEEDS

13 Document Change History Date Section Change 03/26/2018 All Initial release for version SPORTRADAR FORMULA 1 STATISTICS FEEDS