航空API資料使用注意事項

一、靜態資料

  1. 民航局提供之機場資料與航空公司資料,資料範圍為全球之機場與航空公司資料。

  2. 機場資料僅包含民用機場與軍民合用機場,不包含軍用機場。

1. 定期班表資料 :

  1. 航空定期航班班表由民航局及桃園機場提供,目前僅提供客運航班班表資料,國際定期航班班表有包含兩岸航班。

  2. 航空定期班表分為國內航空定期時刻表與國際航空定期時刻表,國內航空定期時刻表為每月底更新次月定期班表資料。

  3. 國際定期航班起飛或降落時間有+1的現象,代表Flight Date日期+1天,並非+1小時,因航班日期皆以起飛城市當地時間及降落城市當地時間提供,為了解決班機所遇到之時差問題,如:台北飛洛杉磯可能10月7日早上10:00台北起飛,10月7日早上7:00洛杉磯降落,此時航班僅會以10:00標示;但若遇到台北飛孟買,10月9日下午1:00台北起飛,10月10日早上1:00孟買降落,此時就會顯示+1(天)。

2. 每日班表資料 :

  1. 航空每日飛行班表資料,由國內線各航空公司每天滾動式提供未來 N 天之每日飛行班表 (立榮提供未來15天,德安提供未來60天)。

  2. 欲查詢每日飛行班表中各航班即時剩餘位狀態,可透過每日飛行班表之航線/日期/航班編號參數,於航班即時剩餘位資料中查詢。

3. 航線票價資料 :

國內指定[航空公司]航線票價資料,提供各航空公司官網公告之法定票價資料。

二、動態資料

介接航空資料時須注意本平臺機場代碼皆以IATA國際代碼三碼為API服務查詢及資料串接之基礎。

1. 即時航班資料 :

  1. 即時航班到離站資料(FIDS)分別以機場角度(Airport)及航班(Flight)角度提供資料服務,加值業者在使用時需注意應用面向避免引用錯誤。

    • 機場角度航班到離站資訊顯示(FIDSAirport):以第三方機場角度提供動態站別航班顯示資料。

    • 班機角度航班到離站資訊顯示(FIDSFlight):以飛機角度提供動態站別航班顯示資料。

  2. 部分欄位若為空值是因來源單位尚未提供介接。

  3. 桃機即時航班包含前日、當日、次日之航班資訊。

  4. 本平臺服務係針對全臺航空資訊為主,故以機場為角度(FIDSAirport)之即時航班資料僅顯示國內機場;而班機為角度(FIDSFlight)之即時航班資料僅顯示國內機場的各班機出發Departure或抵達相關資訊Arrival),如BR108班機由高雄飛往東京,則FIDSFlight即時航班資訊僅會顯示ScheduleDepartureTime、ActualDepartureTime及EstimatedDepartureTime,而BR108抵達相關資訊則無提供。

  5. 有關ScheduleDepartureTime、EstimatedDepartureTime、ActualDepartureTime的分別:

    • ScheduleDepartureTime (表定時間 ):航空公司向民航局提交航班計畫時,預為規劃各航班的起、降時間,該時間經民航局核定後原則上不會變更,適用於查詢二天以上的航班時間。

    • EstimatedDepartureTime ( 預估時間 ):每日航務人員或航空公司視當日航班有無其他因素導致起、降延誤,因而預估航班起、降時間,適用於查詢當日尚未起、降航班時間。

    • ActualDepartureTime ( 實際時間 ):紀錄各航班已起、降時間。

    例如:

    • 某旅客於松山機場的網站欲查詢3天後有哪些班機從松山機場飛往南竿機場,此時查詢的時間即為ScheduleDepartureTime (表定時間 )。

    • 該旅客3天後至松山機場欲搭乘下午1:00由松山飛往南竿的班機,此時該旅客於機場內的FIDS系統查看起飛時間因天候不佳改為1:20起飛,此為EstimatedDepartureTime ( 預估時間 ) 。

    • 航班飛機於下午1:20自松山機場起飛後,該時間則為ActualDepartureTime ( 實際時間 )。

  6. 取消的航班,在 DepartureRemark 欄位會進行註記。

  7. 若需查詢即時航班的機型資訊,可依據航空公司IATA代碼 (AirlineID欄位) 與航機班號 (FlightNumber欄位) ,查詢國內指定[航空公司]每日飛行班表資料的機型IATA代號 (AircraftType欄位) 。

2. 航班剩餘位資料 :

  1. 欲查詢每日飛行班表中各航班即時剩餘位狀態,可透過每日飛行班表之航線/日期/航班編號參數,於航班即時剩餘位資料中查詢。

  2. 航班即時剩餘位資料為確保資料即時性,採使用者呼叫再向航空公司呼叫的的機制,因此響應時間較慢。

  3. 各航空公司將視呼叫情形調整rate limit :

    • 立榮航空航班剩餘位rate limit: 每個IP,每半小時100次,若超過100次則擋半小時,一天最多5,000次。

Last updated