Chapter 4 自行車運輸資料

自行車運輸資料包含公共自行車站點與自行車路網，擷取兩資料皆須設定縣市之參數（county=），請參照TDX_County表格。公共自行車站點資料的業管機關多為各級縣市政府的交通局（處），少部分地方政府係分別由觀光處（金門縣）、城鄉發展處（屏東縣）、工務處（苗栗縣）管轄。自行車路網乃線型資料，所蒐集的路網為經過數化的資料，並不代表該縣市僅有資料中的自行車路網，故使用或分析時必須特別注意。而自行車路網之蒐集目前以臺北市的資料最為完整。

4.1 公共自行車站點資料

◎ 資料概述
此函式的回傳結果包含站點代碼、站點名稱、經緯度、站點車樁數等。大部分縣市的公共自行車皆為 YouBike 系統，並可細分為 YouBike 1.0 與 YouBike 2.0，故若為 YouBike 系統之縣市，另外記錄一欄位為「服務類型」（ServiceType），其中標記為 YouBike1 者，即表示 YouBike 1.0；反之標記為 YouBike2 者，即表示 YouBike 2.0。目前全臺灣各縣市的公共自行車系統名稱整理如表4.1。

表 4.1: 全臺各縣市公共自行車系統彙整
縣市名稱	縣市代碼	公共自行車系統
臺北市	Taipei	YouBike 1.0、YouBike 2.0
新北市	NewTaipei	YouBike 1.0、YouBike 2.0
桃園市	Taoyuan	YouBike 1.0
臺中市	Taichung	YouBike 1.0、YouBike 2.0 （ibike）
臺南市	Tainan	T-Bike
高雄市	Kaohsiung	YouBike 2.0
基隆市	Keelung	–
新竹市	Hsinchu	YouBike 1.0
新竹縣	HsinchuCounty	–
苗栗縣	MiaoliCounty	YouBike 1.0
彰化縣	ChanghuaCounty	– （參見備註）
南投縣	NantouCounty	–
雲林縣	YunlinCounty	–
嘉義縣	ChiayiCounty	–
嘉義市	Chiayi	YouBike 2.0
屏東縣	PingtungCounty	Pbike
宜蘭縣	YilanCounty	–
花蓮縣	HualienCounty	–
臺東縣	TaitungCounty	–
金門縣	KinmenCounty	K Bike
澎湖縣	PenghuCounty	–
連江縣	LienchiangCounty	–
^* 彰化縣公共自行車原為 YouBike 1.0 系統，於2021年9月1日始逐步轉換為 Moovo 無樁系統，惟目前此公共自行車的站點資料尚未匯入 TDX 平臺！

◎ 函式參數

Bike_Station(access_token, county, dtype="text", out=FALSE)

表 4.2: `Bike_Station()`函式參數設定表
參數	必選填	功能	參數設定值
`access_token=`	必填參數	[Access Token]	1.6.3 Access Token 取得方式
`county=`	必填參數	縣市代碼	請參照`TDX_County`表格，並確保所輸入的縣市具公共自行車系統
`dtype=`	選填參數	回傳的資料型態	`text`：純文字形式，其資料型態屬`data.frame` [預設值]
`dtype=`		回傳的資料型態	`sf`：地理資料形式，其資料型態屬`sf`
`out=`		匯出資料之路徑	`FALSE`：不匯出資料至本機 [預設值]
			若回傳的資料型態為「`text`」：路徑必須含有`.csv`或`.txt`
			若回傳的資料型態為「`sf`」：路徑必須含有`.shp`

◎ 程式碼撰寫範例
回傳臺北市公共自行車站點資料（地理資料）

# 介接臺北市公共自行車站點
Taipei_bike_station=Bike_Station(access_token, "Taipei", dtype="sf")

# 查看Taipei_bike_station資料
Taipei_bike_station

# 線上互動式地圖繪製
tmap_mode("view")

tm_shape(Taipei_bike_station)+
  tm_dots(col="ServiceType", size="BikesCapacity")

NOTE
以上程式碼中係利用 tmap 套件繪製線上互動式地圖，若欲使用請先行安裝並載入該套件。R 語言中「線上互動式地圖繪製」之方法，請參考 Spatial Analysis with R (Chia Jung, Yeh) 3.8.1 小節 tmap

4.2 自行車線型資料

◎ 資料概述
回傳結果包含路線名稱、路線起迄路口、路線長度、空間資料（線）等。惟須注意的是，部分自行車路段並未記錄路線起迄路口，抑或該路段兩端點非路口，此情況下該二欄位將顯示<NA>（儲存格空白）。

◎ 函式參數

Bike_Shape(access_token, county, dtype="text", out=FALSE)

表 4.3: `Bike_Shape()`函式參數設定表
參數	必選填	功能	參數設定值
`access_token=`	必填參數	[Access Token]	1.6.3 Access Token 取得方式
`county=`	必填參數	縣市代碼	請參照`TDX_County`表格
`dtype=`	選填參數	回傳的資料型態	`text`：純文字形式，其資料型態屬`data.frame` [預設值]
`dtype=`		回傳的資料型態	`sf`：地理資料形式，其資料型態屬`sf`
`out=`		匯出資料之路徑	`FALSE`：不匯出資料至本機 [預設值]
			若回傳的資料型態為「`text`」：路徑必須含有`.csv`或`.txt`
			若回傳的資料型態為「`sf`」：路徑必須含有`.shp`

◎ 程式碼撰寫範例
回傳臺北市自行車線型資料（地理資料）

# 介接臺北市公共自行車站點
Taipei_bike_shape=Bike_Shape(access_token, "Taipei", dtype="sf")

# 查看Taipei_bike_station資料
Taipei_bike_shape

# 線上互動式地圖繪製
tmap_mode("view")

tm_shape(Taipei_bike_shape)+
  tm_lines()

4.3 公共自行車剩餘車輛歷史資料

◎ 資料概述
回傳結果包含各站點各時間點的剩餘車輛與停車位數。

◎ 函式參數

Bike_Remain_His(access_token, county, dates, out=FALSE)

表 4.4: `Bike_Shape()`函式參數設定表
參數	必選填	功能	參數設定值
`access_token=`	必填參數	[Access Token]	1.6.3 Access Token 取得方式
`county=`		縣市代碼	請參照`TDX_County`表格
`dates=`		擷取資料日期 [最多7天]	單一日期：`YYYY-MM-DD`
			多個日期：`YYYY-MM-DD;YYYY/-MM-DD;...`(以分號隔開)
			日期範圍：`YYYYcMM-DD~YYYY-MM-DD`
`out=`	選填參數	匯出資料之路徑	`FALSE`：不匯出資料至本機 [預設值]
`out=`	選填參數	匯出資料之路徑	若欲輸出此結果，路徑中必須含有`.csv`或`.txt`

◎ 程式碼撰寫範例
回傳新竹市公共自行車剩餘車輛歷史資料

# 介接新竹市公共自行車站點
Hsinchu_bike_history=Bike_Remain_His(access_token, "Hsinchu", dates="2022-10-10")

# 查看Hsinchu_bike_history前1000筆資料
Hsinchu_bike_history[1:1000,]

上表回傳結果中AvailableRentBikes表示該時刻下剩餘可租借的車輛數；AvailableReturnBikes則表示該站點剩餘可還車的樁架數。