ptxmotc

航空API動靜態資料

1. 介接航空資料時須注意本平臺機場代碼皆以IATA國際代碼三碼為API服務查詢及資料串接之基礎。
2. 即時航班到離站資料(FIDS)分別以機場角度(Airport)及航班(Flight)角度提供資料服務,加值業者在使用時需注意應用面向避免引用錯誤。

• 機場角度航班到離站資訊顯示(FIDSAirport)：以第三方機場角度提供動態站別航班顯示資料。
• 班機角度航班到離站資訊顯示(FIDSFlight)：以飛機角度提供動態站別航班顯示資料。

3. 航空定期航班班表由民航局及桃園機場提供，目前僅提供客運航班班表資料，國際定期航班班表有包含兩岸航班。
4. 國際定期航班起飛或降落時間有+1的現象，代表Flight Date 日期+1天，並非+1小時，因航班日期皆以起飛城市當地時間及降落城市當地時間提供，為了解決班機所遇到之時差問題，如台北飛洛杉磯可能10月07日10:00早上台北起飛，10月07日07:00早上洛杉磯降落，此時航班僅會以10:00標示顯示；但若遇到台北飛孟買，10月09日1:00下午台北起飛，10月10日1:00早上孟買降落，此時就會顯示+1(天)
5. 部分欄位若為空值是因來源單位尚未提供介接。

ptxmotc

PTX平臺導入API機制及會員申請流程說明，可下載文件參閱連結。

ptxmotc

資料服務版本說明

資料服務V1版及V2版差別說明

V1版

服務內容包含航空、臺鐵、高鐵、公總公路客運及六都市區公車動靜態資料服務共56筆，市區公車資料及公路客運資料並無做區隔，新北無A1、A2資料僅提供N1動態資料，台中與高雄無A2動態資料，台北市無附屬路線概念，後續並不做任何修改與調整。

ptxmotc

API 認證授權機制

1. 說明:本平臺原採用ticket認證授權機制，後配合API Management解決方案的導入，改採HMAC認證授權機制。

2. 原ticket機制：係透過/v2/Account/Login API取得ticket，再透過該ticket取得各式API資料。該機制將配合新的HMAC機制導入後，隨即失效。

3. HMAC機制：以HMAC簽章驗證使用者的身份，用戶在請求API服務時，將APP Key 與當下時間(格式請使用GMT時間) 做HMAC-SHA1 運算後轉成Base64 格式，帶入signature屬性欄位，服務器端將驗證用戶請求時的header欄位(詳如第四點)，驗證使用者的身份及請求服務的時效性。

4. HMAC Signature簽章時效性：於MOTC Helper 該網頁測試時，請在最上方輸入 API Key 與 API ID

ptxmotc

【URI命名原則】

開放資料可透過URL方式取得資料。

Web API (application programming interface) 的表現方式，分為網站根目錄(App Root)、資源路徑(Resource Path)和查詢選項(Query Options)

• 網站根目錄：應用服務的基本網址，主要組成為(Domain)網域名稱和(App)應用程式名稱，並且透過 HTTP 協定連結而形成服務的基本網址。

ptxmotc

【ODATA使用說明】

1. 基本查詢 http://ptx.transportdata.tw/MOTC/Rail/TRA/Station?$format={format}

   {format}為資料格式：json、xml、csv

   範例：火車車站基本資料http://ptx.transportdata.tw/MOTC/Rail/TRA/Station?$format=xml

ptxmotc

【API應用服務教學】

公共運輸整合資訊流通服務平臺提供結構化、多彈性、多種領域API服務，以下將教學使用者如何透過所申請的App ID及App Key存取Swagger資料。

• Swagger使用說明：影片教學請點我

• 從EXCEL吃OAS API 結構目錄：影片教學請點我

• 從EXCEL拉取PTX API資料：影片教學請點我

ptxmotc

為促進各政府機關所發布公共運輸資訊格式之統一，交通部於民國104年起進行各項資料盤點，並據此訂定公共運輸旅運資料服務標準，作公共運輸資料流通的標準規範。

公共運輸旅運資料標準(V2.0)[最新版]

• 標準v2.0

  公共運輸標準V2.0.pdf (2019/10/31更新)

ptxmotc

為促進各政府機關所發布公共運輸資訊格式之統一，交通部於民國104年起進行各項資料盤點，並據此訂定公共運輸旅運資料服務標準，作公共運輸資料流通的標準規範。

公共運輸旅運資料標準(V2.0)[最新版]

• 標準v2.0

  公共運輸標準V2.0.pdf

ptxmotc

航空驗證資料清單

說明：資料清單及資料檔案命名名稱對照表。

項次	資料項目名稱	資料檔案名稱	範例連結
1	航空機場資料XML	AirportList.xml	範例連結
2	航空公司資料XML	AirlineList.xml	範例連結
3	航空航線資料XML	AirRouteList.xml	範例連結