Chapter 2 軌道運輸資料

軌道運輸係指臺鐵、高鐵、捷運與輕軌，其中捷運系統包含臺北捷運、桃園機場捷運、臺中捷運、高雄捷運，輕軌系統含括新北捷運（淡海輕軌）與高雄輕軌。後續的函式中皆須設定營運單位之參數（operator=），請參照TDX_Railway表格，營運單位名稱與其相對應之代碼臚列如表2.1。軌道運輸資料中提供站點、路線站點、路線線型、班表、票價等資料。

TDX_Railway
表 2.1: 軌道營運單位名稱代碼表
軌道運輸營運單位 代碼 軌道運輸營運單位 代碼
臺鐵 TRA 新北捷運 NTMC
高鐵 THSR 淡海輕軌 NTDLRT
臺北捷運 TRTC 安坑輕軌 NTALRT
高雄捷運 KRTC 臺中捷運 TMRT
桃園捷運 TYMC 高雄輕軌 KLRT

2.1 軌道站點資料

◎ 資料概述
回傳結果為軌道運輸場站的站點屬性資料，欄位包括站點名稱、站點代碼、站點所在城市（縣市、鄉鎮）、經緯度等。

◎ 函式參數

Rail_Station(access_token, operator, dtype="text", out=FALSE)
表 2.2: Rail_Station()函式參數設定表
參數 必選填 功能 參數設定值
access_token= 必填參數 [Access Token] 1.6.3 Access Token 取得方式
operator= 營運單位代碼 請參照TDX_Railway表格
dtype= 選填參數 回傳的資料型態 text：純文字形式，其資料型態屬data.frame [預設值]
sf：地理資料形式，其資料型態屬sf
out= 匯出資料之路徑 FALSE：不匯出資料至本機 [預設值]
若回傳的資料型態為「text」：路徑必須含有.csv或.txt
若回傳的資料型態為「sf」：路徑必須含有.shp

◎ 程式碼撰寫範例

1. 回傳高鐵站點資料（純文字）

# 介接高鐵站點資料
THSR_station=Rail_Station(access_token, "THSR")
## #---THSR Station Downloaded---#
# 查看THSR_station資料
THSR_station



2. 回傳臺北捷運站點資料（地理資料）

# 介接臺北捷運鐵站點資料
TRTC_station=Rail_Station(access_token, "TRTC", dtype="sf")
## #---TRTC Station Downloaded---#
# 查看TRTC_station資料
TRTC_station
# TRTC_station繪圖
ggplot()+
  geom_sf(data=TRTC_station)+
  theme_void()

NOTE
關於 R 語言地圖繪製方式，請參考 Spatial Analysis with R (Chia Jung, Yeh) 第三章

2.2 軌道路線站點資料

◎ 資料概述
回傳結果為軌道運輸場站「依路線」的站點屬性資料，與「軌道站點資料」不同的是，路線站點資料將依照各路線上的站序回傳站點屬性資料，惟此資料中並不包含經緯度欄位，故若需要地理相關資訊，請使用「軌道站點資料」。軌道路線站點資料回傳結果中的欄位包括路線代碼、路線名稱、站序、站點代碼與站點名稱。另請注意高鐵（THSR）並未提供此一類型之資料，而臺鐵資料中另包含路線站點累積里程數。

◎ 函式參數

Rail_StationOfLine(access_token, operator, out=FALSE)
表 2.3: Rail_StationOfLine()函式參數設定表
參數 必選填 功能 參數設定值
access_token 必填參數 [Access Token] 1.6.3 Access Token 取得方式
operator= 營運單位代碼 請參照TDX_Railway表格
out= 選填參數 匯出資料之路徑 FALSE：不匯出資料至本機 [預設值]
若欲輸出此結果，路徑中必須含有.csv或.txt

◎ 程式碼撰寫範例
回傳臺鐵路線站點資料

# 回傳臺鐵路線站點資料，並匯出資料
TRA_stationofline=Rail_StationOfLine(access_token, "TRA", out="./TRA_stationofline.csv")
## #---TRA Station of Line Downloaded---#
# 查看THSR_station資料
TRA_stationofline

2.3 軌道路線線型資料

◎ 資料概述
回傳結果為軌道路線的線型資料，其中欄位包括路線代碼、路線名稱，以及線型幾何資料（Geometry）。

◎ 函式參數

Rail_Shape(access_token, operator, dtype="text", out=FALSE)
表 2.4: Rail_Shape()函式參數設定表
參數 必選填 功能 參數設定值
access_token= 必填參數 [Access Token] 1.6.3 Access Token 取得方式
operator= 營運單位代碼 請參照TDX_Railway表格
dtype= 選填參數 回傳的資料型態 text：純文字形式，其資料型態屬data.frame [預設值]
sf：地理資料形式，其資料型態屬sf
out= 匯出資料之路徑 FALSE：不匯出資料至本機 [預設值]
若回傳的資料型態為「text」：路徑必須含有.csv或.txt
若回傳的資料型態為「sf」：路徑必須含有.shp

