ルート、ストップ、トリップ¶
ルート¶
ルートは、交通ネットワークの地理的な範囲を示すもので、固定ルート輸送の中核をなすものです。GTFS では、路線を定義することが、交通機関の運営を記述するための最初のステップとなる。
最初のステップは、以下のファイルagency.txtに示されるように、代理店情報を追加することです。このファイルには、代理店に関するハイレベルな情報が含まれています。
agency_id,agency_name,agency_url,agency_timezone,agency_lang,agency_phone
CT,Calgary Transit,http://www.calgarytransit.com,America/Edmonton,,403-262-1000
Calgary Transitは、AB州カルガリーでLRT、BRT、通常のバスサービス、パラトランジット、オンデマンド輸送を運営しています。この例では、2つのルートが定義されています。1つ目はバスで、2つ目はLRTです。routes.txtというファイルを使って、各ルートに一意のID、短い名前、そして人間が読みやすいように長い名前を割り当てています。
agency_id,route_id,route_short_name,route_long_name,route_type,route_url,route_color,route_text_color
CT,303-20670,303,MAX Orange Brentwood/Saddletowne,3,www.calgarytransit.com/content/transit/en/home/rider-information/max.html,#ff8000,#ffffff
CT,202-20666,202,Blue Line - Saddletowne/69 Street CTrain,0,www.calgarytransit.com/content/transit/en/home/rider-information/lrt-and-bus-station-maps.html,#ff0000,#ffffff
5番目のフィールド(route_type
)は、路線の種類を区別するために使用される。
- 1番目はバスなので、
route_type=3
- 2つ目はLRTであるため、
route_type=0
となる。 route_type
の値の完全なリストは、routes.txtあります。
残りのフィールドには、路線に固有のURLや、地図上でサービスを表現するための機関固有の色などの追加情報が含まれる。
停留所¶
GTFSでは、stops.txtというファイルを使って、バス停や駅を記述します。以下、1レコード目にバス停を、2レコード目にLRT駅を定義します。
stop_id,stop_code,stop_name,stop_lat,stop_lon,location_type
8157,8157,44th Avenue NE (SB),51.091106,-113.958565,0
6810,6810,NB Marlborough CTrain Station,51.058990,-113.981582,1
stop_id
は一意な識別子である.stop_code
stop_name
、とは通常、ライダー向けの情報を含みます。- 正確な位置は、座標 (
stop_lat
とstop_lon
) を使用して提供されます。 - 6番目のフィールド (
location_type
)は、停留所と駅を区別するために使用される。 - 最初のレコードはバス停に対応するため、
location_type=0
となる。 - 2番目のレコードは駅に対応し、
location_type=1
である。 location_type
の値の完全なリストは、stops.txt見つけることができる。
トリップ¶
経路を記述した後、各経路が提供するトリップを記述することができる。
まず、calendar.txtを使用して、サービスのスパンを定義する必要があります。
service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date
weekend_service,0,0,0,0,0,1,1,20220623,20220903
ここでは、土日のみ運行するサービスを記述しているので、これらの日のフィールドには1が、残りの日のフィールドには0が入力されています。このサービスは、start_date
end_date
とのフィールドにあるように、2022年6月23日から2022年9月3日まで運行されます。
この例では、trips.txtファイルに、上記で説明した MAX Orange ルートが提供する 3 つの週末トリップが記述されています。
route_id,service_id,trip_id,trip_headsign,direction_id,shape_id
303-20670,weekend_service,60270564,"MAX ORANGE SADDLETOWNE",0,3030026
303-20670,weekend_service,60270565,"MAX ORANGE BRENTWOOD",1,3030027
303-20670,weekend_service,60270566,"MAX ORANGE BRENTWOOD",1,3030027
- routes.txtのうち、MAX Orange に対応する
route_id
が記載されています。 - calendar.txt のうち、週末に該当する
service_id
が記載されています。 -
各レコードには、各旅行に対して一意のID ヘッドサインのテキストは、バスの内部と外部の標識に通常表示されるもので、提供されます。
-
direction_id
フィールドは、同じルートで異なる方向に向かうトリップを区別することができます。例えば、インバウンドのトリップとアウトバウンドのトリップ、あるいは南行きのトリップと北行きのトリップを区別することができます。 - この場合、Saddletowne方面のトリップは
direction_id=0
、Brentwood方面のトリップはdirection_id=1
です。direction_id の値には固有の意味はなく、ある進行方向と別の進行方向を指定するために使用されるだけである。 - shapes.txtから、Saddletowne方面のMAX Orangeルートに対応する
shape_id
が1レコード目に、Brentwood方面のMAX Orangeルートに対応するものが2レコード目と3レコード目に記載されている
shape_id=3030026
は、Saddletowne 方面の MAX Orange に対応する。以下のファイルには、ルートの輪郭となる点と、その点間の距離の情報が含まれています。この情報を使って、旅行計画や分析のために地図上にルートをプロットすることが可能です。
shape_id,shape_pt_lat,shape_pt_lon,shape_pt_sequence,shape_dist_traveled
3030026,51.086506,-114.132259,10001,0.000
3030026,51.086558,-114.132371,10002,0.010
3030026,51.086781,-114.132865,10003,0.052
3030026,51.086938,-114.133179,10004,0.080
3030026,51.086953,-114.133205,10005,0.083
3030026,51.086968,-114.133224,10006,0.085
3030026,51.086992,-114.133249,10007,0.088
3030026,51.087029,-114.133275,10008,0.093
3030026,51.087057,-114.133286,10009,0.096
3030026,51.087278,-114.133356,10010,0.121
3030026,51.087036,-114.132864,10011,0.165
3030026,51.086990,-114.132766,10012,0.173
3030026,51.086937,-114.132663,10013,0.183
サービス例外¶
運行日の追加(特別日)や運行日の削除(休日運休など)を設定することができます。
例えば、2022年7月17日(日)に予定されているサービスがない場合、サービスを2つに分けることで、calendar.txt weekend_service
のからその日付を削除することができます。
サービス | 開始 | 終了 |
---|---|---|
weekend_service1 |
20220623 |
20220716 |
weekend_service2 |
20220718 |
20220903 |
しかし、service_id
が2つに分割され、この分割がtrips.txtに連鎖してしまうため、ファイルが複雑になってしまいます。代わりに、以下のようにcalendar_dates.txtを使用することで、より簡単な方法でこれを行うことができます。
service_id,date,exception_type
weekend_service,20220623,2
service_id
weekend_service
となる。date
下に削除または追加されたサービスの日付が表示されます(2022年7月17日)。exception_type
フィールドが2に設定されており、この日のサービスが削除されたことを意味します。