TDX API 介接教學全攻略

TDX API 用途

平臺提供涵蓋全國尺度之公車、臺鐵、高鐵、捷運、航空、自行車等公共運輸旅運資料服務 API，歡迎各產政學單位介接使用。
利用本平臺開放資料進行各項應用服務開發時，請考量不同特性使用者(如:性別/身心障礙/老幼等)的需求

本次活動 API 介紹

觀光

  1. 取得所有觀光景點資料：/v2/Tourism/ScenicSpot
  2. 取得指定[縣市]觀光景點資料：/v2/Tourism/ScenicSpot/{City}

兩者資料集撈取的景點資料一樣，但後者可以針對縣市來撈取

自行車

  1. 取得動態指定[縣市]的公共自行車即時車位資料：/v2/Bike/Availability/{City}
  2. 取得指定縣市之自行車道路網圖資：/v2/Cycling/Shape/{City}
  3. 取得指定[位置,範圍]的全臺公共自行車即時車位資料：/v2/Bike/Availability/NearBy

公車

  1. 取得市區所有公車路線：/v2/Bus/Route/City/{City}
  2. 取得預估到站資料[批次更新]：/v2/Bus/EstimatedTimeOfArrival/City/{City}/{RouteName}
  3. 取得路線的站序資料(座標)：/v2/Bus/StopOfRoute/City/{City}/{RouteName}
  4. 取得路線資訊(營運業者、車牌號碼、票價)：/v2/Bus/Route/City/{City}/{RouteName}
  5. 取得指定[縣市],[路線名稱]的市區公車路線班表資料：/v2/Bus/Schedule/City/{City}/{RouteName}

filter 篩選取得路線名稱為紅56：contains(RouteName/Zh_tw,'紅56A')

https://ptx.transportdata.tw/MOTC/v2/Bus/Route/City/Kaohsiung?\(filter=contains(RouteName/Zh_tw,%27%E7%B4%8556A%27)&\)format=JSON

公車範例

TDX API 申請 網址

流程

  1. 註冊會員，並選擇一般會員
  2. 依照下方欄位填寫，三天後審核成功就會發 Email 信提供 APP ID / KEY
身分類型：加值業者
服務類型：資訊服務業
資料使用用途：程式教學/練習
應用類型：觀光旅遊、網站應用
網址：可先暫填自己的 GitHub 網址或 repo 或 codepen
加值應用、加值應用名稱：加註 「The F2E 活動用」(若能詳述如何應用會更好)
申請服務概述：公車、觀光景點、腳踏車 API等動靜態資料(看要不要說更詳細也可以)

Q：被退審核後，該如何重新申請？
Q：找不到 APP KEY 該怎麼辦？

API 帶 header 驗證範例程式碼

不帶 APP ID、KEY 還是可以練習，但會有請求次數限制

JS 取值設計

API 介接文章教學

  1. TDX：運輸資料流通服務，以 JS 串接公車等待時間為例
  2. Postman 如何使用 HMAC 以 TDX API 為例

Q:

  • curl
Select a repo