ゾーンベース運賃¶
主なファイル: fare_leg_rules.txt, areas.txt, stop_areas.txt
例: Translink (バンクーバー)
リマインダー
ゾーンベース運賃は、特定のゾーンから別のゾーンへ移動する際に特定の運賃が適用される、ゾーンベースの運賃体系を表現するために使用されます。ゾーンは、エリアまたは停留所等(stop)のグループによって定義されます。詳細については、イントロダクションページの機能セクションを参照してください。
Note
このセクションには、非接触型運賃(Contactless fares)の例のみが含まれています。他のチケットメディア(fare media)タイプをサポートする場合は、該当する fare_products.txt の行を複製し、金額および fare_media_id フィールドを適宜更新してください。
ゾーンの定義¶
ゾーン制運賃で運行されるルート・路線系統(route)の場合、そのルートが停車する各停留所等(stop)は、いずれかのゾーンに属しています。ゾーンは areas.txt に次のように作成します。
- area_id にゾーンの一意の識別子を入力します。
- area_name にゾーンの名称を入力します。
ゾーンに関する詳細は、ドキュメントを参照してください。
補足
Translink では、バスは均一運賃制を採用していますが、SkyTrain と SeaBus はゾーン制運賃を採用しています。各停留所等(stop)は、3つのゾーンのいずれかに割り当てられています：ZN1、ZN2、ZN3。
- 1ゾーン運賃は、同一ゾーン内の乗車区間(leg)に適用されます（ZN1→ZN1、ZN2→ZN2、ZN3→ZN3）
- 2ゾーン運賃は、2つのゾーンをまたぐ乗車区間(leg)に適用されます（ZN1→ZN2、ZN2→ZN3）
- 3ゾーン運賃は、3つすべてのゾーンをまたぐ乗車区間(leg)に適用されます（ZN1→ZN3、ZN2を経由）
さらに、ZN2 内には「Sea Island」と呼ばれる追加のゾーンがあり、バンクーバー国際空港 (YVR)、Sea Island Centre、Templeton 駅が含まれます。
- Sea Island から出発する旅程(journey)は、ZN2 から出発する旅程に比べて CAD 5.00 の追加料金がかかります。
- Sea Island で終了する旅程は、ZN2 で終了する旅程と同じ料金が適用されます。Sea Island 内のみで完結する旅程は無料です。
この例では、4つのエリアが作成されます。各ゾーンごとに1つずつ、さらに Sea Island 用に1つ追加されます。各ゾーンには一意の識別子（ZN1、ZN2、ZN3、sea_island）と、それぞれの名称が area_name に設定されます。
| area_id | area_name |
|---|---|
| ZN1 | Zone 1 - Vancouver |
| ZN2 | Zone 2 - Burnaby, Richmond and North Vancouver |
| ZN3 | Zone 3 - Surrey and Coquitlam |
| sea_island | Sea Island (Vancouver Airport YVR Airport, Sea Island Centre, Templeton) |
停留所(stop)をゾーンに割り当てる¶
stops.txt に含まれる各停留所(stop)は、それを含むゾーンに割り当てる必要があります。停留所(stop)は、stop_areas.txt 内で次のようにゾーンと関連付けられます。
- stop_id に
stops.txtの停留所(stop)の ID を入力します。 - area_id に
areas.txtのゾーンの ID を入力します。
エリアに関する詳細は、ドキュメントを参照してください。
この例では、Translink のサービスエリア内の各停留所(stop)が ZN1、ZN2、または ZN3 に割り当てられています。Sea Island の停留所(stop)（99901、99902、99903）は、ZN2 と sea_island の両方に存在するため、両方のゾーンに関連付けられています。このセクションの後半では、rule_priority によって sea_island と ZN2 の乗車区間(leg)を区別する方法を説明します。
| stop_id | area_id |
|---|---|
| 8039 | ZN1 |
| 8066 | ZN2 |
| … | … |
| 99901 | ZN2 |
| 99902 | ZN2 |
| 99903 | ZN2 |
| 99901 | sea_island |
| 99902 | sea_island |
| 99903 | sea_island |
以下は、stop_areas.txt に登場する一部の停留所(stop)の stop_id を示す stops.txt の抜粋です。
| stop_id | stop_name |
|---|---|
| 8039 | Waterfront Station @ Platform 2 |
| 8066 | Edmonds Station @ Platform 1 |
| 99901 | YVR-Airport Station @ Canada Line |
| … | … |
チケット商品の作成¶
ルートベース運賃(Route-Based Fares)と同様に、ゾーンベース運賃(Zone-Based Fares)のチケット商品は、fare_products.txt に次のように作成します。
- fare_product_id 列に、チケット商品を識別する一意のIDを入力します。
- fare_product_name 列に、乗客向けのチケット商品の名称を入力します（例：1-Zone Fare、2-Zone Fare、1-Zone Fare Monthly）。
- amount および currency 列に、運賃の金額とその通貨を入力します（通貨コード）。
- fare_media_id 列に、このチケット商品を保存・利用できるチケットメディアを入力します。
- これは
fare_media.txtの fare_media_id を参照する外部キーです（Fare Media）。 - 同一のチケット商品に対して、複数のチケットメディアを異なる価格で関連付けることができます。
- fare_media_id が空の場合、そのチケットメディアは不明であることを意味します。
- これは
チケット商品に関する詳細は、ドキュメントを参照してください。
この例では、fare_products.txt にゾーンベース運賃ごとのチケット商品を作成しています。
- 1ゾーン運賃：CAD 3.20（旅程が1つのゾーン内で完結する場合）
- 2ゾーン運賃：CAD 4.65（旅程が1つのゾーンから別のゾーンにまたがる場合）
- 3ゾーン運賃：CAD 6.35（旅程がゾーン1からゾーン2（またはSea Island）を経てゾーン3に至る場合）
- 1ゾーンSea Island運賃：CAD 8.20（CAD 5.00 + CAD 3.20）（Sea Islandからゾーン2への旅程）
- 2ゾーンSea Island運賃：CAD 9.65（CAD 5.00 + CAD 4.65）（Sea Islandからゾーン1またはゾーン3への旅程）
- Sea Island内で開始・終了する旅程：CAD 0
| fare_product_id | fare_product_name | amount | currency | fare_media_id |
|---|---|---|---|---|
| bus_flat_fare | Bus Flat Fare | 3.20 | CAD | contactless |
| 1_zone_fare | 1-Zone Fare | 3.20 | CAD | contactless |
| 2_zone_fare | 2-Zone Fare | 4.65 | CAD | contactless |
| 3_zone_fare | 3-Zone Fare | 6.35 | CAD | contactless |
| sea_island_1_zone_fare | Sea Island travel + 1-zone Fare | 8.20 | CAD | contactless |
| sea_island_2_zone_fare | Sea Island travel + 2-zone fare | 9.65 | CAD | contactless |
| sea_island_sea_island_fare | Free fare inside Sea Island | 0 | CAD | contactless |
ルートをグループ化するネットワークを作成する¶
ゾーン制運賃(Zone-Based Fares)の場合、同じ運賃体系を持つルートをネットワークとしてグループ化する必要があります。
ネットワークは networks.txt に次のように作成します。
- network_id 列に、ネットワークを識別する一意のIDを入力します。
- network_name 列に、ネットワークの名称を入力します（例: Translink Buses、TTC Subway、STM All Routes）。
ネットワークの詳細については、ドキュメントを参照してください。
Translink の場合、バスは以前、均一運賃体系を持つため、独自のネットワークに分けられていました（ルート制運賃(Route-Based Fares) のセクションを参照）。同様に、SkyTrain と Seabus は、通過ゾーン数に応じて運賃が変わるため、1つのネットワークにグループ化されます。skytrain_seabus という network_id が作成されます。
| network_id | network_name |
|---|---|
| skytrain_seabus | SkyTrain and SeaBus |
ルートをネットワークに関連付ける¶
ネットワークを作成した後は、そのネットワークに含まれるルートを関連付ける必要があります。ルートは、次のように route_networks.txt 内でネットワークに関連付けられます。
- route_id 列に、
routes.txtに記載されているルートの ID を入力します。 - network_id 列に、対応するネットワークの
networks.txtに記載されている ID を入力します。
ルートネットワークの詳細については、ドキュメントを参照してください。
この例では、SkyTrain の各ルート（Canada Line、Millennium Line、Expo Line）および SeaBus の route_id が、route_networks.txt 内で network_id skytrain_seabus に関連付けられています。以下のスナップショットでは、13686 は Canada Line の route_id、30052 は Millennium Line の route_id です。
| route_id | network_id |
|---|---|
| 13686 | skytrain_seabus |
| 30052 | skytrain_seabus |
| … | … |
運賃区間ルール(fare leg rules)の作成¶
リマインダー
乗車区間(Leg): 特定のサービスまたはルート上で、2つの停留所間を乗り換えなしで移動する、旅程の単一の連続した区間です。
乗車区間グループ(Leg Group): fare_leg_rules.txt ファイルの文脈で定義される、特定の共通属性または運賃条件を共有する1つ以上の乗車区間の集合です。
乗車区間の運賃は、運賃区間ルールを使用して乗車区間をチケット商品に照合することで決定されます。ゾーンベース運賃(Zone-Based Fares)の場合、運賃区間ルールは、ゾーン間（areas.txt で定義）を運行するルートのネットワーク（networks.txt で作成）を、チケット商品（fare_products.txt で作成）に関連付けます。
ゾーンベースの運賃区間ルールは、次のように fare_leg_rules.txt に作成します。
- leg_group_id 列に、乗車区間グループを識別する一意のIDを入力します。
- network_id 列に、乗車区間に含まれるルートが属するネットワークのIDを入力します。
- これは
networks.txtの network_id を参照する外部キーです。
- これは
- from_area_id に、乗車区間の出発ゾーンのIDを入力します。
- to_area_id に、乗車区間の到着ゾーンのIDを入力します。
- fare_product_id 列に、乗車区間の運賃を決定するチケット商品のIDを入力します。
- これは
fare_products.txtの fare_product_id を参照する外部キーです。
- これは
運賃区間ルールの詳細については、ドキュメントを参照してください。
この例では、各ゾーンの組み合わせごとに複数の乗車区間グループが追加されています。たとえば、ZN1_ZN1 は from_area_id=ZN1 かつ to_area_id=ZN1 であるため、ゾーン1内にとどまる乗車区間を表します。ZN1_ZN1 は fare_product_id=1_zone_fare に関連付けられています。
以下の例では、ZN1_ZN2 が2回記載されていることに注意してください。最初は (from_area_id=ZN1, to_area_id=ZN2) に関連付けられ、次に (from_area_id=ZN2, to_area_id=ZN1) に関連付けられています。これは、ZN1_ZN2 が ZN1 と ZN2 間の両方向の移動に対応する運賃ルールを持つ乗車区間グループを表していることを意味します。
Note
以下の例には Sea Island の乗車区間ルールは含まれていません。これについては次のステップで説明します。
| leg_group_id | network_id | fare_product_id | from_area_id | to_area_id |
|---|---|---|---|---|
| … | … | … | ||
| ZN1_ZN1 | skytrain_seabus | 1_zone_fare | ZN1 | ZN1 |
| ZN2_ZN2 | skytrain_seabus | 1_zone_fare | ZN2 | ZN2 |
| ZN3_ZN3 | skytrain_seabus | 1_zone_fare | ZN3 | ZN3 |
| ZN1_ZN2 | skytrain_seabus | 2_zone_fare | ZN1 | ZN2 |
| ZN1_ZN2 | skytrain_seabus | 2_zone_fare | ZN2 | ZN1 |
| ZN2_ZN3 | skytrain_seabus | 2_zone_fare | ZN2 | ZN3 |
| ZN2_ZN3 | skytrain_seabus | 2_zone_fare | ZN3 | ZN2 |
| ZN1_ZN3 | skytrain_seabus | 3_zone_fare | ZN1 | ZN3 |
| ZN1_ZN3 | skytrain_seabus | 3_zone_fare | ZN3 | ZN1 |
重複するゾーンの優先順位付け¶
場合によっては、複数のゾーンが同じ停留所(stop)を共有することがあります。これにより、乗車区間(leg)に運賃区間ルール(fare leg rule)を適用する際に、どのゾーンを使用すべきか曖昧になることがあります。この問題を解決するために、fare_leg_rules.txt の rule_priority フィールドが使用されます。これは、一致するルールが適用される順序を決定します。同じ条件に一致するルールの集合において、rule_priority の値が高いルールが、値が低いまたは空のルールよりも優先されます。
これは fare_leg_rules.txt において次のように行われます。
- 前の手順の指示に従って、すべての可能な運賃区間ルールを作成します。
- rule_priority に乗車区間(leg)の優先順位を入力します。rule_priority の値が高いほど、その運賃区間ルールの優先度が高くなります。
運賃区間ルールの詳細については、ドキュメントを参照してください。
この例では、Sea Island が Zone 2 内に存在するため、乗車区間が Sea Island から Zone 2 に始まる場合、それは「Sea Island から Zone 2」区間なのか、「Zone 2 から Zone 2」区間なのか、あるいは「Sea Island から Sea Island」区間なのかという曖昧さが生じます。実際には、この乗車区間は3つすべての可能性に一致し、曖昧さを引き起こします。
まず、Sea Island から始まる乗車区間を追加します。
sea_island_ZN1およびsea_island_ZN3の乗車区間はいずれも CAD 5.00 + 2ゾーン運賃です。sea_island_ZN2の乗車区間は CAD 5.00 + 1ゾーン運賃です。sea_island_sea_islandの乗車区間は無料です。
次に、rule_priority に適切な値を入力します。
sea_island_sea_islandは最も高い優先度を持ちます（rule_priority=2）。これにより、乗車区間の出発停留所(stop)と到着停留所(stop)がどちらもsea_island（Zone 2 内）にある場合、優先される乗車区間はsea_island_sea_islandになります。- Sea Island から他の場所（Zone 1、Zone 3、または Sea Island 外の Zone 2）に向かう乗車区間は
rule_priority=1です。 - 残りの乗車区間は最も低い優先度を持ち、
rule_priority=0（または空）です。
| leg_group_id | network_id | fare_product_id | from_area_id | to_area_id | rule_priority |
|---|---|---|---|---|---|
| … | … | … | |||
| sea_island_ZN1 | skytrain_seabus | sea_island_2_zone_fare | sea_island | ZN1 | 1 |
| sea_island_ZN2 | skytrain_seabus | sea_island_1_zone_fare | sea_island | ZN2 | 1 |
| sea_island_ZN3 | skytrain_seabus | sea_island_2_zone_fare | sea_island | ZN3 | 1 |
| sea_island_sea_island | skytrain_seabus | sea_island_sea_island_fare | sea_island | sea_island | 2 |
| ZN1_ZN1 | skytrain_seabus | 1_zone_fare | ZN1 | ZN1 | |
| ZN2_ZN2 | skytrain_seabus | 1_zone_fare | ZN2 | ZN2 | |
| ZN3_ZN3 | skytrain_seabus | 1_zone_fare | ZN3 | ZN3 | |
| ZN1_ZN2 | skytrain_seabus | 2_zone_fare | ZN1 | ZN2 | |
| ZN1_ZN2 | skytrain_seabus | 2_zone_fare | ZN2 | ZN1 | |
| ZN2_ZN3 | skytrain_seabus | 2_zone_fare | ZN2 | ZN3 | |
| ZN2_ZN3 | skytrain_seabus | 2_zone_fare | ZN3 | ZN2 | |
| ZN1_ZN3 | skytrain_seabus | 3_zone_fare | ZN1 | ZN3 | |
| ZN1_ZN3 | skytrain_seabus | 3_zone_fare | ZN3 | ZN1 |