API資料使用常見問題.md

API資料使用常見問題.md

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

  建議一、

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

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

  建議二、

  對於取用大量資料的需求者，避免直接使用瀏覽器下載，以防止發生因瀏覽器session timeout而導致誤認PTX平台服務出現問題，建議可利用相關程式(如curl指令)將資料直接抓回使用。

• 疑義資料處理程序？

  PTX平台係與各資料來源端協作模式，進行M2M資料介接，故若有任何資料面議題，平台會協助將問題反映給來源單位，請其協助確認並修正，惟為加速問題釐清，建議將問題佐證畫面與資料併同問題一併提出。

• 為何同一運具但不同單位所提供相同資料項(如:路線/站牌/動態資料..等)，會出現有值的欄位項目不太一致的情況？

  PTX平台目前係以各運具單位可提供資料項目之最大集合來制訂國內的公共運輸旅運資料標準，惟目前多數單位尚未完全依據標準產製資料，而是由PTX平台代為轉成一致之標準格式，故常有加值業者反應如公車資料中為何某些欄位公總有但台北市沒有或台北市有但台南市沒有的狀況產生，故提醒加值者使用資料前必須注意各單位間資料之差異性。