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


  1. MRT
    1. 捷運路線基本資料
    2. 捷運車站基本資料
    3. 捷運營運路線基本資料
    4. 捷運列車站間運行時間資料
    5. 捷運路線站間轉乘基本資料
  2. 行政區域及村里代碼
    1. 縣市之City列表
    2. 指定縣市City之鄉鎮市區列表
    3. 指定縣市City之村里列表

介紹如何介接 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"
  },
  ...
]