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 / UDP使用說明注意事項.md
Last active October 12, 2017 08:05

技術性問題

問題1：公車預估到站資料(N1)若該路線上無公車正在服務，就無法查到資料。如：公總7011上的到站時間，701101, 701102是查得到的，但7011A1和7011A2常常查不到。

  • 這是正常的，N1是事件驅動，必須等發車或A2觸發才有資料。

問題2：目前N1的查詢上，CurrentStop為「車輛目前所在站牌代碼」， 就常理推估，一台公車在同一時間的同一路線上，CurrentStop應該都為同一站， 但常常會有車輛目前所在站牌代碼卻有兩個

  • 這是合理的，因每一筆資料更新時間皆不同，舉例7120路線上某ㄧ車牌為908-FS公車在8點31分15秒時CurrentStop為249995，在8點57分16秒時CurrentStop為296654，來源端資料雖不斷更新進來，但資料庫會保留最近的資料，並不會ㄧ接收到新資料就會將此車牌就的預估到站時間洗掉。
@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 / 官網資料標準test.md
Last active December 27, 2017 04:14
官網資料標準test.md

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

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

@ptxmotc
ptxmotc / Standards.md
Last active March 28, 2024 07:00

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

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

@ptxmotc
ptxmotc / 線上教學.md
Last active January 4, 2018 08:55
線上教學.md

【API應用服務教學】

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

@ptxmotc
ptxmotc / 支援ODATA查詢語法.md
Created January 4, 2018 08:56
支援ODATA查詢語法.md
@ptxmotc
ptxmotc / URI命名原則.md
Created January 4, 2018 08:57
URI命名原則.md

【URI命名原則】

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

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

  • 網站根目錄：應用服務的基本網址，主要組成為(Domain)網域名稱和(App)應用程式名稱，並且透過 HTTP 協定連結而形成服務的基本網址。
@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 / 資料服務版本說明.md
Created January 4, 2018 09:02
資料服務版本說明.md

資料服務版本說明

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

V1版

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

@ptxmotc
ptxmotc / 會員申請流程.md
Created January 4, 2018 09:04
會員申請流程.md

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