Skip to content

Instantly share code, notes, and snippets.

View ptxmotc's full-sized avatar

PTX ptxmotc

22 followers · 0 following
View GitHub Profile
@ptxmotc
ptxmotc / Standards.md
Last active March 28, 2024 07:00

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

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

@ptxmotc
ptxmotc / 公共運輸驗證資料清單.md
Last active June 23, 2022 03:31
公共運輸驗證資料清單.md

航空驗證資料清單

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

項次 資料項目名稱 資料檔案名稱 範例連結
1 航空機場資料XML AirportList.xml 範例連結
2 航空公司資料XML AirlineList.xml 範例連結
3 航空航線資料XML AirRouteList.xml 範例連結
@ptxmotc
ptxmotc / 公車API資料使用注意事項.md
Created January 4, 2018 09:07
公車API資料使用注意事項.md

市區公車及公路客運API動靜態資料

  1. 動態資料傳遞延遲

公路客運六都市區公車動態資料延遲時間(來源端—PTX平台)：

動態資料延遲時間
公總 即時推播，約2~3秒
台北市 約10秒
@ptxmotc
ptxmotc / 停車驗證資料清單.md
Last active March 8, 2022 06:01
停車驗證資料清單

共通驗證資料清單

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

項次 資料項目名稱 資料檔案名稱 範例連結
1 停車業管機關資料XML ParkingAuthorityList.xml 範例連結
2 停車營運業者資料XML ParkingOperatorList.xml 範例連結
3 停車最新消息資料XML ParkingNewsList.xml 範例連結
4 停車營運通阻資料XML ParkingAlertList.xml 範例連結
@ptxmotc
ptxmotc / PTX_DataQuality.md
Last active December 30, 2021 09:20
PTX_DataQuality.md

1. 檢核 PTX 六都公車資料是否符合空間品質檢核標準

檢核目的：為了強化空間資料品質內容，落實運輸資訊共用共享原則，今年度將進行資料品 質檢核報告推動，透過交通部空間資料品質檢核工具，週期性通報各單位 資料品質檢核報告結果，並請來源端協同修正相關圖資，落實公共運輸資料服務供應的準確性。

檢核對象：六都之市區公車空間線型資料

檢核頻率：每月一次

@ptxmotc
ptxmotc / 即時路況驗證資料清單.md
Last active June 25, 2021 17:49
即時路況驗證資料清單.md

車輛偵測器(VD)驗證資料清單

項次 資料項目名稱 資料檔案名稱
1 VD靜態資料XML VD.xml
2 VD動態資料XML VDLive.xml
@ptxmotc
ptxmotc / 資料服務使用注意事項.md
Last active April 29, 2021 14:56

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

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

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

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

@ptxmotc
ptxmotc / API 授權驗證.md
Created January 4, 2018 08:58
API 授權驗證.md

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
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 / 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。