OpenF1 API 정리

Sangwon Jwa·2024년 6월 9일

Car data

session 중 특정 시점의 차량 상태를 나타내는 데이터
url : https://api.openf1.org/v1/car_data?driver_number=1&session_key=latest&speed>0

FieldDescription
brake브레이크 상태 (0 = 안밟음, 100 = 밟음)
date주행 중 시간 로그 (엄청 짧은 주기로 되어있음)
driver_number선수 번호
drs차량의 뒷날개(리어 윙)의 일부를 움직여 공기 저항을 줄이는 시스템
meeting_key회의를 식별하는 고유 식별자. 최신 또는 현재 회의를 식별하려면 latest를 사용
n_gear현재 기어 선택, 1에서 8까지 범위. 0은 중립 또는 기어가 걸리지 않은 상태
rpm엔진의 분당 회전수
session_key세션을 식별하는 고유 식별자. 최신 또는 현재 세션을 식별하려면 latest를 사용
speed차량의 속도 (km/h)
throttle사용 중인 최대 엔진 출력의 백분율


Drivers

Driver 정보
url : https://api.openf1.org/v1/drivers?driver_number=1&session_key=latest

FieldDescription
broadcast_nameTV에 표시되는 드라이버의 이름.
country_code국가를 고유하게 식별하는 코드.
driver_number선수 번호
first_name드라이버의 이름.
full_name드라이버의 전체 이름.
headshot_url드라이버 얼굴 사진의 URL.
last_name드라이버의 성.
meeting_key회의를 식별하는 고유 식별자. 최신 또는 현재 회의를 식별하려면 latest를 사용.
name_acronym드라이버 이름의 세 글자 약어.
session_key세션을 식별하는 고유 식별자. 최신 또는 현재 세션을 식별하려면 latest를 사용.
team_colour드라이버 팀의 16진수 색상 값 (RRGGBB).
team_name드라이버 팀의 이름.


Intervals

실시간으로 드라이버 간의 간격 데이터와 선두와의 시간 차이를 가져옴. 경주 중에만 사용할 수 있으며, 약 4초마다 업데이트
url : https://api.openf1.org/v1/intervals?session_key=9165&interval%3C0.005

FieldDescription
dateISO 8601 형식의 UTC 날짜와 시간.
driver_number선수 번호
gap_to_leader선두와의 시간 차이 (초 단위), 랩을 뒤처진 경우 +1 LAP, 선두의 경우 null.
interval앞차와의 시간 차이 (초 단위), 랩을 뒤처진 경우 +1 LAP, 선두의 경우 null.
meeting_key회의를 식별하는 고유 식별자. 최신 또는 현재 회의를 식별하려면 latest를 사용.
session_key세션을 식별하는 고유 식별자. 최신 또는 현재 세션을 식별하려면 latest를 사용.


Laps

개별 랩에 대한 상세 정보
url : https://api.openf1.org/v1/laps?session_key=latest&driver_number=63&lap_number=8

FieldDescription
date_startISO 8601 형식의 UTC 시작 날짜와 시간.
driver_number선수 번호
duration_sector_1첫 번째 섹터를 완료하는 데 걸린 시간 (초 단위).
duration_sector_2두 번째 섹터를 완료하는 데 걸린 시간 (초 단위).
duration_sector_3세 번째 섹터를 완료하는 데 걸린 시간 (초 단위).
i1_speed트랙의 첫 번째 중간 지점에서 차량의 속도 (km/h).
i2_speed트랙의 두 번째 중간 지점에서 차량의 속도 (km/h).
is_pit_out_lap랩이 피트에서 나오는 "아웃 랩"인지 여부를 나타내는 불리언 값 (true면 맞고, false면 아님).
lap_duration전체 랩을 완료하는 데 걸린 총 시간 (초 단위).
lap_number세션 내에서 랩의 순차적 번호 (1부터 시작).
meeting_key회의를 식별하는 고유 식별자. 최신 또는 현재 회의를 식별하려면 latest를 사용.
segments_sector_1첫 번째 섹터 내의 "미니 섹터"를 나타내는 값들의 목록 (아래 매핑 테이블 참조).
segments_sector_2두 번째 섹터 내의 "미니 섹터"를 나타내는 값들의 목록 (아래 매핑 테이블 참조).
segments_sector_3세 번째 섹터 내의 "미니 섹터"를 나타내는 값들의 목록 (아래 매핑 테이블 참조).
session_key세션을 식별하는 고유 식별자. 최신 또는 현재 세션을 식별하려면 latest를 사용.
st_speed트랙의 특정 지점에서 차량의 속도, 스피드 구간에서의 속도 (km/h).


