공간 이벤트와 트래킹

공간 이벤트는 기록된 동작이 발생한 위치입니다. 연속 트래킹은 시간에 따른 선수와 공의 위치입니다. 슈팅맵, 패스 연결 횟수, 포메이션, 이동 거리 합계만으로 연속 트래킹을 제공할 수는 없습니다.

기존 API의 기본 응답은 유지됩니다. 축구 경기 /extended 요청에 include=spatial을 지정하면, 수집된 경우 shot_spatial을 추가로 제공합니다. EPL, 라리가, 분데스리가, 세리에 A, 리그 1의 Understat 개별 슈팅 정보가 대상입니다. 신체 부위, 상황, 직전 동작, 결과, xG, 원본 좌표, 검증된 좌표와 출처를 확인할 수 있습니다. 선수 ID가 확인되지 않으면 이름만으로 추정하지 않고 null을 유지합니다.

Understat 좌표는 두 팀 모두 공격 방향을 기준으로 한 0~1 비율이며, 공격 골대의 X는 1입니다. 실제 경기장 방향이나 미터 단위를 추정하지 않습니다. sourceListsPresent는 원본 배열 검증 결과이며 경기 전체의 완전성을 뜻하지 않습니다. 개별 슈팅 정보는 모든 패스의 시작·끝 좌표나 공격 전개의 전체 기록이 아닙니다.

MLB는 /v1/mlb/games/{id}/pbp/extended?season=2026&include=spatial&producer=mlb_pitch_physics로 별도 투구 계수를 조회합니다. 위치는 피트, 속도는 피트/초, 가속도는 피트/초²입니다. 기준 시각은 원본 Y 약 50피트 지점이며 릴리스 시점이 아닙니다. 계산 가능한 모델을 제공할 뿐 실제 연속 관측, 비행 시간, 홈플레이트 도달점이나 수비수 이동을 제공하지 않습니다. 기존 필드의 단위와 계산은 변경하지 않습니다.

위젯 설정의 모듈에 spatial-events를 추가하면 기록된 이벤트 위치와 선택한 이벤트의 상세 정보가 활성화됩니다. 진행 중 경기는 In-game events, 종료된 경기는 Historical events로 표시합니다. 기존 설정의 기본 동작은 유지됩니다. 지원되지 않는 좌표와 누락값은 표시하지 않으며, 이벤트 위치를 실시간 공 위치로 취급하지 않습니다. 농구·야구·하키·미식축구·배구는 실제 보유한 이벤트 정보 범위에서 표시합니다.

추가 정보의 enrichmentSource, 선택형 enrichmentObservedAt, enrichmentTiming은 출처와 관측 시점을 나타냅니다. 관측 시각은 원본을 조회한 시각이며 이벤트 발생 시각이 아닙니다. 지연되었거나 시각을 확인할 수 없는 보강 정보는 별도로 표시하며, 보강 정보의 시각으로 기존 이벤트의 최신성을 높이지 않습니다. 선택형 캐시·전달 키의 접미사는 :spatial-events:v2이며 기본 위젯의 키는 유지됩니다.

KBL의 선택형 화면은 한쪽 팀의 전용 박스스코어에 측정값이 없을 때 정규 경기 문서에 이미 저장된 해당 팀 합계를 사용합니다. 팀 ID가 일치해야 하며 전용 박스스코어의 실제 0은 그대로 유지합니다. 시각은 해당 필드의 수집 출처 기록이 있을 때만 제공하고, 다른 경기 정보의 갱신 시각으로 통계를 최신처럼 표시하지 않습니다. 새 요청이나 수집 주기를 추가하지 않습니다.

MLB의 기존 라이브 게임피드 작업은 2초 주기이며, 5초 주기의 패리티 작업은 진행 중이거나 당일인 경기를 우선 처리하고 최신 보관 원본을 읽습니다. 투구 계수에는 원본 보관, BASEBALL_PARITY_ENABLED=true, MLB_PITCH_PHYSICS_ENABLED=true와 기존 리그·출처 게이트가 필요합니다. 이 주기는 설정값이며 실제 전송 지연을 보장하지 않습니다.

Understat의 종료 경기 탐색과 2시간 주기 슈팅·재처리 작업은 경기 중 슈팅 제공을 보장하지 않습니다. NFL의 nflverse PBP·컨텍스트 작업은 수동 실행이며 플래그만으로 실시간 수집이 시작되지 않습니다. WebSocket 연결 상태나 브라우저의 5초 대체 조회 주기도 원본의 최신성을 뜻하지 않습니다. 실제 지연은 원본 이벤트 시각, 조회, 정규 데이터 반영, 위젯 수신, 렌더링 시각을 각각 측정해야 하며 운영 환경의 지연은 아직 검증하지 않았습니다.

위젯 앱의 ?research=skillcorner 경로는 2025년 A리그 경기의 100프레임 연구 샘플을 재생합니다. 실제 감지된 위치와 외삽된 위치를 구분하고 출처와 라이선스를 함께 제공합니다. 실시간 트래커에 연결하지 않으며 운영 데이터나 리그 전체 커버리지에 포함하지 않습니다.

NFL의 새 /v1/nfl/games/{id}/pbp/extended?season=2025&limit=50 경로는 패스 길이·방향, 공중 이동 거리, 캐치 후 전진 거리, 러닝 방향·갭, 샷건 및 노허들 정보를 별도로 제공합니다. 기존 플레이는 변경하지 않습니다. next_cursor는 경기와 원본 리비전에 연결되며 원본이 수정되면 400 오류를 반환하므로 커서 없이 다시 조회해야 합니다. 누락값은 null이며 연속 좌표나 선수 경로를 추정하지 않습니다. 위젯은 정확한 원본 플레이 ID가 일치할 때만 이 정보를 연결합니다.

현재 시즌 전체 패스 스트림, 전 경기 선수 트래킹, NHL 골 리플레이 원본, MLB 3D 원본, NBA 추가 분석 데이터, V리그 스카우팅 파일은 접근성·정의·권한·누락값 검증이 필요한 조건부 항목입니다. 값이 없다는 이유로 0이나 false를 만들지 않습니다.