該儲存庫由 StatsBomb 為您提供,是一個 Python 包,允許用戶使用 API 的登入憑證或來自我們的 GitHub 頁面的免費資料輕鬆地將 StatsBomb 資料串流傳輸到 Python 中。 API 存取僅適用於付費客戶
pip install statsbombpy
nose2 -v --pretty-assert
可以透過將名為SB_USERNAME
和SB_PASSWORD
環境變數設定為您的登入憑證來完成驗證。
或者,如果您不想使用環境變量,所有函數都接受參數creds
來以{"user": "", "passwd": ""}
格式傳遞您的登入憑證
您可以透過將環境變數SB_CORES
設定為您想要使用的數字來指定執行sb.competition_events()
和sb.competition_frames()
函數時要使用的電腦核心數量。允許 statsbombpy 使用更多核心將加速這些功能。
如果您沒有設定環境變量,我們將嘗試偵測您系統中的核心數量,並使用比該數量少 2 個的核心數量。如果我們無法偵測到核心數量,我們將其設定為 4。
StatsBomb的開放資料無需身份驗證即可存取。
StatsBomb 致力於公開分享新數據和研究,以增強對足球比賽的了解。我們希望積極鼓勵各層面的新研究和分析。因此,我們免費提供某些聯賽的 StatsBomb 數據,供公眾用於研究項目和對足球分析的真正興趣。
StatsBomb 希望透過免費提供數據,我們能夠擴大更廣泛的足球分析社區,並吸引新的人才加入該行業。我們希望收集有關我們數據用戶的一些基本個人資訊。透過向我們提供您的電子郵件地址,這意味著我們會在提供更多數據、教學和研究時通知您。我們將根據我們的隱私權政策和 GDPR 儲存資訊。
雖然我們熱衷於共享數據並促進研究,但我們也敦促您對數據負責。請在 https://www.statsbomb.com/resource-centre 上註冊您的詳細資訊並仔細閱讀我們的使用者協議。使用此儲存庫即表示您同意使用者協議。如果您發佈、分享或散佈基於此資料的任何研究、分析或見解,請註明資料來源為 StatsBomb 並使用我們的商標。
from statsbombpy import sb
sb.competitions()
競賽_id | season_id | 國家/地區名稱 | 競賽名稱 | 競賽_性別 | 季節名稱 | 匹配更新 | 匹配可用 | |
---|---|---|---|---|---|---|---|---|
0 | 9 | 42 | 德國 | 1. 德甲聯賽 | 男性 | 2019/2020 | 2019-12-29T07:47:45.981 | 2019-12-29T07:47:45.981 |
1 | 9 | 4 | 德國 | 1. 德甲聯賽 | 男性 | 2018/2019 | 2019-12-16T23:09:16.168756 | 2019-12-16T23:09:16.168756 |
2 | 9 | 1 | 德國 | 1. 德甲聯賽 | 男性 | 2017/2018 | 2019-12-16T23:09:16.168756 | 2019-12-16T23:09:16.168756 |
3 | 78 | 42 | 克羅埃西亞 | 1. 漢密爾頓 | 男性 | 2019/2020 | 2020-01-02T10:35:49.065 | 2020-01-02T10:35:49.065 |
4 | 10 | 42 | 德國 | 2. 德甲聯賽 | 男性 | 2019/2020 | 2019-12-27T00:36:37.498 | 2019-12-27T00:36:37.498 |
sb.matches(competition_id=9, season_id=42)
比賽編號 | 比賽日期 | 開球 | 競賽 | 季節 | 主隊 | 客隊 | 主場得分 | 客場得分 | 比賽狀態 | 最後更新 | 比賽週 | 比賽階段 | 體育場 | 裁判 | 家庭經理 | 離開經理 | 數據版本 | 鏡頭保真度版本 | xy_保真_版本 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | 303299 | 2019-12-15 | 18:00:00.000 | 德國 - 1. 德甲聯賽 | 2019/2020 | 沙爾克04 | 法蘭克福 | 1 | 0 | 可用的 | 2019-12-17T09:50:17.558 | 15 | 例行賽 | 費爾廷斯競技場 | F·茲瓦耶 | 大衛·華格納 | 阿迪·許特 | 1.1.0 | 2 | 2 |
1 | 303223 | 2019-09-01 | 18:00:00.000 | 德國 - 1. 德甲聯賽 | 2019/2020 | 法蘭克福 | 杜塞爾多夫福圖娜飯店 | 2 | 1 | 可用的 | 2019-12-16T23:09:16.168756 | 3 | 例行賽 | 德國商業銀行競技場 | F·維倫伯格 | 阿迪·許特 | 弗里德赫爾姆·馮克爾 | 1.1.0 | 2 | 2 |
2 | 303083 | 2019-12-15 | 15:30:00.000 | 德國 - 1. 德甲聯賽 | 2019/2020 | 沃爾夫斯堡 | 門興格拉德巴赫 | 2 | 1 | 可用的 | 2019-12-17T15:52:17.843 | 15 | 例行賽 | 大眾汽車競技場 | F·布萊奇 | 奧利佛·格拉斯納 | 馬可·羅斯 | 1.1.0 | 2 | 2 |
3 | 303266 | 2019-12-14 | 15:30:00.000 | 德國 - 1. 德甲聯賽 | 2019/2020 | 柏林赫塔 | 弗賴堡 | 1 | 0 | 可用的 | 2019-12-17T17:43:18.285 | 15 | 例行賽 | 柏林奧林匹克體育場 | F·維倫伯格 | 尤爾根·克林斯曼 | 克里斯蒂安·史特賴克 | 1.1.0 | 2 | 2 |
4 | 303073 | 2019-12-21 | 15:30:00.000 | 德國 - 1. 德甲聯賽 | 2019/2020 | 拜仁慕尼黑 | 沃爾夫斯堡 | 2 | 0 | 可用的 | 2019-12-23T18:02:36.454 | 17 號 | 例行賽 | 安聯球場 | C·丁格特 | 漢斯·迪特·弗利克 | 奧利佛·格拉斯納 | 1.1.0 | 2 | 2 |
sb.lineups(match_id=303299)["Eintracht Frankfurt"]
玩家id | 玩家姓名 | 玩家暱稱 | 出生日期 | 玩家性別 | 玩家身高 | 玩家體重 | 球衣號碼 | 國家 | |
---|---|---|---|---|---|---|---|---|---|
0 | 3204 | 阿爾馬米·圖埃 | 沒有任何 | 1996年4月28日 | 男性 | 182.0 | 72.0 | 18 | 馬裡 |
1 | 5591 | 菲利普·科斯蒂奇 | 沒有任何 | 1992年11月1日 | 男性 | 184.0 | 82.0 | 10 | 塞爾維亞 |
2 | 7713 | 奧比特·埃文·迪卡 | 埃文恩迪卡 | 1999-08-20 | 男性 | 190.0 | 南 | 2 | 法國 |
3 | 8307 | 馬丁·辛特雷格 | 沒有任何 | 1992-09-07 | 男性 | 184.0 | 83.0 | 13 | 奧地利 |
4 | 8669 | 米賈特·加奇諾維奇 | 沒有任何 | 1995-02-08 | 男性 | 175.0 | 66.0 | 11 | 塞爾維亞 |
查詢事件的預設設定會傳回包含所有事件類型和事件屬性的單一資料幀。
events = sb.events(match_id=303299)
球收據結果 | 球恢復進攻 | ball_recovery_recovery_failure | 塊偏轉 | 進位結束位置 | 空運許可 | 間隙_身體_部分 | 間隙_頭 | 左腳間隙 | 間隙右腳 | 反壓制 | 運球無觸球 | 運球結果 | 運球超跑 | 決鬥結果 | 決鬥類型 | 期間 | 犯規優勢 | 犯規卡 | 犯規_贏得_優勢 | 犯規_贏得_防守 | 守門員身體部位 | 守門員結束位置 | 守門員_結果 | 守門員位置 | 守門員技術 | 守門員類型 | ID | 指數 | 鏈傷停賽 | 攔截結果 | 地點 | 比賽編號 | 分分鐘 | 離機 | 出去 | pass_aerial_won | 透過角度 | pass_assistance_shot_id | pass_body_part | 交叉口 | 回切 | 偏轉通道 | 通行結束位置 | 傳球助攻 | 通過高度 | 透過長度 | 透過結果 | 傳球外擺 | 通行證接收者 | 傳球助攻 | 直通 | 通行開關 | 透過技術 | 傳球 | 通行證類型 | pass_xclaim | 時期 | 播放模式 | 玩家 | 位置 | 擁有 | 控球球隊 | 相關事件 | 第二 | 空中射擊獲勝 | 射擊主體部分 | 拍攝結束位置 | 第一次射擊時間 | 鏡頭凍結幀 | shot_key_pass_id | 一對一射擊 | 射擊結果 | shot_statsbomb_xg | shot_statsbomb_xg2 | 射擊技術 | 射擊類型 | 替代結果 | 替換_替換 | 團隊 | 時間戳 | 類型 | 壓力下 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
500 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 3.498736 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 84828c06-41b5-44eb-aa92-1710bdb818ac | 1838年 | 南 | 南 | [50.1, 16.6] | 303299 | 47 | 南 | 南 | 南 | 2.720095 | 南 | 左腳 | 南 | 南 | 南 | [13.3,33.1] | 南 | 地面通行證 | 40.329765 | 南 | 南 | 弗雷德里克·倫諾 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 2 | 常規比賽 | 奧比特·埃文·迪卡 | 左中後 | 103 | 法蘭克福 | [ae3094e3-faa3-4608-8284-d9b8cca77711,c1202f1c-0831-4e88-83b2-597f56f0c858] | 52 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 法蘭克福 | 00:02:52.438 | 經過 | 真的 |
501 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 3.604236 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 9061cd20-513b-499f-b925-f1de5f241281 | 1840年 | 南 | 南 | [13.3,33.1] | 303299 | 47 | 南 | 南 | 南 | -0.153945 | 南 | 右腳 | 南 | 南 | 南 | [77.1,23.2] | 南 | 高通 | 64.563540 | 不完整 | 南 | 米賈特·加奇諾維奇 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 2 | 常規比賽 | 弗雷德里克·倫諾 | 守門員 | 103 | 法蘭克福 | [8e6495a7-782a-4f1a-845f-3ec50d761a1e,ff758a12-1ba6-4dd4-8b2c-7d39aa7aed97] | 55 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 法蘭克福 | 00:02:55.937 | 經過 | 南 |
502 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 2.101999 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 8e6495a7-782a-4f1a-845f-3ec50d761a1e | 1842年 | 南 | 南 | [43.0, 56.9] | 303299 | 47 | 南 | 南 | 南 | -0.703110 | 南 | 頭 | 南 | 南 | 南 | [64.0, 39.1] | 南 | 高通 | 27.528894 | 南 | 南 | 阿明·哈里特 | 南 | 南 | 南 | 南 | 南 | 恢復 | 南 | 2 | 常規比賽 | 奧贊·穆罕默德·卡巴克 | 右中後衛 | 104 | 沙爾克04 | [9061cd20-513b-499f-b925-f1de5f241281,be6dfe7d-7596-4cc2-8cd9-8c17d064317e] | 59 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 沙爾克04 | 00:02:59.541 | 經過 | 南 |
503 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 1.187459 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 86431bc7-210a-4868-8e18-26ff38becefc | 1854年 | 南 | 南 | [65.9, 12.6] | 303299 | 48 | 南 | 南 | 南 | -0.730239 | 南 | 右腳 | 南 | 南 | 南 | [74.5, 4.9] | 南 | 地面通行證 | 11.543396 | 南 | 南 | 阿明·哈里特 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 2 | 常規比賽 | 蘇阿特·塞爾達 | 左後衛中場 | 104 | 沙爾克04 | [761b4e65-8f64-464c-8153-6a98465208ba] | 7 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 沙爾克04 | 00:03:07.689 | 經過 | 南 |
504 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 0.766628 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 6e58c713-622c-4246-8243-e4162e487a1c | 1858年 | 南 | 南 | [79.1, 10.5] | 303299 | 48 | 南 | 南 | 南 | 1.254940 | 南 | 右腳 | 南 | 南 | 南 | [84.1, 25.8] | 南 | 地面通行證 | 16.096273 | 南 | 南 | 拉比·馬通多 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 2 | 常規比賽 | 阿明·哈里特 | 中鋒 攻擊型中場 | 104 | 沙爾克04 | [b1960a76-d3ae-4ef3-a2cd-47eca8c25e0a,dd1575c0-a408-4177-944d-7e86d2f79181] | 11 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 沙爾克04 | 00:03:11.719 | 經過 | 真的 |
還可以為每個事件類型取得不同的資料幀和/或在其自己的列上具有不同的事件屬性
sb.events(match_id=303299, split=True, flatten_attrs=False)["dribbles"]
ID | 指數 | 時期 | 時間戳 | 分分鐘 | 第二 | 類型 | 擁有 | 控球球隊 | 播放模式 | 團隊 | 玩家 | 位置 | 地點 | 期間 | 壓力下 | 相關事件 | 運球 | 比賽編號 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | b190c01f-ad24-468c-8241-f955b91d996c | 131 | 1 | 00:02:08.032 | 2 | 8 | 運球 | 4 | 沙爾克04 | 常規比賽 | 沙爾克04 | 丹尼爾·卡利朱里 | 右翼 | [110.2, 62.9] | 0.000000 | 真的 | [60f822df-5747-4787-b0f9-45bf5217eb8a] | {'結果': {'id': 8, '名稱': '完成'}} | 303299 |
1 | 4d773c92-f89f-491e-b3e0-3a1d2e863148 | 第399章 | 1 | 00:08:48.623 | 8 | 48 | 運球 | 18 | 沙爾克04 | 常規比賽 | 沙爾克04 | 阿明·哈里特 | 中鋒 攻擊型中場 | [88.9, 22.7] | 0.000000 | 真的 | [93d829df-eea7-416b-95aa-7593828cfade] | {'結果': {'id': 8, '名稱': '完成'}} | 303299 |
2 | 8a78dce4-998a-4e81-902c-9f3957cebc9d | 第460章 | 1 | 00:13:30.202 | 13 | 30 | 運球 | 23 | 沙爾克04 | 常規比賽 | 沙爾克04 | 丹尼爾·卡利朱里 | 右翼 | [99.5, 68.1] | 0.007309 | 真的 | [772c5aae-e34e-4364-8a98-7caf7636c90b] | {'結果': {'id': 9, '名': '不完整'}} | 303299 |
3 | e44d0122-2f2e-4771-820d-cc326a8b0379 | 第496章 | 1 | 00:14:10.135 | 14 | 10 | 運球 | 24 | 沙爾克04 | 從界外球 | 沙爾克04 | 蘇阿特·塞爾達 | 左後衛中場 | [41.2, 31.7] | 0.000000 | 真的 | [4de4039f-7efc-461b-b7d6-27c32ec2cd2a] | {'結果': {'id': 8, '名稱': '完成'}} | 303299 |
4 | 9555afbd-d838-42c9-8f80-be3cd09e4c4a | 第793章 | 1 | 00:20:18.409 | 20 | 18 | 運球 | 33 | 法蘭克福 | 常規比賽 | 法蘭克福 | 蒂莫西·錢德勒 | 右後衛 | [81.8, 75.7] | 0.000000 | 真的 | [a5c88cee-6319-4c25-91cd-8a028d8dbfbf] | {'結果': {'id': 9, '名': '不完整'}} | 303299 |
可以查詢給定比賽的所有事件並將其儲存在單一資料幀中
events = sb.competition_events(
country="Germany",
division= "1. Bundesliga",
season="2019/2020",
gender="male"
)
grouped_events = sb.competition_events(
country="Germany",
division= "1. Bundesliga",
season="2019/2020",
split=True
)
grouped_events["dribbles"]
ID | 指數 | 時期 | 時間戳 | 分分鐘 | 第二 | 類型 | 擁有 | 控球球隊 | 播放模式 | 團隊 | 玩家 | 位置 | 地點 | 期間 | 壓力下 | 相關事件 | 運球 | 比賽編號 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | b190c01f-ad24-468c-8241-f955b91d996c | 131 | 1 | 00:02:08.032 | 2 | 8 | 運球 | 4 | 沙爾克04 | 常規比賽 | 沙爾克04 | 丹尼爾·卡利朱里 | 右翼 | [110.2, 62.9] | 0.000000 | 真的 | [60f822df-5747-4787-b0f9-45bf5217eb8a] | {'結果': {'id': 8, '名稱': '完成'}} | 303299 |
1 | 4d773c92-f89f-491e-b3e0-3a1d2e863148 | 第399章 | 1 | 00:08:48.623 | 8 | 48 | 運球 | 18 | 沙爾克04 | 常規比賽 | 沙爾克04 | 阿明·哈里特 | 中鋒 攻擊型中場 | [88.9, 22.7] | 0.000000 | 真的 | [93d829df-eea7-416b-95aa-7593828cfade] | {'結果': {'id': 8, '名稱': '完成'}} | 303299 |
2 | 8a78dce4-998a-4e81-902c-9f3957cebc9d | 第460章 | 1 | 00:13:30.202 | 13 | 30 | 運球 | 23 | 沙爾克04 | 常規比賽 | 沙爾克04 | 丹尼爾·卡利朱里 | 右翼 | [99.5, 68.1] | 0.007309 | 真的 | [772c5aae-e34e-4364-8a98-7caf7636c90b] | {'結果': {'id': 9, '名': '不完整'}} | 303299 |
3 | e44d0122-2f2e-4771-820d-cc326a8b0379 | 第496章 | 1 | 00:14:10.135 | 14 | 10 | 運球 | 24 | 沙爾克04 | 從界外球 | 沙爾克04 | 蘇阿特·塞爾達 | 左後衛中場 | [41.2, 31.7] | 0.000000 | 真的 | [4de4039f-7efc-461b-b7d6-27c32ec2cd2a] | {'結果': {'id': 8, '名稱': '完成'}} | 303299 |
4 | 9555afbd-d838-42c9-8f80-be3cd09e4c4a | 第793章 | 1 | 00:20:18.409 | 20 | 18 | 運球 | 33 | 法蘭克福 | 常規比賽 | 法蘭克福 | 蒂莫西·錢德勒 | 右後衛 | [81.8, 75.7] | 0.000000 | 真的 | [a5c88cee-6319-4c25-91cd-8a028d8dbfbf] | {'結果': {'id': 9, '名': '不完整'}} | 303299 |
如果您有權存取比賽的 360 度數據,則可以在events()
和competition_events()
函數中設定include_360_metrics=True
來擷取 360 度指標,例如斷線通過以及事件資料。
公開數據不包含360度指標。目前,此功能僅適用於訂閱資料的客戶。
events = sb.events(match_id=3837323, include_360_metrics=True)
comp_events = sb.competition_events(
country="Europe",
division="Champions League",
season="2022/2023",
include_360_metrics=True,
)
comp_events
50_50 | 不良行為卡 | ball_receipt_exceeds_distance | 空間中的球收據 | 球收據結果 | 球恢復進攻 | ball_recovery_recovery_failure | 塊偏轉 | 封鎖進攻 | 塊保存塊 | 進位結束位置 | 空運許可 | 間隙_身體_部分 | 間隙_頭 | 左腳間隙 | 許可_其他 | 間隙右腳 | 反壓制 | 到最近防守者的距離 | 運球無觸球 | 運球肉荳蔻 | 運球結果 | 運球超跑 | 決鬥結果 | 決鬥類型 | 期間 | 犯規優勢 | 犯規卡 | 犯規進攻 | 犯規處罰 | 犯規類型 | 犯規_贏得_優勢 | 犯規_贏得_防守 | 犯規贏得罰球 | 守門員身體部位 | 守門員結束位置 | 守門員在比賽中丟失 | 守門員_lost_out | 守門員_結果 | 守門員位置 | 守門員_punched_out | goalkeeper_shot_saved_off_target | 守門員射門保存到後點 | 守門員在比賽中成功 | 守門員技術 | 守門員類型 | half_start_late_video_start | ID | 指數 | 鏈傷停賽 | 攔截結果 | 斷線通過 | 地點 | 分分鐘 | 錯誤控制_空中_贏得 | num_defenders_on_goal_side_of_actor | obv_反對_之後 | obv_反對_之前 | obv_對抗_net | obv_for_after | obv_for_之前 | obv_for_net | obv_total_net | 離機 | 出去 | pass_aerial_won | 透過角度 | pass_assistance_shot_id | pass_body_part | 交叉口 | 回切 | 偏轉通道 | 通行結束位置 | 傳球助攻 | 通過高度 | pass_inwinging | 透過長度 | 透過錯誤溝通 | 不透過觸摸 | 透過結果 | 傳球外擺 | 通行證接收者 | 傳球助攻 | 直通 | 通行開關 | 透過技術 | 傳球 | 通行證類型 | pass_xclaim | 時期 | 播放模式 | 玩家 | 玩家id | 玩家永久關閉 | 位置 | 擁有 | 控球球隊 | 控球球隊 ID | 相關事件 | 第二 | 空中射擊獲勝 | 射擊主體部分 | 射擊偏轉 | 拍攝結束位置 | 第一次射擊時間 | 鏡頭凍結幀 | shot_key_pass_id | 一對一射擊 | 射門開球 | 射擊結果 | 鏡頭重定向 | shot_saved_off_target | shot_saved_to_post | shot_statsbomb_xg | shot_statsbomb_xg2 | 射擊技術 | 射擊類型 | 替代結果 | 替換_替換 | 團隊 | 時間戳 | 類型 | 壓力下 | 可見對手 | 可見隊友 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 0.0 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 3479244f-8234-43c9-a389-4ce587062b48 | 1 | 南 | 南 | 南 | 南 | 0 | 南 | 南 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 1 | 常規比賽 | 南 | 南 | 南 | 南 | 1 | 皇家馬德里 | 220 | 南 | 0 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 皇家馬德里 | 00:00:00.000 | 先發十一人 | 南 | 南 | 南 |
1 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 0.0 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | c4f5a51b-741e-4920-ac32-02349b1f2755 | 2 | 南 | 南 | 南 | 南 | 0 | 南 | 南 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 1 | 常規比賽 | 南 | 南 | 南 | 南 | 1 | 皇家馬德里 | 220 | 南 | 0 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 凱爾特人 | 00:00:00.000 | 先發十一人 | 南 | 南 | 南 |
2 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 0.0 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 27be67e7-fdb5-4db9-92b6-8f3214cecec4 | 1 | 南 | 南 | 南 | 南 | 0 | 南 | 南 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 1 | 常規比賽 | 南 | 南 | 南 | 南 | 1 | 尤文圖斯 | 224 | 南 | 0 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 尤文圖斯 | 00:00:00.000 | 先發十一人 | 南 | 南 | 南 |
3 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 0.0 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 819c381e-29c1-4f10-a6c3-acc3181cec14 | 2 | 南 | 南 | 南 | 南 | 0 | 南 | 南 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 1 | 常規比賽 | 南 | 南 | 南 | 南 | 1 | 尤文圖斯 | 224 | 南 | 0 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 巴黎聖日耳曼 | 00:00:00.000 | 先發十一人 | 南 | 南 | 南 |
4 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 0.0 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | e6d42d87-c78a-4286-94fd-4095e9f7b16f | 1 | 南 | 南 | 南 | 南 | 0 | 南 | 南 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 沒有任何 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 1 | 常規比賽 | 南 | 南 | 南 | 南 | 1 | 曼城 | 36 | 南 | 0 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 南 | 曼城 | 00:00:00.000 | 先發十一人 | 南 | 南 | 南 |
幀函數將傳回原始 360 度凍結幀資料以及每個幀的可見區域。這是在玩家級別返回的,因此每個幀/event_id 有多行。
match_frames = sb.frames(match_id=3772072, fmt='dataframe')
comp_frames = sb.competition_frames(
country="Germany",
division= "1. Bundesliga",
season="2019/2020"
)
match_frames
演員 | 距離可見區域邊緣的距離 | 事件UUID | 守門員 | 地點 | 比賽編號 | 隊友 | 可見區域 | |
---|---|---|---|---|---|---|---|---|
0 | 錯誤的 | 5.183739 | 065b15cc-b550-48de-9a1e-a9608d8e6c6d | 錯誤的 | [79.14114105224532、12.646560364129726] | 3855869 | 錯誤的 | [50.8965834880119、80.0、55.8915648466696、6.76382112514142、80.0765213141343、1.4885995555499. 80119, 80.0] |
1 | 錯誤的 | 7.784551 | 065b15cc-b550-48de-9a1e-a9608d8e6c6d | 錯誤的 | [80.68650097437124, 23.040779651892883] | 3855869 | 真的 | [50.8965834880119、80.0、55.8915648466696、6.76382112514142、80.0765213141343、1.4885995555499. 80119, 80.0] |
2 | 錯誤的 | 8.873694 | 065b15cc-b550-48de-9a1e-a9608d8e6c6d | 錯誤的 | [80.20033992405365,24.695673759901382] | 3855869 | 錯誤的 | [50.8965834880119、80.0、55.8915648466696、6.76382112514142、80.0765213141343、1.4885995555499. 80119, 80.0] |
3 | 錯誤的 | 9.738309 | 065b15cc-b550-48de-9a1e-a9608d8e6c6d | 錯誤的 | [82.43349155444821、32.24426347120625] | 3855869 | 錯誤的 | [50.8965834880119、80.0、55.8915648466696、6.76382112514142、80.0765213141343、1.4885995555499. 80119, 80.0] |
4 | 錯誤的 | 11.049633 | 065b15cc-b550-48de-9a1e-a9608d8e6c6d | 錯誤的 | [81.320294294838、32.98015558905158] | 3855869 | 真的 | [50.8965834880119、80.0、55.8915648466696、6.76382112514142、80.0765213141343、1.4885995555499. 80119, 80.0] |
對於客戶,我們還提供球員比賽、球員賽季和球隊賽季級別的總結統計數據。
player_match = sb.player_match_stats(3772072)
player_season = sb.player_season_stats(competition_id=9, season_id=42)
team_match = sb.team_match_stats(3772072)
team_season = sb.team_season_stats(competition_id=9, season_id=42)
player_match
球員比賽壓力 | 球員比賽長球 | 玩家匹配投籃接觸比率 | player_match_passes_into_box | 玩家比賽壓力持續時間平均 | 玩家匹配交叉比率 | player_match_op_f3_forward_passes | 玩家匹配傳球比率 | 團隊 ID | 玩家匹配成功傳球數 | player_match_op_xgbuildup_per_possession | player_match_op_xgchain | player_match_op_passes_into_box | player_match_deep_progressions | 球員比賽失誤數 | player_match_counterstressed_action_fails | 玩家比賽通行證 | 玩家匹配密鑰通行證 | 球員比賽剝奪 | 球員比賽罰球獲勝 | 球員比賽通過球 | 團隊名稱 | 玩家匹配操作通行證 | 球員比賽運球次數 | 玩家比賽間隙 | 球員比賽前傳傳球數 | player_match_np_xg_per_shot | 玩家比賽反壓力 | 玩家id | 玩家匹配op_xa | player_match_op_xgchain_per_possession | 球員比賽分鐘數 | 球員比賽壓力長球 | player_match_op_f3_sideways_passes | 球員比賽運球面 | 玩家匹配np_xg | 球員比賽目標 | player_match_op_key_passes | 玩家匹配空中比例 | 玩家比賽操作鏡頭 | 玩家匹配成功交叉 | player_match_shots_blocked | player_match_op_f3_passes | 球員比賽助攻 | 球員匹配長球比率 | 帳戶 ID | 玩家匹配np鏡頭 | 玩家匹配挑戰比例 | 球員比賽接觸次數 | 球員比賽壓力恢復 | 玩家匹配交叉進入盒子 | 球員比賽犯規 | player_match_sideways_passes | 玩家比賽天線 | player_match_touches_inside_box | Player_match_counterPressure_duration_total 玩家配對反壓力持續時間總計 | player_match_successful_aerials | 玩家匹配框交叉比率 | player_match_xgbuildup_per_possession | 球員比賽運球過去 | 玩家比賽壓力持續時間總計 | player_match_op_xgbuildup | player_match_np_shots_on_target | 玩家比賽攔截 | player_match_counterstress_duration_avg | player_match_xgchain_per_possession | player_match_successful_long_balls | player_match_op_f3_backward_passes | 玩家匹配xgchain | 球員比賽鏟球 | 球員比賽助攻 | 玩家匹配sp_xa | player_match_aggressive_actions | 玩家姓名 | 玩家匹配xa | 比賽編號 | player_match_passes_inside_box | 球員比賽控球權 | 玩家匹配壓力行動失敗 | 球員比賽交叉 | 球員比賽犯規獲勝次數 | 玩家匹配xgbuildup | player_match_backward_passes | 球員比賽無壓力長球 | 玩家匹配np目標 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | 南 | 10 | 0.000000 | 0 | 南 | 南 | 0 | 0.842105 | 第870章 | 32 | 0.003191 | 0.105292 | 0 | 0 | 0 | 南 | 38 | 0 | 0 | 0 | 0 | 阿米尼亞·比勒費爾德 | 33 | 0 | 0 | 9 | 南 | 南 | 9194 | 0.000000 | 0.003191 | 94.21667 | 1 | 0 | 0 | 0.000000 | 0 | 0 | 南 | 0 | 0 | 0 | 0 | 0 | 0.600000 | 48 | 0 | 南 | 65 | 0 | 0 | 0 | 29 | 0 | 0 | 南 | 0 | 南 | 0.003191 | 0 | 南 | 0.105292 | 0 | 0 | 南 | 0.003191 | 6 | 0 | 0.105292 | 0 | 0 | 0.000000 | 0 | 斯特凡·奧爾特加 | 0.000000 | 3772072 | 0 | 0.491135 | 南 | 0 | 0 | 0.105292 | 0 | 9 | 0 |
1 | 8.0 | 0 | 0.033333 | 0 | 0.570626 | 0.0 | 0 | 0.812500 | 第870章 | 13 | 0.003726 | 0.160582 | 0 | 1 | 3 | 0.0 | 16 | 1 | 3 | 0 | 0 | 阿米尼亞·比勒費爾德 | 10 | 1 | 1 | 0 | 0.034737 | 1.0 | 9210 | 0.043881 | 0.007299 | 91.90000 | 1 | 4 | 0 | 0.034737 | 0 | 1 | 0.285714 | 1 | 0 | 0 | 6 | 0 | 南 | 48 | 1 | 1.0 | 30 | 0 | 0 | 0 | 10 | 7 | 5 | 0.327541 | 2 | 南 | 0.003726 | 0 | 4.565010 | 0.081964 | 0 | 0 | 0.327541 | 0.007299 | 0 | 2 | 0.160582 | 1 | 0 | 0.000000 | 9 | 法比安·克洛斯 | 0.043881 | 3772072 | 1 | 0.491135 | 0.0 | 1 | 1 | 0.081964 | 6 | 0 | 0 |
2 | 7.0 | 13 | 0.000000 | 1 | 1.795411 | 0.0 | 1 | 0.852941 | 190 | 58 | 0.017993 | 0.773687 | 0 | 3 | 0 | 0.0 | 68 | 1 | 0 | 0 | 0 | 柏林聯盟 | 60 | 0 | 2 | 4 | 南 | 0.0 | 9164 | 0.000000 | 0.017993 | 94.21667 | 2 | 3 | 0 | 0.000000 | 0 | 0 | 0.666667 | 0 | 0 | 1 | 4 | 0 | 0.615385 | 48 | 0 | 1.0 | 122 | 1 | 0 | 2 | 51 | 3 | 0 | 南 | 2 | 0.0 | 0.017993 | 0 | 12.567875 | 0.773687 | 0 | 1 | 南 | 0.019504 | 8 | 0 | 0.838693 | 2 | 0 | 0.043227 | 11 | 克里斯多福·特里梅爾 | 0.043227 | 3772072 | 0 | 0.508865 | 0.0 | 1 | 0 | 0.773687 | 13 | 13 | 0 |
3 | 3.0 | 4 | 0.013699 | 1 | 0.744943 | 南 | 1 | 0.777778 | 第870章 | 35 | 0.002196 | 0.090022 | 1 | 1 | 1 | 0.0 | 45 | 0 | 1 | 0 | 0 | 阿米尼亞·比勒費爾德 | 40 | 0 | 1 | 18 | 0.019468 | 0.0 | 24343 | 0.000000 | 0.002196 | 94.21667 | 1 | 1 | 0 | 0.019468 | 0 | 0 | 0.000000 | 1 | 0 | 1 | 2 | 0 | 0.750000 | 48 | 1 | 南 | 73 | 0 | 0 | 0 | 22 號 | 1 | 1 | 南 | 0 | 0.0 | 0.003043 | 0 | 2.234830 | 0.090022 | 0 | 0 | 南 | 0.003043 | 3 | 0 | 0.124760 | 0 | 0 | 0.000000 | 3 | 雅各勞爾森 | 0.000000 | 3772072 | 0 | 0.491135 | 0.0 | 0 | 1 | 0.124760 | 5 | 4 | 0 |
4 | 14.0 | 6 | 0.000 |