Chapter 5 航空與航運資料

本套件所介接的航空資料目前僅包含國內外的航線班表資料。航運資料則含括港口點位資料、航運航線資料、航線靠港順序資料資料。

5.1 航空班表資料

◎ 資料概述
回傳結果包含航空公司代碼、班次號碼、起降機場代碼、出發與到著時間、各星期營運與否等資料。本函式中可提供國內與國際航線之班表資料，僅須設定domestic=之參數即可。

◎ 函式參數

Air_Schedule(access_token, domestic=TRUE, out=FALSE)

表 5.1: Air_Schedule()函式參數設定表

參數	必選填	功能	參數設定值
access_token=	必填參數	[Access Token]	1.6.3 Access Token 取得方式
domestic=		國內或國際航線	TRUE：回傳國內航空班表
			FALSE：回傳國際航空班表
out=	選填參數	匯出資料之路徑	FALSE：不匯出資料至本機 [預設值]
			若欲輸出此結果，路徑中必須含有.csv或.txt

◎ 程式碼撰寫範例
回傳國內航空班表資料

# 介接國內航空班表
air_schedule_domestic=Air_Schedule(access_token, domestic=TRUE)

# 查看air_schedule_domestic資料
air_schedule_domestic

5.2 港口點位資料

◎ 資料概述
回傳結果為港口名稱與經緯度。

◎ 函式參數

Ship_Port(access_token, dtype="text", out=FALSE)

表 5.2: Ship_Port()函式參數設定表

參數	必選填	功能	參數設定值
access_token=	必填參數	[Access Token]	1.6.3 Access Token 取得方式
dtype=	選填參數	回傳的資料型態	text：純文字形式，其資料型態屬data.frame [預設值]
			sf：地理資料形式，其資料型態屬sf
out=		匯出資料之路徑	FALSE：不匯出資料至本機 [預設值]
			若回傳的資料型態為「text」：路徑必須含有.csv或.txt
			若回傳的資料型態為「sf」：路徑必須含有.shp

◎ 程式碼撰寫範例
回傳全臺所有港口資料（地理資料）

# 介接全臺港口資料
taiwan_port=Ship_Port(access_token, dtype="sf")

# 查看taiwan_port資料
taiwan_port

5.3 航運航線資料

◎ 資料概述 回傳國內航運之航線班表資料。

◎ 函式參數

Ship_Route(access_token, county, out=FALSE)

表 5.3: Ship_Route()函式參數設定表

參數	必選填	功能	參數設定值
access_token=	必填參數	[Access Token]	1.6.3 Access Token 取得方式
county=		縣市代碼	請參照TDX_County表格，並確保該縣市有港口
out=	選填參數	匯出資料之路徑	FALSE：不匯出資料至本機 [預設值]
			若欲輸出此結果，路徑中必須含有.csv或.txt

◎ 程式碼撰寫範例 回傳新北市航運航線資料

# 介接新北市航運航線資料
NWT_shiproute=Ship_Route(access_token, "NewTaipei")

# 查看NWT_shiproute資料
NWT_shiproute

5.4 航線靠港順序資料

◎ 資料概述 回傳國內航線停靠港口順序資料。

◎ 函式參數

Ship_StopOfRoute(access_token, county, out=FALSE)

表 5.4: Ship_StopOfRoute()函式參數設定表

參數	必選填	功能	參數設定值
access_token=	必填參數	[Access Token]	1.6.3 Access Token 取得方式
county=		縣市代碼	請參照TDX_County表格，並確保該縣市有港口
out=	選填參數	匯出資料之路徑	FALSE：不匯出資料至本機 [預設值]
			若欲輸出此結果，路徑中必須含有.csv或.txt

◎ 程式碼撰寫範例 回傳新北市各航線靠港順序資料

# 介接新北市各航線靠港順序
NWT_ship_portseq=Ship_StopOfRoute(access_token, "NewTaipei")

# 查看NWT_ship_portseq資料
NWT_ship_portseq