Location

서킷에서의 차량의 대략적인 위치를 제공.
트랙을 따라 차량의 진행 상황을 측정하는 데 유용하지만, 좌우 위치에 대한 세부 정보는 포함되어 있지 않음. 즉, 차량이 트랙의 왼쪽에 있는지 오른쪽에 있는지에 대한 정보는 없습니다. 원점(0, 0, 0)은 임의의 위치를 나타내며 트랙의 특정 위치와 연결되지 않습니다

url : https://api.openf1.org/v1/location?session_key=9161&driver_number=81&date%3E2023-09-16T13:03:35.200&date%3C2023-09-16T13:03:35.800

FieldDescription
dateISO 8601 형식의 UTC 날짜와 시간.
driver_number선수 번호
meeting_key회의를 식별하는 고유 식별자. 최신 또는 현재 회의를 식별하려면 latest를 사용.
session_key세션을 식별하는 고유 식별자. 최신 또는 현재 세션을 식별하려면 latest를 사용.
x트랙에서 차량의 현재 대략적인 위치를 나타내는 3D 직교 좌표계의 'x' 값.
y트랙에서 차량의 현재 대략적인 위치를 나타내는 3D 직교 좌표계의 'y' 값.
z트랙에서 차량의 현재 대략적인 위치를 나타내는 3D 직교 좌표계의 'z' 값.


Meetings

회의에 대한 정보를 제공. 회의는 그랑프리나 테스트 주말 전체를 의미하며, 일반적으로 여러 세션(연습, 예선, 레이스 등)을 포함
url : https://api.openf1.org/v1/meetings?year=2023&country_name=Singapore

FieldDescription
circuit_key이벤트가 열리는 서킷의 고유 식별자.
circuit_short_name이벤트가 열리는 서킷의 짧은 이름 또는 일반 이름.
country_code국가를 고유하게 식별하는 코드.
country_key이벤트가 열리는 국가의 고유 식별자.
country_name이벤트가 열리는 국가의 전체 이름.
date_startISO 8601 형식의 UTC 시작 날짜와 시간.
gmt_offset이벤트가 열리는 위치의 현지 시간과 그리니치 평균시(GMT) 간의 시차(시간과 분).
location이벤트가 열리는 도시 또는 지리적 위치.
meeting_key회의를 식별하는 고유 식별자. 최신 또는 현재 회의를 식별하려면 latest를 사용.
meeting_name회의 이름.
meeting_official_name회의의 공식 이름.
year이벤트가 열리는 연도.


Pit

피트 레인을 통과하는 차량에 대한 정보, 피트 레인이란 경주 트랙과 평행하게 위치한 도로로, 드라이버가 피트 스톱을 위해 들어오고 나가는 구역을 말함

url : https://api.openf1.org/v1/pit?session_key=latest

FieldDescription
dateISO 8601 형식의 UTC 날짜와 시간.
driver_number선수 번호
lap_number세션 내에서 랩의 순차적 번호 (1부터 시작).
meeting_key회의를 식별하는 고유 식별자. 최신 또는 현재 회의를 식별하려면 latest를 사용.
pit_duration피트 레인에 들어가서 나올 때까지 걸린 시간 (초 단위).
session_key세션을 식별하는 고유 식별자. 최신 또는 현재 세션을 식별하려면 latest를 사용.


Position

세션 동안 드라이버의 위치를 제공하며, 초기 위치와 이후의 변화를 포함
url : https://api.openf1.org/v1/position?meeting_key=1217&driver_number=40

FieldDescription
dateISO 8601 형식의 UTC 날짜와 시간.
driver_number선수 번호
meeting_key회의를 식별하는 고유 식별자. 최신 또는 현재 회의를 식별하려면 latest를 사용.
position드라이버의 위치 (1부터 시작).
session_key세션을 식별하는 고유 식별자. 최신 또는 현재 세션을 식별하려면 latest를 사용.


Race control

경주가 안전하고 공정하게 진행되도록 관리하고 감독하는 정보. 선수들에게 일어난 상황들을 저장
url : https://api.openf1.org/v1/race_control?&driver_number=1&date>=2023-01-01

