今天繼續介紹 Filters，昨天已經介紹 player_type 等已經可以幫我們的 function 拆成 statcast_pitcher、statcast_batter 等。今天介紹的可以再更把範圍變小。

更多 Filters

hfMo -> month

月份篩選，他也可以複選，一樣會用 | 來分隔，會用數字代替月份，不過他只有提供 3 - 10 月的篩選，然後 3, 4 月是算在一起，9, 10 月會算在一起，所有可以用的值為：

• Mar/Apr：三、四月（4）
• May：五月（5）
• Jun：六月（6）
• Jul：七月（7）
• Aug：八月（8）
• Sep/Oct：九、十月（9）

括弧裡面會是輸入的值，因為會有三、四月是 4 跟九、十月是 9 的問題，之後會用別的值代替。

game_date_gt -> start_date & game_date_lt -> end_date

日期的篩選，可以選擇日期範圍內的資料，會搜尋 start_date 開始，到 end_date 截止的範圍，日期格式為 YYYY-MM-DD，如果傳入的是別的格式像是 YYYY/MM/DD 就不會執行搜尋，但我們之後也可以自己寫檢查。另外就是範圍要注意給入的值要 start_date 小於 end_date，不然不會有搜尋結果。

hfSit -> situations

一些特殊狀況的篩選，總共有五個情況，是跟比分相關的，因為 Statcast Search，沒有直接篩選分差的選項，所以特別提到這個欄位。他也可以複選，也是用 | 分隔，五個選項分別為：

• Go-ahead run at plate：超前分在打擊區
• Go-ahead run on base：超前分在壘上
• Tying run at plate：追平分在打擊區
• Tying run on base：追平分在壘上
• Tying run on deck：追平分是下一棒

輸入給 API 的值像是第一項會變成 Go\.\.Ahead\.run\.at\.plate，變成用 \. 分開，所以之後更易懂的字串當代替，像是 goahead_p, goahead_b, tying_p, tying_b, tying_d 等。

hfTeam -> team & hfOpponent -> opponent

隊伍的篩選，可以複選，需搭配昨天介紹的 player_type，可以複選，但我自己不太建議多選，輸入的值會跟 opponent 一樣，所以就拉過來一起講。值會用隊伍代號，像是道奇隊就是 LAD，想知道 Team Id 可以去這裡對 present。另外他也提供一次選美聯（AmericanL）跟國聯（NationalL）的選項，可以一次篩選多個球隊。

hfFlag -> flag

判斷一些狀況標籤，像是是否對上菜鳥球員，是不是 Sword 等，輸入的值跟前面提到的 situations 一樣，會需要用到 \. 斷詞，由於項目非常多，所以不一一列出來，之後會直接提供一個寫好的 mapping 檔案給大家瞧瞧。

本日小結

今天介紹的篩選差不多到這邊，下一篇開始會開始寫 function 了。雖然還有很多篩選沒說明，但我覺得目前介紹的這邊已經很夠我們的 function 使用，而且很多在我們獲得資料後，也可以自己另外用 Python 的 filter 篩選，可以去 Savant 提供他們的 CSV 欄位介紹看會有哪些欄位會在獲得的資料裡給我們使用。

• Statcast Search CSV Documentation

最後一樣感謝大家耐心地看完今天的文章，有任何問題與建議歡迎直接留言找我，明天見，掰掰。