motc-ptx-api-documentation
  • 入門指南
  • 會員申請
    • 會員分級
    • 註冊申請
    • 常見問題
  • API使用
    • 資料服務說明文件
    • 授權驗證
    • 線上教學
    • 範例程式
    • 資料流概念
    • 常見問題
  • API特色
    • URI命名原則
    • 支援OData查詢語法
  • API資料使用注意事項
    • 版本說明
    • 資料供應現況
    • 航空API資料使用注意事項
    • 公車API靜態資料使用注意事項
    • 公車API動態資料使用注意事項
    • 雙鐵API資料使用注意事項
    • 靜態異動檔API資料使用注意事項
    • 健康狀態Health參數使用注意事項
    • 服務日資料使用注意事項
  • API資料上架說明
    • 資料標準文件
    • 驗證工具說明
  • 示範應用
    • 示範應用上架
  • 虛擬點數
    • 虛擬點數機制
    • 常見問題
  • 公共運輸資料檢核規範
    • 所有公共運輸資料資料檢核項目
    • 公路運輸資料檢核項目
    • 軌道運輸資料檢核項目
    • 航空運輸資料檢核項目
    • 公共自行車資料檢核項目
    • 航運運輸資料檢核項目
    • 檢核項目與代碼說明
Powered by GitBook
On this page

Was this helpful?

  1. API資料使用注意事項

服務日資料使用注意事項

以星期為單位來描述週期性的活動,其格式定義如下(為「公共運輸旅運資料標準V2.0」之規範):

ServiceDay

欄位

選填

優先度

欄位說明

Monday

否

3(低)

週一 營運/服務 與否

Tuesday

否

3

週二 營運/服務 與否

Wednesday

否

3

週三 營運/服務 與否

Thursday

否

3

週四 營運/服務 與否

Friday

否

3

週五 營運/服務 與否

Saturday

否

3

週六 營運/服務 與否

Sunday

否

3

週日 營運/服務 與否

NationalHolidays

是

2(中)

國定假日 營運/服務 與否

DayBeforeHoliday

是

2

國定假日前一天 營運/服務 與否

DayAfterHoliday

是

2

國定假日後一天 營運/服務 與否

TyphoonDay

是

1(高)

颱風停止上班上課期間 營運/服務 與否

國定假日 (national holidays) 不包含週六與週日

以上可注意到有四個選填欄位,這些欄位判斷的優先度較高。以底下範例為例:

{
    Monday: 1,
    Tuesday: 1,
    Wednesday: 1,
    Thursday: 1,
    Friday: 1,
    Saturday: 0,
    Sunday: 0,
    DayAfterHoliday: 0,
    TyphoonDay: 1
}

上述資料可能會碰到底下情形:

  1. 星期三是國定假日後一天:由於DayAfterHoliday有設定為0 (優先度較Wednesday高),因此當天不 營運/服務

  2. 星期三是國定假日:由於Wednesday設定為1 (因為無給定NationalHolidays,表示不受國定假日影響),因此當天會 營運/服務

  3. 星期三是國定假日後一天,也恰好是颱風停止上班上課期間:由於TyphoonDay有設定為1 (優先度較DayAfterHoliday與Wednesday高)

    ,因此當天會 營運/服務

Previous健康狀態Health參數使用注意事項NextAPI資料上架說明

Last updated 4 years ago

Was this helpful?