◎ 程式碼撰寫範例
1. 回傳臺鐵路線資料（純文字）

# 介接臺鐵站點資料
TRA_railshape=Rail_Shape(access_token, "TRA")
## #---TRA Shape Downloaded---#
# 查看THSR_station第1筆資料(成追線)
TRA_railshape[1,]
##   LineID LineName
## 1     CZ   成追線
##                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                geometry
## 1 LINESTRING (120.59025348231239 24.114387016447722, 120.58920416773822 24.114892618899319, 120.58898694818913 24.114966498205376, 120.58872768713309 24.115060697693082, 120.58825918801119 24.115224174655964, 120.58781883766926 24.11538001457609, 120.58749487758655 24.11549449827254, 120.58719276743238 24.115599387102066, 120.58696040959524 24.115680934027921, 120.58674696360151 24.115752509270919, 120.58659193397068 24.115798789282735, 120.58642305657884 24.11584348738711, 120.58625839341016 24.115884729396782, 120.58610844944542 24.115915988931818, 120.58596270261671 24.115944558594549, 120.5857993326731 24.11597154724916, 120.58563051283795 24.115995829843712, 120.58546254556006 24.116014714707376, 120.58529584992357 24.11602974687537, 120.58510775042237 24.11604088318029, 120.58484913867687 24.116048388022762, 120.58462246365582 24.116045180140986, 120.58439747576301 24.116034274961862, 120.58421700341205 24.116020375040307, 120.58398660969431 24.115995963842693, 120.5837268621051 24.11595607801064, 120.58336057543022 24.115885896716804, 120.58328965309511 24.115871734193206, 120.583053527998 24.115837554559562, 120.58300419928446 24.115830372573669, 120.58270499663831 24.115783677075115, 120.58253099940612 24.115760230850015, 120.58237154601011 24.115744138381331, 120.58215796062143 24.115733351013375, 120.58185308415261 24.115728498271608, 120.58152780566377 24.115741510562316, 120.58115867443337 24.115778088687875, 120.58082137740473 24.115829144099791, 120.58051609444226 24.115900594337006, 120.58004158694973 24.116038259857874, 120.57976522618435 24.116142446316871, 120.57944866842138 24.116282936608286, 120.57908846116356 24.116474592928171, 120.57858245131911 24.116806220630622, 120.57833936457007 24.116986558982546, 120.57793212186994 24.117297512170524, 120.57749290557319 24.117647292688446, 120.57721600791251 24.117853449677, 120.57707591422218 24.117943759596869, 120.57617910668046 24.118476420850186, 120.57582249581162 24.118638976907334, 120.57542539296753 24.118784373000437, 120.57505255293302 24.118900099559994, 120.57472636343095 24.118990065039497, 120.57380000506623 24.119314767962237, 120.57007289434864 24.120197813178606)



2. 回傳臺北捷運路線資料（地理資料）

# 介接臺北捷運鐵路線資料，並匯出資料
TRTC_railshape=Rail_Shape(access_token, "TRTC", dtype="sf", out="./TRTC_railshape.shp")
## #---TRTC Shape Downloaded---#
# 查看TRTC_railshape資料
TRTC_railshape
# TRTC_railshape繪圖
ggplot()+
  geom_sf(data=TRTC_railshape, aes(color=LineName), show.legend="line", size=1)+
  scale_color_manual(values=c("淡水信義線"="#d90023", "板南線"="#0a59ae", "松山新店線"="#107547",
                              "中和新蘆線"="#f5a818", "文湖線"="#b57a25", "環狀線"="#fedb00"), name="路線")

NOTE
R 語言「依類別變數繪製地圖」之方法，請參考 Spatial Analysis with R (Chia Jung, Yeh) 3.5 章節 Categorized Symbol Map

2.4 軌道班表資料

◎ 資料概述
班表資料包含兩種形式，一為「依班次記錄」，另一為「依站點記錄」。「依班次記錄」係指依照列車班次記錄各停靠站的抵達（Arrival）與離站（Departure）時間，而「依站點記錄」則是指依據站點記錄各個停靠該站之列車的抵達與離站時間。目前 TDX 平臺中，臺鐵（TRA）提供兩種記錄方式之資料；高鐵（THSR）僅提供 「依班次記錄」之資料 ;所有捷運與輕軌系統則僅提供「依站點記錄」之資料。另須注意的是，臺中捷運的班表尚未匯入 TDX 平臺中，故無法介接。

班表資料回傳結果中，欄位包括車次代碼、方向（順逆行）、車種、起訖站、各星期營運與否、停靠站點代碼與名稱、到離站時間等，各軌道系統所擁有的欄位將會有些許差異。

◎ 函式參數

Rail_TimeTable(access_token, operator, record, out=FALSE)
表 2.5: Rail_TimeTable()函式參數設定表
參數 必選填 功能 參數設定值
access_token= 必填參數 [Access Token] 1.6.3 Access Token 取得方式
operator= 營運單位代碼 請參照TDX_Railway表格
record= 班表記錄方式 general：依班次記錄
station：依站點記錄
out= 選填參數 匯出資料之路徑 FALSE：不匯出資料至本機 [預設值]
若欲輸出此結果，路徑中必須含有.csv或.txt

