介紹如何介接 TDX 所提供的捷運相關資料,包含中英文站名、路線、票價與車次時間與全趟時間等資訊 😎
MRT
台北捷運的開放資料,沿革由政府資料開放平台的臺北捷運列車到站站名、臺北市資料大平台的臺北捷運列車到站站名、PTX 公共運輸整合資訊流通服務平台,到最新的 TDX 運輸資料流通服務,雖然臺北捷運列車到站站名的開放資料仍有在維護,但整合到 TDX 運輸資料流通服務,看來才是交通資料綜整的趨勢。
本次筆記介紹如何使 TDX 上各式臺北捷運相關的開放資料。
首要先知道的是在 TDX 包含多種的捷運軌道系統,詳如下表:
軌道系統 | 代碼 |
---|---|
臺北捷運 | TRTC |
高雄捷運 | KRTC |
桃園捷運 | TYMC |
臺中捷運 | TMRT |
淡海輕軌 | NTDLRT |
新北捷運 | NTMC |
安坑輕軌 | NTALRT |
而在資料的使用上,有分為基礎服務、進階服務以及加值服務,而原則上 TDX 依照使用者付費的精神,讓資料平台的運作能夠長久的經營下去,因此 API 的呼叫會統計使用的資料量。而本篇筆記僅介紹使用基礎服務的資料,用於簡易的資料處理示範使用。
依照 TDX 說明:「若不使用 API 金鑰 呼叫 API,則僅能透過瀏覽器呼叫【基礎】服務 ,且每個呼叫來源端 IP 的上限為每日 50 次。」
捷運路線基本資料
https://tdx.transportdata.tw/api/basic/v2/Rail/Metro/Line/TRTC?%24format=JSON
資料內容抽樣:
[
{
"LineNo": "BL",
"LineID": "BL",
"LineName": {
"Zh_tw": "板南線",
"En": "Bannan Line"
},
"LineSectionName": {},
"LineColor": "#0a59ae",
"IsBranch": false,
"SrcUpdateTime": "2020-01-31T14:00:00+08:00",
"UpdateTime": "2020-05-20T12:00:00+08:00",
"VersionID": 2
},
...
]
捷運車站基本資料
https://tdx.transportdata.tw/api/basic/v2/Rail/Metro/Station/TRTC?%24%24format=JSON
[
{
"StationUID": "TRTC-BL01",
"StationID": "BL01",
"StationName": {
"Zh_tw": "頂埔",
"En": "Dingpu"
},
"StationAddress": "236040新北市土城區中央路4段51之6號B3",
"BikeAllowOnHoliday": true,
"SrcUpdateTime": "2023-10-12T00:00:00+08:00",
"UpdateTime": "2023-10-17T00:00:00+08:00",
"VersionID": 6,
"StationPosition": {
"PositionLon": 121.418744,
"PositionLat": 24.959351,
"GeoHash": "wsqmfzwqv"
},
...
]
捷運營運路線基本資料
https://tdx.transportdata.tw/api/basic/v2/Rail/Metro/Route/TRTC?%24format=JSON
[
{
"RouteID": "BL-1",
"OperatorCode": "TRTC",
"RouteName": {
"Zh_tw": "頂埔-南港展覽館",
"En": "Dingpu - Taipei Nangang Exhibition Center"
},
"RailRouteType": 33,
"LineNo": "BL",
"LineID": "BL",
"StartStationID": "BL01",
"StartStationName": {
"Zh_tw": "頂埔",
"En": "Dingpu"
},
"EndStationID": "BL23",
"EndStationName": {
"Zh_tw": "南港展覽館",
"En": "Taipei Nangang Exhibition Center"
},
"TravelTime": 48,
"RouteLength": 0,
"SrcUpdateTime": "2022-05-23T00:00:00+08:00",
"UpdateTime": "2022-05-23T08:00:00+08:00",
"VersionID": 3
},
...
]
Schema | 說明 |
---|---|
RailRouteType | 軌道路線類別(33:都市捷運;34:機場捷運) |
TravelTime | 營運路線運行時間(分鐘) |
RouteLength | 營運路線長度距離 |
捷運列車站間運行時間資料
https://tdx.transportdata.tw/api/basic/v2/Rail/Metro/S2STravelTime/TRTC?%24format=JSON
[
{
"LineNo": "BL",
"LineID": "BL",
"RouteID": "BL-1",
"TrainType": 1,
"TravelTimes": [
{
"Sequence": 1,
"FromStationID": "BL23",
"FromStationName": {
"Zh_tw": "南港展覽館",
"En": "Taipei Nangang Exhibition Center"
},
"ToStationID": "BL22",
"ToStationName": {
"Zh_tw": "南港",
"En": "Nangang"
},
"RunTime": 112,
"StopTime": 0
},
...
},
...
]
Schema | 說明 |
---|---|
RouteID | 營運路線代碼 |
RunTime | 站間行駛時間(秒) |
StopTime | 起站停靠時間(秒) |
捷運路線站間轉乘基本資料
https://tdx.transportdata.tw/api/basic/v2/Rail/Metro/LineTransfer/TRTC?%24top=30&%24format=JSON
[
{
"FromLineNo": "BL",
"FromLineID": "BL",
"FromLineName": {
"Zh_tw": "板南線",
"En": "Bannan Line"
},
"FromStationID": "BL07",
"FromStationName": {
"Zh_tw": "板橋",
"En": "Banqiao"
},
"ToLineNo": "Y",
"ToLineID": "Y",
"ToLineName": {
"Zh_tw": "環狀線",
"En": "Circular Line"
},
"ToStationID": "Y16",
"ToStationName": {
"Zh_tw": "板橋",
"En": "Banqiao"
},
"IsOnSiteTransfer": 0,
"TransferTime": 11,
"TransferDescription": "",
"SrcUpdateTime": "2020-01-31T14:00:00+08:00",
"UpdateTime": "2020-05-20T12:00:00+08:00",
"VersionID": 2
},
...
]
Schema | 說明 |
---|---|
TransferTime | 轉乘耗時參考時間(分) |
IsOnSiteTransfer | 0 站外轉車; 1站內轉車 |
💡 已經被實現的動態顯示捷運列車想法:MRT Liveboard
行政區域及村里代碼
縣市名稱 | 英文名稱 | CityCode | CityID |
---|---|---|---|
臺北市 | Taipei | TPE | A |
臺中市 | Taichung | TXG | B |
基隆市 | Keelung | KEE | C |
臺南市 | Tainan | TNN | D |
高雄市 | Kaohsiung | KHH | E |
新北市 | NewTaipei | NWT | F |
宜蘭縣 | Yilan County | ILA | G |
桃園市 | Taoyuan | TAO | H |
嘉義市 | Chiayi | CYI | I |
新竹縣 | Hsinchu County | HSQ | J |
苗栗縣 | Miaoli County | MIA | K |
南投縣 | Nantou County | NAN | M |
彰化縣 | Changhua County | CHA | N |
新竹市 | Hsinchu | HSZ | O |
雲林縣 | Yunlin County | YUN | P |
嘉義縣 | Chiayi County | CYQ | Q |
屏東縣 | Pingtung County | PIF | T |
花蓮縣 | Hualien County | HUA | U |
臺東縣 | Taitung County | TTT | V |
金門縣 | Kinmen County | KIN | W |
澎湖縣 | Penghu County | PEN | X |
連江縣 | Lienchiang County | LIE | Z |
💡 CityID 同身份證字號第一碼,以下列出六都改制及曾經存在的身分證字號第一碼:
縣市名稱 | CityID |
---|---|
臺南縣 | R |
高雄縣 | S |
陽明山 | Y |
臺中縣 | L |
縣市之City列表
https://tdx.transportdata.tw/api/basic/v2/Basic/City?%24format=JSON
[
{
"CityID": "A",
"CityName": "臺北市",
"CityCode": "TPE",
"City": "Taipei",
"CountyID": "A",
"Version": "23.09.1"
},
...
]
指定縣市City之鄉鎮市區列表
https://tdx.transportdata.tw/api/basic/v2/Basic/City/Taipei/Town?%24format=JSON
[
{
"TownName": "中山區",
"TownCode": "63000040",
"CityName": "臺北市",
"Version": "23.09.1"
},
...
]
指定縣市City之村里列表
https://tdx.transportdata.tw/api/basic/v2/Basic/City/Taipei/Village?%24format=JSON
[
{
"VillageName": "莊敬里",
"VillageID": "63000010002",
"TownName": "松山區",
"TownCode": "63000010",
"CityName": "臺北市",
"Version": "23.09.1"
},
...
]