路線建模指南

本路線建模指南提供路線架構、規範和範例的相關資訊,協助您透過 Google 地圖使用大眾運輸路線。

字詞定義

一般大眾運輸動態饋給規格 (GTFS) 是大眾運輸業界常用的公開資料標準,有助運輸公司在提供資料時採用統一格式。

在 GTFS 中,「路線」是指一整組的行程,對乘客顯示為單一服務。請務必依照使用者的認知顯示路線資訊,原因如下:

  • 方便乘客比對周圍標牌和 Google 地圖上的資訊。
  • 確保使用者的認知符合運輸公司內部的定義,避免顯示誤導資訊。

如要建立路線的資料模型,請先瞭解路線的定義:

路線:從起點到目的地的路程 (沒有特定方向),乘客沿途搭乘大眾運輸工具移動。此外,GTFS 也允許路線含有部分特徵相同的多種變化版本,譬如起點和終點可以是不同的兩地,中途也可以有其他地點。

每條路線都具備以下特徵:

  • 與任何時刻表都沒有關聯,因此不受時間影響。
  • 不指涉方向,因此方向不限。
  • 可由多個行程共用,也就是說,運輸公司一天可以多次行駛同一條路線。

建模架構和範例

路線建模取決於使用者的認知。

視為一整組服務的兩條地鐵路線

假設「天南地北」這項地鐵服務有兩條支線,並使用從 NS1 到 NS7 的車站編號。整條路線在 NS5 這站開始分岔,列車分別駛向兩個不同的終點站:NS6 和 NS7。雖然看起來像是兩條路線,但乘客仍會視為同一組服務。

地鐵路線

圖 1:有兩條支線的地鐵路線

在本例中,運輸公司可以依照使用者的認知,將這些支線視為同一條路線來建模。

兩條略有不同的公車路線

假設另有一家運輸公司經營 100 和 100A 這兩條公車幹線,且兩者相當類似。

公車幹線

圖 2:兩條類似的公車幹線

兩輛公車沿途的停靠站相似。

停靠站

圖 3:兩輛公車的停靠站

乘客將兩輛公車視為兩條獨立路線,因此運輸公司可以依照使用者的認知為兩條路線建模。

規範和最佳做法

建議您遵守以下規範:

提供一致的運輸公司 ID

agency_id 資訊參照 agency.txt 檔案中的同一個欄位。為確保能正常參照,請在 agency.txt 和 trips.txt 中使用相同的 agency_id 值。

一律優先使用路線簡稱

Google 地圖不太使用路線全名或路線說明,因此運輸公司應提供路線簡稱。

這項必要資料可以化繁為簡,幫助運輸公司提供對使用者有幫助的資訊。

以路線類型指出交通工具類型

運輸公司可以透過 route_type 資訊提供大眾運輸類型,讓乘客在搭乘前先瞭解他們乘坐的是哪種交通工具。

常用的路線類型包括:

編號

大眾運輸類型

0 路面電車、有軌電車、輕軌電車。
1 地鐵、捷運。
2 鐵路。
3 公車。
4 渡輪。
5 纜道電車。
6 空中纜車、懸吊纜車。
7 纜索鐵路。
11 無軌電車。
12 單軌電車。

如要瞭解擴充路線類型,請參閱本文

提供與實際環境相符的顏色

路線與路線文字的顏色,必須符合乘客在看板、運輸公司網站或書面時刻表看到的顏色。

顏色對比必須鮮明,以利區分。

定義行程的子路線和支線

子路線或支線資訊都是透過 trips.txt 提供。除非乘客將支線視為兩條獨立路線,否則支線和主線必須視為同一條路線來建模。

Google 地圖使用者體驗

本節說明 Google 地圖如何顯示您提供的路線資訊。

發車時刻表

在以下螢幕截圖中,您可以看到 Google 地圖行動應用程式的發車時刻表如何顯示路線類型、路線簡稱和全名的相關資訊。

發車時刻表

圖 4:發車時刻表

下表列出每個圖說編號,以及在動態饋給中對應的欄位。

編號

對應的欄位類型

1 stop_name City Center
2 route_type 如圖示所示。
3 route_short_name or route_long_name (route_short_name overrides route_long_name, if given in the feed) 路線簡稱:
  • L2
  • T2
  • T4
  • T8

行程搜尋結果

在以下螢幕截圖中,您可以看到 Google 地圖行動應用程式如何顯示路線類型、路線顏色、路線文字顏色、路線簡稱和全名的相關資訊。

行程搜尋

圖 5:行程搜尋

下表列出每個圖說編號,以及在動態饋給中對應的欄位。

編號

對應欄位

1 route_type 如圖示所示。
2
  • 使用 route_color 的背景顏色。
  • 使用 route_text_color. 的文字顏色。
  • route_short_nameroute_long_name
  • (動態饋給如有提供 route_short_name,即會覆寫 route_long_name)
  • 8FD24E
  • 000000
  • 31

行程指示頁面

在以下螢幕截圖中,您可以看到 Google 地圖行動應用程式如何顯示路線簡稱和全名的相關資訊。

行程指示

圖 6:行程指示

下表列出每個圖說編號,以及在動態饋給中對應的欄位。

編號

對應欄位

1
  • route_short_name or route_long_name
  • (route_short_name overrides route_long_name, if given in the feed)
East Line

停靠站圖層

如要顯示交通工具類型,請使用 routes.txt 中的 route_type 欄位。Google 地圖的停靠站圖層會顯示交通工具類型資訊。

以下螢幕截圖是 Google 地圖行動應用程式中的幾個範例。

停靠站圖層

圖 7:停靠站圖層

下表列出每個圖說編號,以及在動態饋給中對應的欄位。

編號

欄位

1 route_type=2 這個交通工具類型為鐵路。 火車圖示
2 route_type=5 這個交通工具類型為纜道電車。 電車圖示
3 route_type=3 這個交通工具類型為公車。 公車圖示

範例

以下是地鐵路線和公車路線的兩個範例。

視為一整組服務的兩條地鐵路線

下表是圖 1 所示地鐵路線的範例。

檔案名稱:routes.txt

route_id

agency_id

route_short_name

route_long_name

route_type

route_color

route_text_color

subway_north_south abc_transit 南北線 天南地北線 1 FF9900 000000

兩條略有不同的公車路線

下表是圖 3 所示公車路線的範例。

檔案名稱:routes.txt

route_id

agency_id

route_short_name

route_long_name

route_type

route_color

route_text_color

def_bus_100 def_transit 100 3 FF0000 434343
def_bus_100A def_transit 100A 3 00FF00 434343