# 航空API資料使用注意事項

## 一、靜態資料

1. 民航局提供之機場資料與航空公司資料，資料範圍為全球之機場與航空公司資料。
2. 機場資料僅包含民用機場與軍民合用機場，不包含軍用機場。

### 1. 定期班表資料 :

1. 航空定期航班班表由民航局及[桃園機場](https://www.taoyuan-airport.com/flight_timetable)提供，目前僅提供客運航班班表資料，國際定期航班班表有包含兩岸航班。
2. 航空定期班表分為國內航空定期時刻表與國際航空定期時刻表，國內航空定期時刻表為每月底更新次月定期班表資料。
3. 航空定期班表之航班資訊分為夏季航班與冬季航班，其中夏季航班班表為每年3月的最後一個星期日至10月的最後一個星期六之班表，冬季航班班表為每年10月的最後一個星期日至次年3月的最後一個星期六，由於夏季班表或冬季班表公布前各航空公司須重新提報給民航局審查，因此每年3月與10月的完整航班班表會較晚開放。
4. 國際定期航班起飛或降落時間有+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次。