FieldDescription
category이벤트의 카테고리 (CarEvent, Drs, Flag, SafetyCar 등).
dateISO 8601 형식의 UTC 날짜와 시간.
driver_number선수 번호
flag표시된 깃발의 종류 (GREEN, YELLOW, DOUBLE YELLOW, CHEQUERED 등).
lap_number세션 내에서 랩의 순차적 번호 (1부터 시작).
meeting_key회의를 식별하는 고유 식별자. 최신 또는 현재 회의를 식별하려면 latest를 사용.
message이벤트 또는 행동의 설명.
scope이벤트의 범위 (Track, Driver, Sector 등).
sector이벤트가 발생한 트랙의 세그먼트 ("미니 섹터") (1부터 시작).
session_key세션을 식별하는 고유 식별자. 최신 또는 현재 세션을 식별하려면 latest를 사용.


Sessions

세션에 대한 정보를 제공. 세션은 그랑프리 또는 테스트 주말 동안의 특정 트랙 활동을 말함 (연습, 예선, 스프린트, 레이스 등).
url : https://api.openf1.org/v1/sessions?country_name=Belgium&session_name=Sprint&year=2023

FieldDescription
circuit_key이벤트가 열리는 서킷의 고유 식별자.
circuit_short_name이벤트가 열리는 서킷의 짧은 이름 또는 일반 이름.
country_code국가를 고유하게 식별하는 코드.
country_key이벤트가 열리는 국가의 고유 식별자.
country_name이벤트가 열리는 국가의 전체 이름.
date_endISO 8601 형식의 UTC 종료 날짜와 시간.
date_startISO 8601 형식의 UTC 시작 날짜와 시간.
gmt_offset이벤트가 열리는 위치의 현지 시간과 그리니치 평균시(GMT) 간의 시차(시간과 분).
location이벤트가 열리는 도시 또는 지리적 위치.
meeting_key회의를 식별하는 고유 식별자. 최신 또는 현재 회의를 식별하려면 latest를 사용.
session_key세션을 식별하는 고유 식별자. 최신 또는 현재 세션을 식별하려면 latest를 사용.
session_name세션의 이름 (Practice 1, Qualifying, Race 등).
session_type세션의 유형 (Practice, Qualifying, Race 등).
year이벤트가 열리는 연도.


Stints

개별 스틴트에 대한 정보를 제공. 스틴트는 세션 동안 드라이버가 피트 스톱 없이 연속으로 주행하는 기간을 말함
url : https://api.openf1.org/v1/stints?session_key=9165&tyre_age_at_start>=3

FieldDescription
compound스틴트 동안 사용된 타이어의 특정 컴파운드 (SOFT, MEDIUM, HARD 등).
driver_number선수 번호
lap_end이 스틴트에서 완료된 마지막 랩 번호.
lap_start이 스틴트의 초기 랩 번호 (1부터 시작).
meeting_key회의를 식별하는 고유 식별자. 최신 또는 현재 회의를 식별하려면 latest를 사용.
session_key세션을 식별하는 고유 식별자. 최신 또는 현재 세션을 식별하려면 latest를 사용.
stint_number세션 내에서 스틴트의 순차적 번호 (1부터 시작).
tyre_age_at_start스틴트 시작 시 타이어의 나이, 완료된 랩 수로 표시.


Team radio

드라이버와 그들의 팀 간의 세션 동안 이루어진 라디오 교신 모음을 제공, 제공되는 교신은 제한된 선택된 내용만 포함
url : https://api.openf1.org/v1/team_radio?session_key=latet&driver_number=11

FieldDescription
dateISO 8601 형식의 UTC 날짜와 시간.
driver_number선수 번호
meeting_key회의를 식별하는 고유 식별자. 최신 또는 현재 회의를 식별하려면 latest를 사용.
recording_url라디오 녹음의 URL.
session_key세션을 식별하는 고유 식별자. 최신 또는 현재 세션을 식별하려면 latest를 사용.


Weather

트랙 위의 날씨 정보 제공, 매 분 업데이트됨
url : https://api.openf1.org/v1/weather?meeting_key=1208&wind_direction>=130&track_temperature>=52

FieldDescription
air_temperature공기 온도 (°C).
dateISO 8601 형식의 UTC 날짜와 시간.
humidity상대 습도 (%).
meeting_key회의를 식별하는 고유 식별자. 최신 또는 현재 회의를 식별하려면 latest를 사용.
pressure대기압 (mbar).
rainfall비가 오는지 여부.
session_key세션을 식별하는 고유 식별자. 최신 또는 현재 세션을 식별하려면 latest를 사용.
track_temperature트랙 온도 (°C).
wind_direction풍향 (°), 0°에서 359°까지.
wind_speed풍속 (m/s).

0개의 댓글