ptxmotc

適用對象

適用跨運具開發、全臺灣範圍之開發者

申請說明

• 用戶填寫必填欄位資料並提交後，經用戶啟用會員帳號後，本平臺管理小組將於三個工作日核定審核結果並通知申請者。
• 若申請通過系統將會寄出授權信，授權信件內將包含一Application ID及Application - Key，即可使用API服務。
• 每個帳號若申請不同會員身份則會有不同的Application ID，並依據申請API服務類型給予唯一的Application Key。
• 當您忘記Application Key時，會員可於登入網站後，點選 【忘記Key】按鍵，系統將重新發送更新Application Key信件取代原有Application Key。

ptxmotc

適用對象

適用單一運具開發、單一區域範圍之開發者

申請說明

• 用戶填寫必填欄位資料並提交後，經用戶啟用會員帳號後，本平臺管理小組將於三個工作日核定審核結果並通知申請者。
• 若申請通過系統將會寄出授權信，授權信件內將包含一Application ID及Application - Key，即可使用API服務。
• 每個帳號若申請不同會員身份則會有不同的Application ID，並依據申請API服務類型給予唯一的Application Key。
• 當您忘記Application Key時，會員可於登入網站後，點選 【忘記Key】按鍵，系統將重新發送更新Application Key信件取代原有Application Key。

ptxmotc

交通部（以下簡稱本部）「公共運輸整合資訊流通服務平臺(PTX)」（以下簡稱本平臺）於2017年11月1日起推動會員分級及API管理機制導入，擬規劃會員申請常見問題內容供會員參閱。

問題1：為什麼需要推動會員級別機制呢？

• 為了在有限的資源下提供穩定的資料服務水準並提升服務品質，同時調配使用者授權可用流量機制及加強資訊安全管理，也期掌握各加值業者於PTX平臺使用狀況，本部於106年11月1日起正式推動會員分級及API管理機制導入。

問題2：我要如何判別申請的會員類別呢？

• 您可依據以下適用原則申請一般會員、進階會員及專案用戶。
• 一般會員：適用單一運具開發、單一區域範圍之開發者。
• 進階會員：適用跨運具開發、全臺灣範圍之開發者。
• 專案用戶：為能夠在有限的資源下，提供穩定的資料服務水準，故須對專案用戶有所限制。申請資格建議須以能夠以一年內能產出具體成果且呼叫次數能夠確實達到相關上限為主，另本部保留取消會員相關資格機制之權利。

ptxmotc

交通部（以下簡稱本部）「公共運輸整合資訊流通服務平臺(PTX)」（以下簡稱本平臺）規劃常見問題內容供用戶參閱。

問題1：本平臺主要服務對象？

• 本平台主要提供對公共運輸旅運資料有興趣的網頁或APP加值者，服務對象包括：自由創作者、商用加值業者、研究機構、內外部需用機關等，各類人員對於公共運輸資料完整性、品質要求、動態資料、開發便利性等需求因子程度並不一致。

問題2：本平臺是否涵蓋所有公共運輸資料？

• 公共運輸整合資訊流通現階段仍無法涵蓋所有運具，短期間將以民眾關心、資料公開、異動更新等程度較高之跨運具公共運輸「旅運規劃」資料為優先整合對象，其他如運量或票證等統計資訊尚未納入考量，未來是否進行將再行討論。

問題3：本平臺與其他之Open Data平台不同之處？

• 公共運輸整合資訊流通服務平臺為交通部公共運輸資料開放（Open Data）的重要管道，以公共運輸旅運資料標準為流通基礎，介接各類型公共運輸資料包括：公路、軌道、航空、海運等，本平台特點為所有公開的API皆因應跨運具資訊整合需求依資料標準轉化，並採用國際OData標準介面格式對外供應，在加值應用上十分便利有彈性。

ptxmotc

Swagger官網檔案存放位置區。

資料服務開發實作參考手冊

API URI Convention文件說明

更新時間：2018/02/26 14:27

ptxmotc

【會員註冊申請】

您開始使用本平臺或註冊成為本平臺會員，請詳閱、瞭解1)用戶權益與義務聲明及2)隱私權保護及資訊安全政策之所有內容。如您不同意本聲明全部或部分內容，請勿註冊，並請立即停止使用本服務。 若您確認並同意以上聲明，請點此連結前往加入會員

ptxmotc

• 對於檔案較大的靜態資料服務，建議介接方式？

  建議一、

  整批靜態資料下載因資料量較大，請勿直接取用，建議善用OData Select語法，篩檢所需之資料欄位可大量減少資料量。另若要用OData語法中的top跟skip來批次存取資料時，建議先針對整批靜態資料的主鍵值(PK)進行排序，再進行批次抓取。

  範例如下：介接國內定期班表資料 Key值欄位：FlightNumber, ScheduleStartDate

  建議二、

ptxmotc

資料供應現況

本平臺逐步介接全臺公共運輸資料並對外開放API動靜態資料服務 如需查詢資料供應現況可下載文件參閱連結

ptxmotc

靜態資料差異化/異動檔API資料

1. 主要係提供不同資料版本間，特定資料項目(如路線、站牌、路線站序、時刻表、票價、線型圖資..等)之異動檔資料查詢服務，期能讓加值業者快速瞭解哪些資料項目已異動需即時進行資料更新，並讓民眾可以獲得最新的公共運輸資訊。

2. 近期異動資料查詢API內的VariationType欄位說明:為標示被比較的兩個版本資料的變化狀態(新增、修改、刪除)。

   但其中標示為「修改」狀態的資料實際上可能並無變化，而造成此情形的狀況可能如下(以三個版本的情況為例):

ptxmotc

雙鐵API動靜態資料

1. 台鐵列車到離站動態即時電子看板資料(Liveboard)，目前延遲時間為2分鐘，該資料與台鐵官網的列車動態資料來源一致，但與車站或月台上即時顯示的TIDS看板並非一致，會有時間上的延遲，故加值業者在該項資料使用上，請注意並請勿直接與車站或月台上的TIDS看板進行比對，並提醒民眾進入車站主體後，即請以車站內部系統顯示的動態資訊為主。

2. 雙鐵臨時加班資訊： 雙鐵僅提供前一天異動資訊，目前尚無法提供當日臨時加班資訊。

3. 「列車即時準點/誤點資料」與「車站別列車即時到離站電子看板資料」之差異：