Chapter 2 軌道運輸資料
軌道運輸係指臺鐵、高鐵、捷運與輕軌，其中捷運系統包含臺北捷運、桃園機場捷運、臺中捷運、高雄捷運，輕軌系統含括新北捷運（淡海輕軌）與高雄輕軌。後續的函式中皆須設定營運單位之參數（operator=），請參照TDX_Railway表格，營運單位名稱與其相對應之代碼臚列如表2.1。軌道運輸資料中提供站點、路線站點、路線線型、班表、票價等資料。
| 軌道運輸營運單位 | 代碼 | 軌道運輸營運單位 | 代碼 |
|---|---|---|---|
| 臺鐵 | TRA | 新北捷運 | NTDLRT |
| 高鐵 | THSR | 臺中捷運 | TMRT |
| 臺北捷運 | TRTC | 高雄輕軌 | KLRT |
| 高雄捷運 | KRTC | 阿里山森林鐵路 | AFR |
| 桃園捷運 | TYMC |
2.1 軌道站點資料
◎ 資料概述
回傳結果為軌道運輸場站的站點屬性資料，欄位包括站點名稱、站點代碼、站點所在城市（縣市、鄉鎮）、經緯度等。
◎ 函式參數
| 參數 | 必選填 | 功能 | 參數設定值 |
|---|---|---|---|
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 Downloaded---#
2. 回傳臺北捷運站點資料（地理資料）
## #---TRTC Station Downloaded---#
NOTE
關於 R 語言地圖繪製方式，請參考 Spatial Analysis with R (Chia Jung, Yeh) 第三章
2.2 軌道路線站點資料
◎ 資料概述
回傳結果為軌道運輸場站「依路線」的站點屬性資料，與「軌道站點資料」不同的是，路線站點資料將依照各路線上的站序回傳站點屬性資料，惟此資料中並不包含經緯度欄位，故若需要地理相關資訊，請使用「軌道站點資料」。軌道路線站點資料回傳結果中的欄位包括路線代碼、路線名稱、站序、站點代碼與站點名稱。另請注意高鐵（THSR）並未提供此一類型之資料，而臺鐵資料中另包含路線站點累積里程數。
◎ 函式參數
| 參數 | 必選填 | 功能 | 參數設定值 |
|---|---|---|---|
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---#2.3 軌道路線線型資料
◎ 資料概述
回傳結果為軌道路線的線型資料，其中欄位包括路線代碼、路線名稱，以及線型幾何資料（Geometry）。
◎ 函式參數
| 參數 | 必選填 | 功能 | 參數設定值 |
|---|---|---|---|
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 Shape Downloaded---### LineID LineName
## 2 JJ 集集線
## geometry
## 2 LINESTRING (120.61606406190697 23.814797855236861, 120.61714400828942 23.814329646595979, 120.61990263100165 23.812393051897857, 120.62084573564221 23.811663062300511, 120.62297596786664 23.810195107917934, 120.62472027402146 23.809067040611467, 120.62628428409255 23.807979736875382, 120.62751361056473 23.807138823997605, 120.62856441531562 23.806440230632177, 120.62957522811439 23.8058589097609, 120.63107952679877 23.805080715602571, 120.63139276426477 23.80491522865492, 120.63313595436091 23.80395880595421, 120.63441912234464 23.802960161882027, 120.63539977188202 23.802284045272529, 120.63684423957011 23.801185270683732, 120.63932837030814 23.799331522431885, 120.64002193826195 23.798875878219235, 120.64040178041785 23.798675501173477, 120.64083699742957 23.7985677066344, 120.64135203916533 23.798479059560975, 120.64192885263446 23.79848039865152, 120.64200309166938 23.79848655541025, 120.6420294220203 23.798488738064862, 120.64245089379381 23.798523688417561, 120.6428000636721 23.798552759002689, 120.6440098298898 23.798625444908396, 120.64700786022468 23.798802370333192, 120.64883899232575 23.798968893299843, 120.64922107379357 23.799092738039462, 120.64964806920307 23.799264911446585, 120.65137780544148 23.800181379067453, 120.65161791903176 23.800297411396457, 120.6520404097372 23.800395072374727, 120.65237585955833 23.800418041959119, 120.65277235266205 23.800402590707051, 120.6537069236357 23.800230508131506, 120.65422581177188 23.800168012443862, 120.65446899115113 23.800127561837542, 120.65482605078171 23.80014307963944, 120.65543921844528 23.800215486755349, 120.6562639929889 23.800399627440925, 120.65738549344587 23.800703342885015, 120.65813748225901 23.800842714419787, 120.65852514042297 23.800974421932096, 120.65904556010457 23.801266754657036, 120.65915946283906 23.801343848140107, 120.6595600748376 23.801777056066328, 120.6598877895899 23.802180322863649, 120.66014604160659 23.802491424439722, 120.66038486377056 23.802764285043793, 120.66068034412262 23.802947244919494, 120.66091826696447 23.80311409523938, 120.66134218579327 23.803340679428857, 120.66177298173773 23.80356406113259, 120.6622150551807 23.803908329705678, 120.66261916104554 23.8042493544242, 120.66305838543622 23.804673156341153, 120.66347988059204 23.805046000872267, 120.66450354470294 23.805982597119225, 120.66561048783376 23.80702534844113, 120.66677973509672 23.807939697259258, 120.66816397698597 23.808998604901717, 120.67097566779285 23.811158220675395, 120.67331440243777 23.81305309942104, 120.67600232314874 23.815132085577318, 120.67789640599437 23.816585410688219, 120.67813189976744 23.816759814413956, 120.67832703376564 23.816904441586757, 120.67832762192222 23.816904877757963, 120.67832768397545 23.816904925422023, 120.67855022841036 23.8170697639585, 120.68025025374629 23.818497922441225, 120.68199351758687 23.820091205444839, 120.68728078298182 23.824611428274864, 120.69021898232029 23.827232718215441, 120.69287536740433 23.829615198582587, 120.69520150794335 23.831656531923443, 120.69645860637968 23.832740084587272, 120.69688650021192 23.833015674633714, 120.6978334719372 23.833447573147055, 120.69892319844689 23.833921555435495, 120.69946181141358 23.834054006687097, 120.69994165997969 23.834067202439485, 120.70267884465306 23.834053453604042, 120.70369349755697 23.834183357975633, 120.70424969766543 23.834293224552709, 120.70475718599539 23.83444661921618, 120.70476241195581 23.834448198425662, 120.70479394488473 23.834457726742755, 120.70521965336434 23.834586372063484, 120.70621279178692 23.83483153804508, 120.70688118322005 23.83500602091118, 120.70743315831362 23.83497720573348, 120.70805682556215 23.834847763613425, 120.70857213619524 23.834666338880481, 120.70908795044863 23.83439507727104, 120.71071539869672 23.833514096898114, 120.71208062082405 23.832746164903654, 120.71239914270632 23.832579521427817, 120.71268497513154 23.832514353854378, 120.71302920503388 23.832467213191364, 120.71337331622567 23.832473825906391, 120.71407868688198 23.8326459876223, 120.7158577976993 23.833535607782096, 120.7175637792451 23.834309231585792, 120.71852399618558 23.834657410411239, 120.71997086236547 23.835161759207892, 120.72219628602988 23.835960165629217, 120.72287420757868 23.836152042282947, 120.72325781519612 23.83624067586652, 120.72406468243923 23.836457615726431, 120.72514296507586 23.836526891402968, 120.72639559657955 23.836785949212242, 120.72812194956839 23.837183207638986, 120.72925147287719 23.837322570180504, 120.73089411876867 23.837385174686119, 120.73201089418751 23.8374110113092, 120.73251748319535 23.837352164171079, 120.7331999373273 23.8370248433219, 120.73386300657251 23.836649704620243, 120.73477299188016 23.836185395439713, 120.7354490140608 23.835822217721216, 120.73599501405874 23.835536459939703, 120.73641084798226 23.835399798062269, 120.73691327672645 23.835344186684893, 120.73846282569889 23.835319673863921, 120.73987188078274 23.835292195078807, 120.74169002127758 23.835253443291833, 120.74245650626278 23.835290432407589, 120.74277908408749 23.835348678798539, 120.7434425373433 23.835566955050979, 120.74545406355423 23.836251188041956, 120.74611184658454 23.836328890366076, 120.74674550080431 23.836357022058962, 120.74708298758992 23.836322179624915, 120.74815518541357 23.835940217766904, 120.74998272112578 23.83523270942203, 120.75006639135097 23.835193391961525, 120.75033571402207 23.835066837564568, 120.75060709524132 23.834939314597761, 120.7507561506759 23.834869305074392, 120.75179590365804 23.83438057930033, 120.75225163330629 23.834157374763095, 120.75284920942352 23.833988575612352, 120.75328907323217 23.833893971429688, 120.75411071273925 23.833714419984517, 120.75468933564434 23.8336086102492, 120.7551407683319 23.833481647560063, 120.75583547123006 23.833142238923244, 120.75654316483531 23.832626858143044, 120.75709067569414 23.832196553228414, 120.75770867811309 23.831709018156687, 120.7584538761455 23.830965289616472, 120.75870633832687 23.830713033379823, 120.75898237083982 23.83059318882465, 120.75954897430574 23.83038494540898, 120.75989034526333 23.830251927584413, 120.76042568020102 23.829910082684194, 120.76081589513751 23.829583451615065, 120.76109229637245 23.829225580795992, 120.76118974690939 23.828972087092211, 120.76122370710846 23.828813667916506, 120.76134486557316 23.828372030644744, 120.76141707483816 23.827265729629744, 120.76141001695873 23.826884755227297, 120.76144188983142 23.826525601075673, 120.76156005265432 23.82606603581894, 120.7618261674437 23.825743100963393, 120.76224875977255 23.825305531325284, 120.76267284407652 23.824910050858193, 120.76340443266849 23.824404038315777, 120.76376058668177 23.824166388867809, 120.76407046338124 23.824062208703992, 120.76441161310549 23.824033835093473, 120.76481560475645 23.824047726021774, 120.76527023183576 23.82412408655739, 120.76583852063129 23.824258402103624, 120.76635065036226 23.824446193137362, 120.76667245387068 23.824543364884448, 120.76756397879467 23.824884041565326, 120.76792070837405 23.825087655271147, 120.76819937859852 23.82537476833096, 120.76876925559668 23.826205844424237, 120.76902017903808 23.826465216096892, 120.76970320244095 23.826768686026071, 120.77172093487331 23.827619824195608, 120.77225957841688 23.827763968432464, 120.77275307599371 23.827734832196825, 120.77307782568118 23.827669609764712, 120.77354561074139 23.827491114123688, 120.77408502140668 23.827193264957259, 120.77468923272193 23.826967182589442, 120.7751049065663 23.826884169768675, 120.77595200857843 23.8268073568741, 120.77709968560202 23.826678277180804, 120.77805267738927 23.826602049744849, 120.77973916343171 23.826484282623596, 120.78155393326745 23.826368935577989, 120.7834362044174 23.826266711439644, 120.78465795230272 23.826328650446897, 120.78488892968039 23.826325456954351, 120.78489788692798 23.826325332847887, 120.78496636670457 23.826324385861767, 120.78670163827007 23.826392961865736, 120.78861683270077 23.8264792194405, 120.79068786255482 23.826559690777174, 120.7921291367503 23.826621368981023, 120.79378775729924 23.826652431564526, 120.7955077313967 23.826714952433178, 120.7967705009579 23.82677666930789, 120.79824603033012 23.826854132412336, 120.79901068969161 23.826865140114194, 120.79980983355699 23.82670917968494, 120.8004984120721 23.826477133013327, 120.80222628131787 23.82593583287246, 120.80359684631742 23.825525461430971, 120.80433751356543 23.825185952070058, 120.80514965892962 23.824804719562223, 120.80564993379744 23.824572412087207, 120.80709399139459 23.823911762917589, 120.8083331861277 23.82333342509753, 120.80980796726396 23.822660323015555, 120.81081504427891 23.822147900105563, 120.81135418424822 23.821963402389144, 120.81188662426837 23.821922244016378, 120.81227862975504 23.8219644474014, 120.81279619588781 23.822025123760511, 120.81349639724101 23.822169085435007, 120.81488112926081 23.822490129016273, 120.8173989504013 23.822895903123481, 120.82051174142384 23.823406940178188, 120.82156618663032 23.823630657329034, 120.82284564041402 23.823885453251137, 120.82383961070957 23.824111703792141, 120.82536333744815 23.824320308735309, 120.82625602519545 23.824396986731585, 120.82672538496865 23.824441842217311, 120.82729374301186 23.8245470440109, 120.82789360790377 23.824652279079487, 120.82845971134668 23.824681895553113, 120.82910808566965 23.824622477345486, 120.82980734003672 23.824534307812087, 120.83011465186974 23.824461054434153, 120.83069800341025 23.824208140793132, 120.83156214307849 23.823821529440067, 120.83211156229879 23.823626273134039, 120.83287392569116 23.823388896180688, 120.83336032581849 23.823271764880076, 120.83389755023177 23.823167689937009, 120.83446365277541 23.823123872268923, 120.8359226454138 23.823005245395791, 120.83699461660831 23.822872552226556, 120.83748097356818 23.822784032856873, 120.83806335743805 23.822573129246564, 120.83835562900913 23.822483843654538, 120.83892985782677 23.822262549277298, 120.83939975719306 23.821986638172859, 120.84003837207331 23.8215120281576, 120.8406103831627 23.820957148253854, 120.84124740804145 23.820324685635796, 120.84187782560127 23.819781806285391, 120.84240407918492 23.81947175781545, 120.84276196709118 23.819332052632149, 120.84316849842753 23.819168034277425, 120.84422275567567 23.818780757426055, 120.8455107008582 23.818457783000326, 120.84636986098042 23.818280473565039, 120.84827490116584 23.81796054694172, 120.85008028657603 23.81749045961709, 120.85085288874984 23.817467317362855, 120.85114293809613 23.817485006128209, 120.85147485088373 23.817621691388013, 120.85183016942688 23.817862323887198, 120.852672515824 23.8183315199837, 120.8531702510063 23.818654892809093, 120.8531711089596 23.818655450388803, 120.85331865173441 23.818751306427714, 120.85361288472689 23.818942394376052, 120.85456133583705 23.819579824849086, 120.85517941469834 23.820050676597475, 120.85590098124533 23.820755431218231, 120.8562957215704 23.82123536701863, 120.85652907405756 23.821576035605631, 120.85663263818572 23.821862827607447, 120.85667119302116 23.822227205920854, 120.85658564231358 23.822752556585272, 120.85648833926552 23.823194633625519, 120.85651394836009 23.823523163163486, 120.85670823159967 23.823971306130943, 120.85720944805769 23.824786401271467, 120.85745317962062 23.82530739112326, 120.85792516811205 23.826145454948858, 120.85826014039321 23.826512299203273, 120.85855666575753 23.826785640944649, 120.85879077457469 23.826958251422241, 120.85909513573199 23.827159812875095, 120.85948545139252 23.827296617744764, 120.86045398616261 23.827268782828128, 120.8616725594411 23.827197904559682, 120.86200836269586 23.82728453895038, 120.86231273284636 23.827486003276476, 120.86264835533734 23.827744933382007, 120.86287170286687 23.828211643752411, 120.86300110631612 23.828641802077527, 120.86313701636027 23.829060020103896, 120.86333133737139 23.829502181680368, 120.86361655376106 23.829950395694254, 120.86409644459525 23.830506291831966, 120.86482814470321 23.831212608575072, 120.86550953313849 23.832003353671894, 120.86578490464967 23.832257076702774, 120.86593713469108 23.832397306190785, 120.86594726105727 23.832406633959067, 120.865985612646 23.8324479641023, 120.86643300827677 23.832930104141042, 120.86735607872015 23.834019266775783)
2. 回傳臺北捷運路線資料（地理資料）
# 介接臺北捷運鐵路線資料，並匯出資料
TRTC_railshape=Rail_Shape(access_token, "TRTC", dtype="sf", out="./TRTC_railshape.shp")## #---TRTC Shape Downloaded---## 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 平臺中，故無法介接。
班表資料回傳結果中，欄位包括車次代碼、方向（順逆行）、車種、起訖站、各星期營運與否、停靠站點代碼與名稱、到離站時間等，各軌道系統所擁有的欄位將會有些許差異。
◎ 函式參數
| 參數 | 必選填 | 功能 | 參數設定值 |
|---|---|---|---|
access_token=
|
必填參數 | [Access Token] | 1.6.3 Access Token 取得方式 |
operator=
|
營運單位代碼 |
請參照TDX_Railway表格
|
|
record=
|
班表記錄方式 |
general：依班次記錄
|
|
station：依站點記錄
|
|||
out=
|
選填參數 | 匯出資料之路徑 |
FALSE：不匯出資料至本機 [預設值]
|
若欲輸出此結果，路徑中必須含有.csv或.txt
|
◎ 程式碼撰寫範例
1. 回傳臺鐵班次資料（依班次記錄）
2. 回傳高雄捷運班次資料（依站點記錄）
2.5 軌道票價資料
◎ 資料概述
票價資料係指軌道系統中任兩起訖對間的票價，其中又可細分為不同車種（TrainType）、票證（TicketType）、票種（FareClass）及艙等（CabinClass）的票價，在回傳結果中以代碼表之。各細分類目的代碼與對照名稱詳如表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 | 自由座車廂 |
班表資料回傳結果中，依不同軌道系統的票價訂定方式，所回傳的欄位會有些許差異。另請注意，由於此函式係回傳所有起訖對的票價資料，故若軌道系統的站點數愈多（如：臺鐵、臺北捷運），回傳的時間將會愈久。
◎ 函式參數
| 參數 | 必選填 | 功能 | 參數設定值 |
|---|---|---|---|
access_token=
|
必填參數 | [Access Token] | 1.6.3 Access Token 取得方式 |
operator=
|
營運單位代碼 |
請參照TDX_Railway表格
|
|
out=
|
選填參數 | 匯出資料之路徑 |
FALSE：不匯出資料至本機 [預設值]
|
若欲輸出此結果，路徑中必須含有.csv或.txt
|
◎ 程式碼撰寫範例
回傳高雄輕軌起訖對票價資料