Skip to content

Instantly share code, notes, and snippets.

@ptxmotc
ptxmotc / ApplyAdvance.md
Last active August 28, 2020 06:50
ApplyAdvance

適用對象

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

申請說明

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

適用對象

  • 適用跨運具開發、全臺灣範圍之開發者或需要更大量授權之用戶
  • 為能夠在有限的資源下,提供穩定的資料服務水準,故須對專案用戶有所限制。申請資格建議須以能夠以一年內能產出具體成果且呼叫次數能夠確實達到相關上限為主,另本部保留取消會員相關資格機制之權利。

申請說明

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

親愛的用戶您好:

交通部(以下簡稱本部)「公共運輸整合資訊流通服務平臺(PTX)」(以下簡稱本平臺)為在有限的資源下提供用戶穩定的資料服務水準、提升服務品質以及加強資訊安全管理,將於106年11月1日起,正式推動會員分級及導入API管理機制。

會員級別分為一般會員、進階會員及專案用戶,加值業者可依自身需求申請不同級別,惟各級別會員之權益及義務不盡相同,詳細資訊可參見本文之用戶權益與義務聲明。此外,未加入會員的用戶仍享有使用API服務之權益,但API資料僅限於Swagger介面中存取,並有50次/日的取用限制。詳細之PTX會員申請辦法及常見問題,請參閱【PTX平臺會員申請流程說明】及【會員申請常見問題】。

為保障您的權益,在您開始以下使用本平臺或註冊成為本平臺會員時,即視為您已確認詳閱、瞭解並同意1)用戶權益與義務聲明及2)隱私權保護及資訊安全政策之所有內容。如您不同意本聲明全部或部分內容,請勿註冊,並請立即停止使用本服務。本聲明之具體約定內容如下:

  1. 用戶需註冊帳號並啟用始成為會員。
  2. 用戶可依據API服務呼叫次數申請成為一般會員、進階會員或專案用戶。
@ptxmotc
ptxmotc / ApplyGeneral.md
Last active August 28, 2020 06:48
ApplyGeneral

適用對象

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

申請說明

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

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

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

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

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

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

本文件主要係提供使用公共運輸整合流通服務平臺(Public Transport Data eXchange)各項資料服務加值業者,在程式開發過程中常見問題的處理方式及資料使用的注意事項,使開發者能更快速地掌握PTX APIs的資料特性,並避免在旅運加值應用上資料運用錯誤。

【平臺使用會員分級說明】

交通部公共運輸整合資訊流通服務平臺會員將分為網站會員及API會員,API會員將細分為一般會員進階會員專案用戶;請詳見下列會員權益說明

更多申請會員FAQ請參閱連結

@ptxmotc
ptxmotc / 上架前test.md
Last active December 6, 2017 02:26
上架前test

資料服務使用說明文件


本文件主要係提供使用公共運輸整合流通服務平臺(Public Transport Data eXchange)各項資料服務加值業者,在程式開發過程中常見問題的處理方式及資料使用的注意事項,使開發者能更快速地掌握PTX APIs的資料特性,並避免在旅運加值應用上資料運用錯誤。

【平臺使用會員分級說明】

交通部公共運輸整合資訊流通服務平臺會員將分為網站會員及API會員,API會員將細分為一般會員進階會員專案用戶;請詳見下列會員權益說明

@ptxmotc
ptxmotc / FAQ.md
Last active August 28, 2020 03:24
FAQ

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

問題1:本平臺主要服務對象?

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

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

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

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

  • 公共運輸整合資訊流通服務平臺為交通部公共運輸資料開放(Open Data)的重要管道,以公共運輸旅運資料標準為流通基礎,介接各類型公共運輸資料包括:公路、軌道、航空、海運等,本平台特點為所有公開的API皆因應跨運具資訊整合需求依資料標準轉化,並採用國際OData標準介面格式對外供應,在加值應用上十分便利有彈性。
@ptxmotc
ptxmotc / 顯示用路線站序.jpg
Last active October 11, 2017 05:55
image2.jpg
顯示用路線站序.jpg