Data Taipei MRT Station 臺北捷運開放資料及行政區域編號 (TDX)

2024-01-02

介紹如何介接 TDX 所提供的捷運相關資料，包含中英文站名、路線、票價與車次時間與全趟時間等資訊 😎

logo

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"
  },
  ...
]
#OpenData #LifeHack