◎ 程式碼撰寫範例
1. 回傳臺鐵班次資料（依班次記錄）

# 介接臺鐵班次資料
TRA_timetable=Rail_TimeTable(access_token, "TRA", record="general")
# 查看TRA_timetable前300筆資料
TRA_timetable[1:300,]



2. 回傳高雄捷運班次資料（依站點記錄）

# 介接高雄捷運班次資料
KRTC_timetable=Rail_TimeTable(access_token, "KRTC", record="station")
# 查看KRTC_timetable前300筆資料
KRTC_timetable[1:300,]

2.5 軌道票價資料

◎ 資料概述
票價資料係指軌道系統中任兩起訖對間的票價，其中又可細分為不同車種（TrainType）、票證（TicketType）、票種（FareClass）及艙等（CabinClass）的票價，在回傳結果中以代碼表之。各細分類目的代碼與對照名稱詳如表2.6所示。

表 2.6: 票價資料欄位代碼表
類型 代碼 對照名稱 類型 代碼 對照名稱
車種（TrainType） 0 不分車種 票種（FareClass） 1 ’成人
1 普通車 2 學生
2 直達車 3 孩童
票證（TicketType） 1 一般票(單程票) 4 敬老
2 來回票 5 愛心
3 電子票證(悠遊卡/一卡通) 6 愛心孩童
4 回數票 7 愛心優待/愛心陪伴
5 定期票(30天期) 8 團體
6 定期票(60天期) 艙等（CabinClass） 1 標準座車廂
7 早鳥票 2 商務座車廂
8 團體票 3 自由座車廂

班表資料回傳結果中，依不同軌道系統的票價訂定方式，所回傳的欄位會有些許差異。另請注意，由於此函式係回傳所有起訖對的票價資料，故若軌道系統的站點數愈多（如：臺鐵、臺北捷運），回傳的時間將會愈久。

◎ 函式參數

Rail_ODFare(access_token, operator, out=FALSE)
表 2.7: Rail_TimeTable()函式參數設定表
參數 必選填 功能 參數設定值
access_token= 必填參數 [Access Token] 1.6.3 Access Token 取得方式
operator= 營運單位代碼 請參照TDX_Railway表格
out= 選填參數 匯出資料之路徑 FALSE：不匯出資料至本機 [預設值]
若欲輸出此結果，路徑中必須含有.csv或.txt

◎ 程式碼撰寫範例
回傳高雄輕軌起訖對票價資料

# 介接高雄輕軌票價資料
KLRT_odfare=Rail_ODFare(access_token, "KLRT")
# 查看KLRT_odfare資料
KLRT_odfare

2.6 軌道進出站人次資料

◎ 資料概述
軌道進出站係指軌道系統中各站點進站與出站的人次統計，目前可介接的運具包含臺鐵、高鐵、臺北捷運、桃園捷運、高雄捷運。其中臺北捷運另可介接站點間人次的統計數據，為更詳細的資料。

◎ 函式參數

Rail_Patronage(operator, ym, OD=FALSE, out=FALSE)
表 2.8: Rail_Patronage()函式參數設定表
參數 必選填 功能 參數設定值
operator= 必填參數 營運單位代碼 請參照TDX_Railway表格
ym= 年度與月份 格式為YYYY-MM
OD= 選填參數 是否介接起訖資料 目前僅臺北捷運提供起訖資料
out= 匯出資料之路徑 FALSE：不匯出資料至本機 [預設值]
若欲輸出此結果，路徑中必須含有.csv或.txt

輸出資料中gateInComingCnt為進站人次；gateOutGoingCnt則為出站人次。此外，起訖對運量資料中，gateIn為進站站點；gateOut為出站站點，並依據各天各時段（24小時）紀錄。所有運量資料並非來自 TDX，而是各運具的官方網站或公開資料平臺，各運具資料來源彙整如表2.9。

表 2.9: 軌道運量資料來源
軌道系統 資料類別 資料來源
臺鐵（TRA） 進出站 政府資料開放平臺
高鐵（THSR） 高鐵官方網站
臺北捷運（TRTC） 臺北捷運公司官方網站
起訖對 臺北市資料大平臺
高雄捷運（KRTC） 進出站 高雄捷運公司官方網站
桃園捷運（TYMC） 政府資料開放平臺

◎ 程式碼撰寫範例
回傳臺北捷運各站進出人次資料

# 介接臺北捷運各站進出人次資料
TRTC_Patro=Rail_Patronage("TRTC", "2024-12")

# 統計TRTC_Patro資料
TRTC_Patro_sum=group_by(TRTC_Patro, StationName)%>%
  summarise(gateInComingCnt=sum(gateInComingCnt, na.rm=T),
            gateOutGoingCnt=sum(gateOutGoingCnt, na.rm=T))