リファレンス
General Transit Feed Specification リファレンス¶
2026年4月27日改訂。詳細については改訂履歴を参照してください。
この文書は、GTFSデータセットを構成するファイルの形式および構造を定義します。
目次¶
- 文書の規約
- データセットファイル
- ファイル要件
- データセットの公開および一般的な慣行
- フィールド定義
- agency.txt
- stops.txt
- routes.txt
- trips.txt
- stop_times.txt
- calendar.txt
- calendar_dates.txt
- fare_attributes.txt
- fare_rules.txt
- timeframes.txt
- rider_categories.txt
- fare_media.txt
- fare_products.txt
- fare_leg_rules.txt
- fare_leg_join_rules.txt
- fare_transfer_rules.txt
- areas.txt
- stop_areas.txt
- networks.txt
- route_networks.txt
- shapes.txt
- frequencies.txt
- transfers.txt
- pathways.txt
- levels.txt
- location_groups.txt
- location_group_stops.txt
- locations.geojson
- booking_rules.txt
- translations.txt
- feed_info.txt
- attributions.txt
文書の規約¶
この文書におけるキーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「MAY」、および「OPTIONAL」は、RFC 2119 に記載されているとおりに解釈しなければなりません。
用語の定義¶
このセクションでは、この文書全体で使用される用語を定義します。
- データセット - この仕様リファレンスで定義される完全なファイル一式です。データセットを変更すると、データセットの新しいバージョンが作成されます。データセットは、zipファイル名を含む公開かつ恒久的なURLで公開するべきです。(例: https://www.agency.org/gtfs/gtfs.zip)。
- レコード - 単一のエンティティ(例: 交通事業者、停留所等(stop)、ルート・路線系統(route)など)を記述する、複数の異なるフィールド値で構成される基本的なデータ構造です。表では、行として表現されます。
- フィールド - オブジェクトまたはエンティティの属性です。表では、列として表現されます。フィールドは、ファイル内でヘッダーとして追加されている場合に存在します。フィールド値が定義されている場合も、定義されていない場合もあります。
- フィールド値 - フィールド内の個々のエントリです。表では、単一のセルとして表現されます。
- 運行日(service day) - 運行日は、ルート・路線系統(route)のスケジュールを示すために使用される期間です。運行日の正確な定義は事業者ごとに異なりますが、運行日は多くの場合、暦日とは一致しません。ある日に運行が開始され、翌日に終了する場合、運行日は24:00:00を超えることがあります。例えば、金曜日の08:00:00から土曜日の02:00:00まで運行するサービスは、単一の運行日において08:00:00から26:00:00まで運行すると表記することができます。
- 読み上げ用フィールド(text-to-speech field) - このフィールドには、その親フィールドと同じ情報を含めるべきです(空の場合は親フィールドにフォールバックします)。これはtext-to-speechとして読み上げられることを目的としているため、略語は削除するべきです(「St」は「Street」または「Saint」として読み上げるべきです。「Elizabeth I」は「Elizabeth the first」とするべきです)。または、そのまま読み上げられるように保持するべきです(「JFK Airport」は略称として発音されます)。
- 乗車区間(leg) - 乗客が便(trip)に沿った連続する一対の地点の間で乗車し、降車する移動です。
- 旅程(journey) - 出発地から目的地までの全体的な移動であり、すべての乗車区間(leg)およびその間の乗換を含みます。
- 部分旅程(sub-journey) - 旅程(journey)の部分集合を構成する、2つ以上の乗車区間(leg)です。
- チケット商品 - 移動の支払いまたは検証に使用できる、購入可能な運賃商品です。
- 有効運賃区間(effective fare leg) - 運賃計算の目的で、fare_leg_rules.txt の照合ルールにおいて単一の乗車区間(leg)として扱うべき、2つ以上の乗車区間(leg)からなる部分旅程(sub-journey)です。
存在¶
フィールドおよびファイルに適用される存在条件:
- 必須 - フィールドまたはファイルはデータセットに含まれ、各レコードに対して有効な値を含まなければなりません。
- 任意 - フィールドまたはファイルはデータセットから省略することができます。
- 条件付き必須 - フィールドまたはファイルは、フィールドまたはファイルの説明に示された条件下で含まれなければなりません。
- 条件付き禁止 - フィールドまたはファイルは、フィールドまたはファイルの説明に示された条件下で含まれてはいけません。
- 推奨 - フィールドまたはファイルはデータセットから省略することができますが、含めることがベストプラクティスです。このフィールドまたはファイルを省略する前に、ベストプラクティスを慎重に評価し、省略による影響を十分に理解するべきです。
フィールド型¶
- Color - 6桁の16進数としてエンコードされた色です。有効な値を生成するには、https://htmlcolorcodes.comを参照してください(先頭の「#」は含めてはいけません)。
例: 白の場合はFFFFFF、黒の場合は000000、NYMTAのA、C、E路線の場合は0039A6。 - Currency code - ISO 4217のアルファベット通貨コードです。現在の通貨の一覧については、https://en.wikipedia.org/wiki/ISO_4217#Active_codesを参照してください。
例: カナダドルの場合はCAD、ユーロの場合はEUR、日本円の場合はJPY。 - Currency amount - 通貨額を示す10進数値です。小数点以下の桁数は、対応するCurrency codeについてISO 4217で指定されています。すべての金融計算は、データを利用するプログラミング言語に応じて、decimal、currency、または金融計算に適した他の同等の型として処理するべきです。計算中に金額の増減が発生するため、通貨額をfloatとして処理することは推奨されません。
- Date - YYYYMMDD形式の運行日(service day)です。運行日(service day)内の時刻は24:00:00を超える場合があるため、運行日(service day)には翌日以降の情報が含まれる場合があります。
例: 2018年9月13日の場合は20180913。 - Email - メールアドレスです。
例:example@example.com - Enum - 「Description」列で定義された事前定義済み定数の集合からの選択肢です。
例:route_typeフィールドには、路面電車の場合は0、地下鉄の場合は1が含まれます... - ID - IDフィールド値は、乗客に表示することを意図しない内部IDであり、任意のUTF-8文字の連続です。表示可能なASCII文字のみを使用することが推奨されます。ファイル内で一意でなければならないIDは「unique ID」と表記されます。1つの.txtファイルで定義されたIDは、別の.txtファイルで参照されることがよくあります。別のテーブル内のIDを参照するIDは「foreign ID」と表記されます。
例: stops.txtのstop_idフィールドは「unique ID」です。stops.txtのparent_stationフィールドは「stops.stop_idを参照するforeign ID」です。 - Language code - IETF BCP 47言語コードです。IETF BCP 47の概要については、http://www.rfc-editor.org/rfc/bcp/bcp47.txtおよびhttps://www.w3.org/International/articles/language-tags/を参照してください。
例: 英語の場合はen、アメリカ英語の場合はen-US、ドイツ語の場合はde。 - Latitude - 10進度によるWGS84緯度です。値は-90.0以上90.0以下でなければなりません。
例: ローマのコロッセオの場合は41.890169。 - Longitude - 10進度によるWGS84経度です。値は-180.0以上180.0以下でなければなりません。
例: ローマのコロッセオの場合は12.492269。 - Float - 浮動小数点数です。
- Integer - 整数です。
- Phone number - 電話番号です。
- Time - HH:MM:SS形式の時刻です(H:MM:SSも受け入れられます)。時刻は、運行日(service day)の「正午から12時間前」から測定されます(夏時間の変更が発生する日を除き、実質的には午前0時です)。運行日の午前0時以降に発生する時刻については、HH:MM:SS形式で24:00:00より大きい値として時刻を入力してください。
例: 午後2時30分の場合は14:30:00、翌日の午前1時35分の場合は25:35:00。 - Local time - HH:MM:SS形式の時刻です(H:MM:SSも受け入れられます)。指定された場所の現地時刻で表示される時計時刻を表します。
- Text - 表示を目的とし、そのため人間が読めるものでなければならないUTF-8文字列です。
- Timezone - https://www.iana.org/time-zonesのTZタイムゾーンです。タイムゾーン名にはスペース文字は決して含まれませんが、アンダースコアを含む場合があります。有効な値の一覧については、http://en.wikipedia.org/wiki/List_of_tz_zonesを参照してください。
例:Asia/Tokyo、America/Los_Angeles、またはAfrica/Cairo。 - URL - http://またはhttps://を含む完全修飾URLであり、URL内の特殊文字は正しくエスケープされていなければなりません。完全修飾URL値の作成方法については、次のhttp://www.w3.org/Addressing/URL/4_URI_Recommentations.htmlを参照してください。
フィールド記号¶
Float または Integer フィールド型に適用される記号:
- 非負 - 0 以上です。
- 非ゼロ - 0 と等しくありません。
- 正 - 0 より大きいです。
例: 非負の float - 0 以上の浮動小数点数です。
データセット属性¶
データセットの主キーは、行を一意に識別するフィールド、またはフィールドの組み合わせです。Primary key (*) は、ファイルに提供されるすべてのフィールドを使用して行を一意に識別する場合に使用されます。Primary key (none) は、そのファイルで許可される行が1行のみであることを意味します。
例: trip_id および stop_sequence フィールドは、stop_times.txt の主キーを構成します。
データセットファイル¶
この仕様では、以下のファイルを定義します。
| ファイル名 | 存在要件 | 説明 |
|---|---|---|
| agency.txt | 必須 | このデータセットでサービスが表現される交通事業者。 |
| stops.txt | 条件付き必須 | 車両が乗客を乗車または降車させる停留所等(stop)。駅および駅入口も定義します。 条件付き必須: - デマンド型サービスのゾーンが locations.geojson で定義されている場合は任意。 - それ以外の場合は必須。 |
| routes.txt | 必須 | 交通ルート・路線系統(route)。ルート・路線系統(route)は、乗客に単一のサービスとして表示される便(trip)のグループです。 |
| trips.txt | 必須 | 各ルート・路線系統(route)の便(trip)。便(trip)は、特定の期間中に発生する2つ以上の停留所等(stop)の連続です。 |
| stop_times.txt | 必須 | 各便(trip)について、車両が停留所等(stop)に到着および出発する時刻。 |
| calendar.txt | 条件付き必須 | 開始日および終了日を伴う週間スケジュールを使用して指定される運行日。 条件付き必須: - すべての運行日が calendar_dates.txt で定義されている場合を除き、必須。 - それ以外の場合は任意。 |
| calendar_dates.txt | 条件付き必須 | calendar.txt で定義されたサービスの例外。 条件付き必須: - calendar.txt が省略される場合は必須。この場合、calendar_dates.txt にはすべての運行日を含めなければなりません。 - それ以外の場合は任意。 |
| fare_attributes.txt | 任意 | 交通事業者のルート・路線系統(route)に関する運賃情報。 |
| fare_rules.txt | 任意 | 旅程に運賃を適用するためのルール。 |
| timeframes.txt | 任意 | 日付および時刻の要因に依存する運賃について、運賃ルールで使用する日付および時刻の期間。 |
| rider_categories.txt | 任意 | 乗客のカテゴリ(例: 高齢者、学生)を定義します。 |
| fare_media.txt | 任意 | チケット商品を利用するために使用できるチケットメディアを記述します。 ファイル fare_media.txt は、fare_attributes.txt および fare_rules.txt では表現されない概念を記述します。そのため、fare_media.txt の使用は、ファイル fare_attributes.txt および fare_rules.txt とは完全に独立しています。 |
| fare_products.txt | 任意 | 乗客が購入できるさまざまな種類のチケットまたは運賃を記述します。 ファイル fare_products.txt は、fare_attributes.txt および fare_rules.txt では表現されないチケット商品を記述します。そのため、fare_products.txt の使用は、ファイル fare_attributes.txt および fare_rules.txt とは完全に独立しています。 |
| fare_leg_rules.txt | 任意 | 個々の乗車区間(leg)に対する運賃ルール。 ファイル fare_leg_rules.txt は、運賃体系をモデル化するためのより詳細な方法を提供します。そのため、fare_leg_rules.txt の使用は、ファイル fare_attributes.txt および fare_rules.txt とは完全に独立しています。 |
| fare_leg_join_rules.txt | 任意 | fare_leg_rules.txt のルールとの照合を目的として、2つ以上の乗車区間(leg)を単一の有効運賃区間(effective fare leg)と見なすべきかを定義するルール。 |
| fare_transfer_rules.txt | 任意 | 乗車区間(leg)間の乗換に対する運賃ルール。 fare_leg_rules.txt とともに、ファイル fare_transfer_rules.txt は、運賃体系をモデル化するためのより詳細な方法を提供します。そのため、fare_transfer_rules.txt の使用は、ファイル fare_attributes.txt および fare_rules.txt とは完全に独立しています。 |
| areas.txt | 任意 | 場所のエリアグループ。 |
| stop_areas.txt | 任意 | 停留所等(stop)をエリアに割り当てるためのルール。 |
| networks.txt | 条件付き禁止 | ルート・路線系統(route)のネットワークグループ。 条件付き禁止: - routes.txt に network_id が存在する場合は禁止。- それ以外の場合は任意。 |
| route_networks.txt | 条件付き禁止 | ルート・路線系統(route)をネットワークに割り当てるためのルール。 条件付き禁止: - routes.txt に network_id が存在する場合は禁止。- それ以外の場合は任意。 |
| shapes.txt | 任意 | 車両の走行経路をマッピングするためのルール。ルートアラインメントと呼ばれることもあります。 |
| frequencies.txt | 任意 | 間隔ベースのサービスにおける運行間隔(便(trip)間の時間)、または固定スケジュールサービスの圧縮表現。 |
| transfers.txt | 任意 | ルート・路線系統(route)間の乗換地点において接続を行うためのルール。 |
| pathways.txt | 任意 | 駅構内の場所を相互に接続する構内通路(pathway)。 |
| levels.txt | 条件付き必須 | 駅構内の階層。 条件付き必須: - エレベーターを伴う構内通路(pathway)( pathway_mode=5)を記述する場合は必須。- それ以外の場合は任意。 |
| location_groups.txt | 任意 | 乗客が乗車または降車をリクエストできる場所をまとめて示す停留所等(stop)のグループ。 |
| location_group_stops.txt | 任意 | 停留所等(stop)をロケーショングループに割り当てるためのルール。 |
| locations.geojson | 任意 | オンデマンドサービスによる乗客の乗車または降車リクエストのためのゾーン。GeoJSONポリゴンとして表現されます。 |
| booking_rules.txt | 任意 | 乗客がリクエストするサービスの予約情報。 |
| translations.txt | 任意 | 顧客向けデータセット値の翻訳。 |
| feed_info.txt | 条件付き必須 | 発行者、バージョン、有効期限情報を含むデータセットメタデータ。 条件付き必須: - translations.txt が提供される場合は必須。 - それ以外の場合は推奨。 |
| attributions.txt | 任意 | データセットの帰属情報。 |
ファイル要件¶
以下の要件は、データセットファイルの形式および内容に適用されます。
- すべてのファイルは、カンマ区切りのテキストとして保存しなければなりません。
- 各ファイルの先頭行には、フィールド名を含めなければなりません。フィールド定義セクションの各サブセクションは、GTFS データセット内のファイルのいずれか1つに対応しており、そのファイルで使用できるフィールド名を一覧にしています。
- すべてのファイル名およびフィールド名では、大文字と小文字が区別されます。
- フィールド値には、タブ、キャリッジリターン、または改行を含めてはいけません。
- 引用符またはカンマを含むフィールド値は、引用符で囲まなければなりません。さらに、フィールド値内の各引用符の前には、引用符を付けなければなりません。これは、Microsoft Excel がカンマ区切り(CSV)ファイルを出力する方法と一致しています。CSV ファイル形式の詳細については、https://tools.ietf.org/html/rfc4180を参照してください。 以下の例は、フィールド値がカンマ区切りファイル内でどのように表示されるかを示しています。
- 元のフィールド値:
Contains "quotes", commas and text - CSV ファイル内のフィールド値:
"Contains ""quotes"", commas and text" - フィールド値には、HTML タグ、コメント、またはエスケープシーケンスを含めてはいけません。
- フィールドまたはフィールド名の間にある余分なスペースは削除するべきです。多くのパーサーはスペースを値の一部と見なすため、エラーが発生する可能性があります。
- 各行は、CRLF または LF の改行文字で終わらなければなりません。
- すべての Unicode 文字をサポートするため、ファイルは UTF-8 でエンコードするべきです。Unicode byte-order mark(BOM)文字を含むファイルも許容されます。BOM 文字および UTF-8 の詳細については、http://unicode.org/faq/utf_bom.html#BOMを参照してください。
- すべてのデータセットファイルは、まとめて zip 化しなければなりません。ファイルはサブフォルダ内ではなく、ルートレベルに直接配置しなければなりません。
- すべての顧客向けテキスト文字列(停留所等(stop)名、ルート・路線系統(route)名、行先表示(headsign)を含む)は、小文字を表示できるディスプレイ上での地名の大文字表記に関する地域の慣例に従い、Mixed Case(ALL CAPS ではない)を使用するべきです(例: 「Brighton Churchill Square」、「Villiers-sur-Marne」、「Market Street」)。
- 名前およびその他のテキストでは、場所が略称で呼ばれている場合(例: 「JFK Airport」)を除き、フィード全体を通じて略語の使用を避けるべきです(例: Street に対する St.)。略語は、スクリーンリーダーソフトウェアおよび音声ユーザーインターフェースによるアクセシビリティに問題を生じさせる可能性があります。利用側ソフトウェアは、表示用に完全な単語を略語へ確実に変換できるよう設計できますが、略語から完全な単語への変換はエラーのリスクがより高くなります。
データセットの公開と一般的な慣行¶
- データセットは、zipファイル名を含む公開された恒久的なURLで公開するべきです。(例: www.agency.org/gtfs/gtfs.zip)。利用するソフトウェアアプリケーションによるダウンロードを容易にするため、理想的には、ファイルへのアクセスにログインを必要とせず、URLから直接ダウンロードできるべきです。GTFSデータセットを公開ダウンロード可能にすることが推奨されており(また最も一般的な慣行です)、データ提供者がライセンスその他の理由によりGTFSへのアクセスを制御する必要がある場合は、自動ダウンロードを容易にするAPIキーを使用してGTFSデータセットへのアクセスを制御することが推奨されます。
- GTFSデータは、安定した場所にある単一のファイルが常に交通事業者(または複数の事業者)のサービスに関する最新の公式記述を含むよう、反復的に公開するべきです。
- データセットは、可能な限りデータの反復間で
stop_id、route_id、およびagency_idの永続的な識別子(idフィールド)を維持するべきです。 - 1つのGTFSデータセットには、現在および今後のサービス(「マージ済み」データセットと呼ばれることがあります)を含めるべきです。2つの異なるGTFSフィードからマージ済みデータセットを作成するために使用できる、複数のマージツールがあります。
- 公開されるGTFSデータセットは、常に少なくとも今後7日間有効であるべきであり、理想的には、運行事業者がスケジュールの運行継続を確信している期間と同じ長さの期間、有効であるべきです。
- 可能であれば、GTFSデータセットは少なくとも今後30日間のサービスを対象とするべきです。
- 古いサービス(期限切れのcalendar)はフィードから削除するべきです。
- サービスの変更が7日以内に発効する場合、このサービス変更は静的GTFSデータセットではなく、GTFS-realtimeフィード(サービスアドバイザリまたは便の更新(trip update))を通じて表現するべきです。
- GTFSデータをホストするweb-serverは、ファイルの更新日を正しく報告するよう設定するべきです(HTTP/1.1 - Request for Comments 2616、Section 14.29を参照してください)。
フィールド定義¶
agency.txt¶
ファイル: 必須
主キー (agency_id)
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
agency_id |
一意のID | 条件付き必須 | 多くの場合、交通事業者と同義である交通ブランドを識別します。単一の事業者が複数の独立したサービスを運営する場合など、一部のケースでは、事業者とブランドは異なります。この文書では、「brand」の代わりに「agency」という用語を使用します。データセットには複数の事業者のデータを含めることができます。 条件付き必須: - データセットに複数の交通事業者のデータが含まれる場合は必須です。 - それ以外の場合は推奨です。 |
agency_name |
テキスト | 必須 | 交通事業者の正式名称です。 |
agency_url |
URL | 必須 | 交通事業者のURLです。 |
agency_timezone |
タイムゾーン | 必須 | 交通事業者が所在するタイムゾーンです。データセット内で複数の事業者が指定されている場合、それぞれが同じagency_timezoneを持たなければなりません。 |
agency_lang |
言語コード | 任意 | この交通事業者が使用する主要言語です。GTFSコンシューマーがデータセットの大文字・小文字の規則やその他の言語固有の設定を選択するのに役立つため、提供するべきです。 |
agency_phone |
電話番号 | 任意 | 指定された事業者の音声電話番号です。このフィールドは、事業者のサービス提供地域で一般的な形式で電話番号を表す文字列値です。番号の桁をグループ化するための句読点を含めることができます。ダイヤル可能なテキスト(例: TriMetの「503-238-RIDE」)は許可されますが、このフィールドにはその他の説明的なテキストを含めてはいけません。 |
agency_fare_url |
URL | 任意 | 乗客がその事業者のチケットまたはその他の運賃手段を購入できるWebページのURL、またはその事業者の運賃に関する情報を含むWebページのURLです。 |
agency_email |
メール | 任意 | 事業者のカスタマーサービス部門が積極的に監視しているメールアドレスです。このメールアドレスは、交通機関の乗客が事業者のカスタマーサービス担当者に連絡できる直接の連絡先であるべきです。 |
cemv_support |
列挙型 | 任意 | 乗客が、運賃バリデーターにおいて、非接触EMV(Europay、Mastercard、Visa)カードまたはモバイルデバイスをチケットメディアとして使用することで、この事業者に関連付けられた交通サービス(すなわち便(trip))を利用できるかどうかを示します(pay-as-you-goまたはopen-loopシステムなど)。このフィールドは、cEMVを使用して他のチケット商品を購入したり、別のチケットメディアに価値を追加したりできることを示すものではありません。 cEMVのサポートは、この事業者のすべてのサービスが、cEMVカードまたはモバイルデバイスをチケットメディアとして使用して利用可能な場合にのみ示すべきです。 有効な選択肢は次のとおりです。 0または空 - この事業者に関連付けられた便(trip)についてcEMV情報はありません。1 - 乗客は、この事業者に関連付けられた便(trip)でcEMVをチケットメディアとして使用することができます。2 - この事業者に関連付けられた便(trip)では、cEMVはチケットメディアとしてサポートされていません。同じサービスに対して agency.cemv_supportとroutes.cemv_supportの両方が提供される場合、routes.cemv_supportの値が優先されなければなりません。このフィールドは、他のすべての運賃関連ファイルから独立しており、個別に使用することができます。このフィールドと運賃関連ファイル(fare_media.txt、fare_products.txt、またはfare_leg_rules.txtなど)との間に情報の競合がある場合、それらのファイル内の情報が agency.cemv_supportより優先されなければなりません。 |
stops.txt¶
ファイル: 条件付き必須
主キー (stop_id)
| フィールド名 | 型 | 存在要件 | 説明 |
|---|---|---|---|
stop_id |
一意の ID | 必須 | 場所を識別します: 停留所等(stop)/プラットフォーム、駅、出入口、汎用ノード、または乗車エリア(location_type を参照)。ID は、すべての stops.stop_id、locations.geojson の id、および location_groups.location_group_id の値全体で一意でなければなりません。複数のルート・路線系統(route)が同じ stop_id を使用することができます。 |
stop_code |
テキスト | 任意 | 乗客が場所を識別するための短いテキストまたは番号です。これらのコードは、乗客が特定の場所に関する情報を容易に取得できるように、電話ベースの交通情報システムで使用されたり、案内標識に印刷されたりすることがよくあります。stop_code が一般公開される場合、stop_id と同じにすることができます。乗客に提示されるコードがない場所では、このフィールドを空にするべきです。 |
stop_name |
テキスト | 条件付き必須 | 場所の名称です。stop_name は、時刻表に印刷される、オンラインで公開される、または案内標識に表示される、事業者が乗客向けに使用する場所の名称と一致するべきです。他の言語への翻訳には、translations.txt を使用してください。場所が乗車エリア( location_type=4)である場合、stop_name には事業者が表示する乗車エリアの名称を含めるべきです。これは、1文字のみ(欧州の一部の都市間鉄道駅など)である場合もあれば、「Wheelchair boarding area」(NYC の Subway)や「Head of short trains」(Paris の RER)のようなテキストである場合もあります。条件付き必須: - 停留所等(stop)( location_type=0)、駅(location_type=1)、または出入口(location_type=2)である場所では必須です。- 汎用ノード( location_type=3)または乗車エリア(location_type=4)である場所では任意です。 |
tts_stop_name |
テキスト | 任意 | stop_name の読み取り可能なバージョンです。詳細については、用語定義の「読み上げ用フィールド(text-to-speech field)」を参照してください。 |
stop_desc |
テキスト | 任意 | 有用で質の高い情報を提供する場所の説明です。stop_name と重複するべきではありません。 |
stop_lat |
緯度 | 条件付き必須 | 場所の緯度です。 停留所等(stop)/プラットフォーム( location_type=0)および乗車エリア(location_type=4)について、座標は、バス停ポールが存在する場合はその座標、存在しない場合は乗客が車両に乗車する場所の座標でなければなりません(歩道またはプラットフォーム上であり、車両が停車する車道または線路上ではありません)。条件付き必須: - 停留所等(stop)( location_type=0)、駅(location_type=1)、または出入口(location_type=2)である場所では必須です。- 汎用ノード( location_type=3)または乗車エリア(location_type=4)である場所では任意です。 |
stop_lon |
経度 | 条件付き必須 | 場所の経度です。 停留所等(stop)/プラットフォーム( location_type=0)および乗車エリア(location_type=4)について、座標は、バス停ポールが存在する場合はその座標、存在しない場合は乗客が車両に乗車する場所の座標でなければなりません(歩道またはプラットフォーム上であり、車両が停車する車道または線路上ではありません)。条件付き必須: - 停留所等(stop)( location_type=0)、駅(location_type=1)、または出入口(location_type=2)である場所では必須です。- 汎用ノード( location_type=3)または乗車エリア(location_type=4)である場所では任意です。 |
zone_id |
ID | 任意 | 停留所等(stop)の運賃ゾーンを識別します。このレコードが駅または駅の出入口を表す場合、zone_id は無視されます。 |
stop_url |
URL | 任意 | 場所に関する Web ページの URL です。これは agency.agency_url および routes.route_url のフィールド値とは異なるべきです。 |
location_type |
列挙型 | 任意 | 場所の種類です。有効な選択肢は次のとおりです:0(または空) - 停留所等(stop)(またはプラットフォーム)。乗客が交通車両に乗車または降車する場所です。parent_station 内で定義される場合は、プラットフォームと呼ばれます。1 - 駅。1つ以上のプラットフォームを含む物理的な構造物または区域です。2 - 出入口。乗客が道路から駅に入場または駅から退出できる場所です。出入口が複数の駅に属する場合、構内通路(pathway)によって両方にリンクすることができますが、データ提供者はいずれか1つを親として選択しなければなりません。3 - 汎用ノード。駅構内にある場所で、他のいずれの location_type にも該当せず、pathways.txt で定義される構内通路(pathway)を相互にリンクするために使用することができます。4 - 乗車エリア。プラットフォーム上の特定の場所で、乗客が車両に乗車および/または降車できる場所です。 |
parent_station |
stops.stop_id を参照する外部 ID |
条件付き必須 | stops.txt で定義される異なる場所間の階層を定義します。親となる場所の ID を、次のように含みます: - 停留所等(stop)/プラットフォーム( location_type=0): parent_station フィールドには駅の ID を含めます。- 駅( location_type=1): このフィールドは空でなければなりません。- 出入口( location_type=2)または汎用ノード(location_type=3): parent_station フィールドには駅(location_type=1)の ID を含めます。- 乗車エリア( location_type=4): parent_station フィールドにはプラットフォームの ID を含めます。条件付き必須: - 出入口( location_type=2)、汎用ノード(location_type=3)、または乗車エリア(location_type=4)である場所では必須です。- 停留所等(stop)/プラットフォーム( location_type=0)では任意です。- 駅( location_type=1)では禁止です。 |
stop_timezone |
タイムゾーン | 任意 | 場所のタイムゾーンです。場所に親駅がある場合、独自のタイムゾーンを適用する代わりに親駅のタイムゾーンを継承します。stop_timezone が空の駅および親を持たない停留所等(stop)は、agency.agency_timezone で指定されたタイムゾーンを継承します。stop_times.txt で提供される時刻は、stop_timezone ではなく agency.agency_timezone で指定されたタイムゾーンです。これにより、便(trip)がどのタイムゾーンをまたぐかにかかわらず、便(trip)の途中で時刻値が常に増加することが保証されます。 |
wheelchair_boarding |
列挙型 | 任意 | その場所から車椅子で乗車できるかどうかを示します。有効な選択肢は次のとおりです: 親を持たない停留所等(stop)の場合: 0 または空 - 停留所等(stop)のアクセシビリティ情報はありません。1 - この停留所等(stop)では、一部の車両に車椅子の乗客が乗車できます。2 - この停留所等(stop)では車椅子で乗車できません。子停留所等(stop)の場合: 0 または空 - 親駅で指定されている場合、停留所等(stop)は親駅から wheelchair_boarding の動作を継承します。1 - 駅の外部から特定の停留所等(stop)/プラットフォームまで、アクセシブルな経路が存在します。2 - 駅の外部から特定の停留所等(stop)/プラットフォームまで、アクセシブルな経路は存在しません。駅の出入口の場合: 0 または空 - 親駅に指定されている場合、駅の出入口は親駅から wheelchair_boarding の動作を継承します。1 - 駅の出入口は車椅子で利用可能です。2 - 駅の出入口から停留所等(stop)/プラットフォームまでのアクセシブルな経路はありません。 |
level_id |
levels.level_id を参照する外部 ID |
任意 | 場所の階層です。同じ階層を、リンクされていない複数の駅で使用することができます。 |
platform_code |
テキスト | 任意 | プラットフォーム停留所等(stop)(駅に属する停留所等(stop))のプラットフォーム識別子です。これはプラットフォーム識別子のみ(例: "G" または "3")とするべきです。「platform」や「track」(またはフィードの言語に固有の同等表現)などの語を含めるべきではありません。これにより、フィード利用者はプラットフォーム識別子を他の言語へより容易に国際化およびローカライズできます。 |
stop_access |
列挙型 | 条件付き禁止 | 特定の駅において停留所等(stop)へどのようにアクセスするかを示します。有効な選択肢は次のとおりです: 0 - 停留所等(stop)/プラットフォームには道路ネットワークから直接アクセスできません。駅に出入口が定義されている場合は駅の出入口から、そうでない場合は駅自体からアクセスしなければなりません。駅に構内通路(pathway)が定義されている場合、停留所等(stop)/プラットフォームへのアクセスにはそれらを使用しなければなりません。1 - 利用アプリケーションは、親駅の出入口または構内通路(pathway)とは独立して、停留所等(stop)へ直接アクセスするための経路案内を生成するべきです。stop_access が空の場合、指定された停留所等(stop)またはプラットフォームへのアクセスは未定義と見なされます。条件付き禁止: - 駅( location_type=1)、出入口(location_type=2)、汎用ノード(location_type=3)、または乗車エリア(location_type=4)である場所では禁止です。- parent_station が空の場合は禁止です。- それ以外では任意です。 |
routes.txt¶
ファイル: 必須
主キー (route_id)
| フィールド名 | 型 | 存在要件 | 説明 |
|---|---|---|---|
route_id |
一意の ID | 必須 | ルート・路線系統(route)を識別します。 |
agency_id |
agency.agency_id を参照する外部 ID |
条件付き必須 | 指定されたルート・路線系統(route)の事業者です。 条件付き必須: - agency.txt で複数の事業者が定義されている場合は必須です。 - それ以外の場合は推奨です。 |
route_short_name |
テキスト | 条件付き必須 | ルート・路線系統(route)の短縮名です。多くの場合、乗客がルート・路線系統(route)を識別するために使用する短く抽象的な識別子(例: "32"、"100X"、"Green")です。route_short_name と route_long_name の両方を定義することができます。条件付き必須: - routes.route_long_name が空の場合は必須です。- 簡潔なサービス指定がある場合は推奨です。これは一般に知られているサービスの乗客向け名称とするべきであり、12文字を超えるべきではありません。 |
route_long_name |
テキスト | 条件付き必須 | ルート・路線系統(route)の正式名称です。この名称は一般に route_short_name よりも説明的であり、多くの場合、ルート・路線系統(route)の目的地または停留所等(stop)を含みます。route_short_name と route_long_name の両方を定義することができます。条件付き必須: - routes.route_short_name が空の場合は必須です。- それ以外の場合は任意です。 |
route_desc |
テキスト | 任意 | 有用で質の高い情報を提供するルート・路線系統(route)の説明です。route_short_name または route_long_name の重複であってはいけません。 例: "A" 列車は、マンハッタンのInwood-207 StとクイーンズのFar Rockaway-Mott Avenueの間を終日運行します。また、おおむね午前6時から深夜頃まで、追加の "A" 列車がInwood-207 StとLefferts Boulevardの間を運行します(列車は通常、Lefferts BlvdとFar Rockawayを交互に運行します)。 |
route_type |
列挙型 | 必須 | ルート・路線系統(route)で使用される交通手段の種類を示します。有効な選択肢は次のとおりです。0 - 路面電車、ストリートカー、ライトレール。都市圏内のライトレールまたは地上レベルのシステム。1 - 地下鉄、メトロ。都市圏内の地下鉄道システム。2 - 鉄道。都市間または長距離の移動に使用されます。3 - バス。短距離および長距離のバス路線に使用されます。4 - フェリー。短距離および長距離の船舶サービスに使用されます。5 - ケーブルカー。ケーブルが車両の下を通る地上レベルの鉄道車両に使用されます(例: サンフランシスコのケーブルカー)。6 - 索道、懸垂式ケーブルカー(例: ゴンドラリフト、ロープウェイ)。キャビン、車両、ゴンドラまたは開放型チェアが1本以上のケーブルによって吊り下げられるケーブル輸送です。7 - ケーブルカー鉄道。急勾配向けに設計された鉄道システム。11 - トロリーバス。ポールを使用して架線から電力を得る電気バス。12 - モノレール。軌道が単一のレールまたは梁で構成される鉄道。 |
route_url |
URL | 任意 | 特定のルート・路線系統(route)に関する Web ページの URL です。agency.agency_url の値とは異なるべきです。 |
route_color |
色 | 任意 | 公開資料と一致するルート・路線系統(route)の色指定です。省略または空の場合、デフォルトは白(FFFFFF)です。白黒画面で表示した場合に、route_color と route_text_color の色の差が十分なコントラストを提供するべきです。 |
route_text_color |
色 | 任意 | route_color の背景に対して描画されるテキストに使用する、判読可能な色です。省略または空の場合、デフォルトは黒(000000)です。白黒画面で表示した場合に、route_color と route_text_color の色の差が十分なコントラストを提供するべきです。 |
route_sort_order |
非負整数 | 任意 | 乗客への提示に最適な方法でルート・路線系統(route)を並べます。route_sort_order の値が小さいルート・路線系統(route)を先に表示するべきです。 |
continuous_pickup |
列挙型 | 条件付き禁止 | 乗客が、shapes.txt で記述される車両の走行経路に沿った任意の地点で、そのルート・路線系統(route)のすべての便(trip)に乗車できることを示します。有効な選択肢は次のとおりです。0 - 連続停車乗車。1 または空 - 連続停車乗車なし。2 - 連続停車乗車を手配するために事業者へ電話しなければなりません。3 - 連続停車乗車を手配するために運転手と調整しなければなりません。ルート・路線系統(route)に沿った特定の停車時刻(stop_time)について stop_times.continuous_pickup に値を定義することで、routes.continuous_pickup の値を上書きすることができます。条件付き禁止: - このルート・路線系統(route)のいずれかの便(trip)について stop_times.start_pickup_drop_off_window または stop_times.end_pickup_drop_off_window が定義されている場合、1 または空以外の値は禁止です。- それ以外の場合は任意です。 |
continuous_drop_off |
列挙型 | 条件付き禁止 | 乗客が、shapes.txt で記述される車両の走行経路に沿った任意の地点で、そのルート・路線系統(route)のすべての便(trip)から降車できることを示します。有効な選択肢は次のとおりです。0 - 連続停車降車。1 または空 - 連続停車降車なし。2 - 連続停車降車を手配するために事業者へ電話しなければなりません。3 - 連続停車降車を手配するために運転手と調整しなければなりません。ルート・路線系統(route)に沿った特定の停車時刻(stop_time)について stop_times.continuous_drop_off に値を定義することで、routes.continuous_drop_off の値を上書きすることができます。条件付き禁止: - このルート・路線系統(route)のいずれかの便(trip)について stop_times.start_pickup_drop_off_window または stop_times.end_pickup_drop_off_window が定義されている場合、1 または空以外の値は禁止です。- それ以外の場合は任意です。 |
network_id |
ID | 条件付き禁止 | ルート・路線系統(route)のグループを識別します。routes.txt の複数の行が同じ network_id を持つことができます。条件付き禁止: - route_networks.txt または networks.txt ファイルが存在する場合は禁止です。 - それ以外の場合は任意です。 |
cemv_support |
列挙型 | 任意 | 乗客が、運賃検証機において、非接触 EMV(Europay、Mastercard、Visa)カードまたはモバイルデバイスをチケットメディアとして使用することで、このルート・路線系統(route)に関連付けられた交通サービス(すなわち便(trip))を利用できるかどうかを示します(例: 従量課金制またはオープンループシステム)。このフィールドは、cEMV を使用して他のチケット商品を購入したり、別のチケットメディアに価値を追加したりできることを示すものではありません。 このルート・路線系統(route)に属するすべてのサービスが、cEMV カードまたはモバイルデバイスをチケットメディアとして使用して利用可能な場合にのみ、cEMV のサポートを示すべきです。 有効な選択肢は次のとおりです。 0 または空 - このルート・路線系統(route)に関連付けられた便(trip)について cEMV 情報はありません。1 - 乗客は、このルート・路線系統(route)に関連付けられた便(trip)で cEMV をチケットメディアとして使用することができます。2 - このルート・路線系統(route)に関連付けられた便(trip)では、cEMV はチケットメディアとしてサポートされていません。同じサービスについて agency.cemv_support と routes.cemv_support の両方が提供される場合、routes.cemv_support の値が優先されなければなりません。このフィールドは他のすべての運賃関連ファイルから独立しており、個別に使用することができます。このフィールドと、運賃関連ファイル(fare_media.txt、fare_products.txt、または fare_leg_rules.txt など)との間に情報の競合がある場合、それらのファイル内の情報が agency.cemv_support より優先されなければなりません。 |
trips.txt¶
ファイル: 必須
主キー (trip_id)
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
route_id |
routes.route_id を参照する外部 ID |
必須 | ルート・路線系統(route)を識別します。 |
service_id |
calendar.service_id または calendar_dates.service_id を参照する外部 ID |
必須 | 1つ以上のルート・路線系統(route)で運行が利用可能な日付の集合を識別します。 |
trip_id |
一意の ID | 必須 | 便(trip)を識別します。 |
trip_headsign |
テキスト | 任意 | 乗客に対して便(trip)の目的地を識別するために標識に表示されるテキストです。このフィールドは、車両に表示される行先表示(headsign)テキストを使用してルート・路線系統(route)内の便(trip)を区別できる可能性がある、すべてのサービスに対して推奨されます。 便(trip)の途中で行先表示(headsign)が変わる場合、便(trip)に沿った特定の stop_time に対して stop_times.stop_headsign に値を定義することで、trip_headsign の値を上書きすることができます。 |
trip_short_name |
テキスト | 任意 | 例えば通勤鉄道の便(trip)の列車番号を識別するために、乗客が便(trip)を識別するために使用する一般向けテキストです。乗客が通常便(trip)名に依存しない場合、trip_short_name は空にするべきです。trip_short_name の値を提供する場合、運行日(service day)内で便(trip)を一意に識別するべきです。目的地名または各駅停車・急行の区分に使用するべきではありません。 |
direction_id |
列挙型 | 任意 | 便(trip)の移動方向を示します。このフィールドは経路探索で使用するべきではありません。時刻表を公開する際に、方向別に便(trip)を分ける方法を提供します。有効な選択肢は次のとおりです。0 - 一方向への移動(例: 往路)。1 - 反対方向への移動(例: 復路)。例: trip_headsign および direction_id フィールドを併用して、便(trip)の集合における各方向の移動に名前を割り当てることができます。trips.txt ファイルには、時刻表で使用するために次のレコードを含めることができます。 trip_id,...,trip_headsign,direction_id 1234,...,Airport,0 1505,...,Downtown,1 |
block_id |
ID | 任意 | 便(trip)が属するブロックを識別します。ブロックは、共通の運行日(service day)および block_id によって定義される、同じ車両を使用して運行される単一の便(trip)または複数の連続する便(trip)で構成されます。block_id には異なる運行日(service day)を持つ便(trip)を含めることができ、その場合は別個のブロックになります。以下の例を参照してください。着席したままの乗換情報を提供するには、代わりに transfer_type 4 の transfers を提供するべきです。 |
shape_id |
shapes.shape_id を参照する外部 ID |
条件付き必須 | 便(trip)の車両走行経路を記述する地理空間ルート形状(shape)を識別します。 条件付き必須: - 便(trip)に、routes.txt または stop_times.txt のいずれかで定義された連続乗車または連続降車の動作がある場合は必須です。 - それ以外の場合は任意です。 |
wheelchair_accessible |
列挙型 | 任意 | 車椅子での利用可能性を示します。有効な選択肢は次のとおりです。0 または空 - 便(trip)のアクセシビリティ情報はありません。1 - この特定の便(trip)で使用される車両は、車椅子の乗客を少なくとも1人収容できます。2 - この便(trip)では車椅子の乗客を収容できません。 |
bikes_allowed |
列挙型 | 任意 | 自転車の持込みが許可されているかどうかを示します。有効な選択肢は次のとおりです。0 または空 - 便(trip)の自転車情報はありません。1 - この特定の便(trip)で使用される車両は、自転車を少なくとも1台収容できます。2 - この便(trip)では自転車は許可されていません。 |
cars_allowed |
列挙型 | 任意 | 自動車の持込みが許可されているかどうかを示します。有効な選択肢は次のとおりです。0 または空 - 便(trip)の自動車情報はありません。1 - この特定の便(trip)で使用される車両は、自動車を少なくとも1台収容できます。2 - この便(trip)では自動車は許可されていません。 |
safe_duration_factor |
Float | 任意 | オンデマンド便(trip)について計算される移動時間推定値に適用される乗数です。 このフィールドおよび safe_duration_offset フィールドの使用方法に関するガイダンスについては、以下の safe duration フィールドを使用したオンデマンド便(trip)の移動時間推定値の計算セクションを参照してください。 |
safe_duration_offset |
Float | 任意 | オンデマンド便(trip)について計算される移動時間推定値に適用される、秒単位の固定オフセット値です。 このフィールドおよび safe_duration_factor フィールドの使用方法に関するガイダンスについては、以下の safe duration フィールドを使用したオンデマンド便(trip)の移動時間推定値の計算セクションを参照してください。 |
safe duration フィールドを使用したデマンド型便の所要時間見積もりの計算¶
safe_duration_factor と safe_duration_offset を組み合わせることで、95% のケースにおいて、乗客がデマンド型便に要すると予想できる最長時間を見積もることができます。データ利用者は、safe_duration_factor と safe_duration_offset を使用して、次の計算を行うことが期待されます。SafeTravelDuration (seconds) = safe_duration_factor × DrivingDuration (seconds) + safe_duration_offset (seconds)
ここで、DrivingDuration は、デマンド型サービスについて計算対象となる距離を自家用車で移動する場合に要する時間であり、SafeTravelDuration は、乗客がデマンド型便に要すると予想できる最長時間です。
この計算は、便のうちデマンド型である部分にのみ適用するべきです。サービスが迂回固定ルートサービスである場合、または乗客の便にデマンド型サービスから固定ルートサービスへの乗り換えが含まれる場合、便の固定ルート部分の所要時間は、departure_time および arrival_time フィールドに従って計算するべきです。
例: ブロックと運行日(service day)¶
以下の例は有効であり、曜日ごとに異なるブロックがあります。
| route_id | trip_id | service_id | block_id | (最初の停車時刻(stop_time)) | (最後の停車時刻(stop_time)) |
|---|---|---|---|---|---|
| red | trip_1 | mon-tues-wed-thurs-fri-sat-sun | red_loop | 22:00:00 | 22:55:00 |
| red | trip_2 | fri-sat-sun | red_loop | 23:00:00 | 23:55:00 |
| red | trip_3 | fri-sat | red_loop | 24:00:00 | 24:55:00 |
| red | trip_4 | mon-tues-wed-thurs | red_loop | 20:00:00 | 20:50:00 |
| red | trip_5 | mon-tues-wed-thurs | red_loop | 21:00:00 | 21:50:00 |
上記の表に関する注記:
- 例えば、金曜日から土曜日の早朝にかけて、1台の車両が
trip_1、trip_2、およびtrip_3を運行します(午後10:00から午前12:55まで)。最後の便(trip)は土曜日の午前12:00から午前12:55までですが、時刻が24:00:00から24:55:00であるため、金曜日の「運行日(service day)」の一部であることに注意してください。 - 月曜日、火曜日、水曜日、および木曜日には、1台の車両が午後8:00から午後10:55までのブロックで
trip_1、trip_4、およびtrip_5を運行します。
stop_times.txt¶
ファイル: 必須
主キー (trip_id, stop_sequence)
| フィールド名 | 型 | 存在要件 | 説明 |
|---|---|---|---|
trip_id |
trips.trip_id を参照する外部 ID |
必須 | 便(trip)を識別します。 |
arrival_time |
時刻 | 条件付き必須 | stops.stop_timezone ではなく agency.agency_timezone で指定されたタイムゾーンにおける、特定の便(trip)(stop_times.trip_id で定義)の停留所等(stop)(stop_times.stop_id で定義)への到着時刻です。停留所等(stop)での到着時刻と出発時刻が別々に存在しない場合、 arrival_time と departure_time は同じであるべきです。運行日(service day)の深夜0時以降に発生する時刻については、HH:MM:SS 形式で 24:00:00 より大きい値として時刻を入力してください。 正確な到着時刻および出発時刻( timepoint=1)が利用できない場合、推定または補間された到着時刻および出発時刻(timepoint=0)を提供するべきです。条件付き必須: - 便(trip)内の最初および最後の停留所等(stop)( stop_times.stop_sequence で定義)では必須です。- timepoint=1 では必須です。- start_pickup_drop_off_window または end_pickup_drop_off_window が定義されている場合は禁止です。- それ以外の場合は任意です。 |
departure_time |
時刻 | 条件付き必須 | stops.stop_timezone ではなく agency.agency_timezone で指定されたタイムゾーンにおける、特定の便(trip)(stop_times.trip_id で定義)の停留所等(stop)(stop_times.stop_id で定義)からの出発時刻です。停留所等(stop)での到着時刻と出発時刻が別々に存在しない場合、 arrival_time と departure_time は同じであるべきです。運行日(service day)の深夜0時以降に発生する時刻については、HH:MM:SS 形式で 24:00:00 より大きい値として時刻を入力してください。 正確な到着時刻および出発時刻( timepoint=1)が利用できない場合、推定または補間された到着時刻および出発時刻(timepoint=0)を提供するべきです。条件付き必須: - timepoint=1 では必須です。- start_pickup_drop_off_window または end_pickup_drop_off_window が定義されている場合は禁止です。- それ以外の場合は任意です。 |
stop_id |
stops.stop_id を参照する外部 ID |
条件付き必須 | 運行対象の停留所等(stop)を識別します。便(trip)中に運行対象となるすべての停留所等(stop)は、stop_times.txt にレコードを持たなければなりません。参照される場所は停留所等(stop)/プラットフォームでなければならず、すなわち stops.location_type の値は 0 または空でなければなりません。1つの停留所等(stop)は同じ便(trip)内で複数回運行対象となることができ、複数の便(trip)およびルート・路線系統(route)が同じ停留所等(stop)を運行対象とすることができます。停留所等(stop)を使用するデマンド型サービスは、それらの停留所等(stop)でサービスが利用可能となる順序で参照するべきです。データ利用者は、各 stop_time の pickup/drop_off_type および各 start/end_pickup_drop_off_window の時刻制約によって禁止されない限り、1つの停留所等(stop)または場所から、便(trip)内でそれより後にある任意の停留所等(stop)または場所への移動が可能であると仮定するべきです。条件付き必須: - stop_times.location_group_id と stop_times.location_id の両方が定義されていない場合は必須です。- stop_times.location_group_id または stop_times.location_id が定義されている場合は禁止です。 |
location_group_id |
location_groups.location_group_id を参照する外部 ID |
条件付き禁止 | 乗客が乗車または降車をリクエストできる停留所等(stop)のグループを示す、運行対象のロケーショングループを識別します。便(trip)中に運行対象となるすべてのロケーショングループは、stop_times.txt にレコードを持たなければなりません。複数の便(trip)およびルート・路線系統(route)が同じロケーショングループを運行対象とすることができます。 ロケーショングループを使用するデマンド型サービスは、それらのロケーショングループでサービスが利用可能となる順序で参照するべきです。データ利用者は、各 stop_time の pickup/drop_off_type および各 start/end_pickup_drop_off_window の時刻制約によって禁止されない限り、1つの停留所等(stop)または場所から、便(trip)内でそれより後にある任意の停留所等(stop)または場所への移動が可能であると仮定するべきです。条件付き禁止: - stop_times.stop_id または stop_times.location_id が定義されている場合は禁止です。 |
location_id |
locations.geojson の id を参照する外部 ID |
条件付き禁止 | 乗客が乗車または降車をリクエストできる運行対象ゾーンに対応する GeoJSON の場所を識別します。便(trip)中に運行対象となるすべての GeoJSON の場所は、stop_times.txt にレコードを持たなければなりません。複数の便(trip)およびルート・路線系統(route)が同じ GeoJSON の場所を運行対象とすることができます。 場所内のデマンド型サービスは、それらの場所でサービスが利用可能となる順序で参照するべきです。データ利用者は、各 stop_time の pickup/drop_off_type および各 start/end_pickup_drop_off_window の時刻制約によって禁止されない限り、1つの停留所等(stop)または場所から、便(trip)内でそれより後にある任意の停留所等(stop)または場所への移動が可能であると仮定するべきです。条件付き禁止: - stop_times.stop_id または stop_times.location_group_id が定義されている場合は禁止です。 |
stop_sequence |
非負整数 | 必須 | 特定の便(trip)における停留所等(stop)、ロケーショングループ、または GeoJSON の場所の順序です。値は便(trip)に沿って増加しなければなりませんが、連続している必要はありません。 例: 便(trip)上の最初の場所は stop_sequence=1、便(trip)上の2番目の場所は stop_sequence=23、3番目の場所は stop_sequence=40 とすることができます。 同じロケーショングループまたは GeoJSON の場所内での移動には、同じ location_group_id または location_id を持つ stop_times.txt 内の2つのレコードが必要です。 |
stop_headsign |
テキスト | 任意 | 乗客に便(trip)の目的地を示す案内表示に表示されるテキストです。このフィールドは、停留所等(stop)間で行先表示(headsign)が変わる場合に、デフォルトの trips.trip_headsign を上書きします。行先表示(headsign)が便(trip)全体に表示される場合は、代わりに trips.trip_headsign を使用するべきです。1つの stop_time に指定された stop_headsign 値は、同じ便(trip)内の後続の stop_time には適用されません。同じ便(trip)内の複数の stop_time について trip_headsign を上書きする場合、stop_headsign 値を各 stop_time 行で繰り返さなければなりません。 |
start_pickup_drop_off_window |
時刻 | 条件付き必須 | GeoJSON の場所、ロケーショングループ、または停留所等(stop)でデマンド型サービスが利用可能になる時刻です。 条件付き必須: - stop_times.location_group_id または stop_times.location_id が定義されている場合は必須です。- end_pickup_drop_off_window が定義されている場合は必須です。- arrival_time または departure_time が定義されている場合は禁止です。- それ以外の場合は任意です。 |
end_pickup_drop_off_window |
時刻 | 条件付き必須 | GeoJSON の場所、ロケーショングループ、または停留所等(stop)でデマンド型サービスが終了する時刻です。 条件付き必須: - stop_times.location_group_id または stop_times.location_id が定義されている場合は必須です。- start_pickup_drop_off_window が定義されている場合は必須です。- arrival_time または departure_time が定義されている場合は禁止です。- それ以外の場合は任意です。 |
pickup_type |
列挙型 | 条件付き禁止 | 乗車方法を示します。有効な選択肢は次のとおりです:0 または空 - 定期的に予定された乗車。1 - 乗車不可。2 - 乗車を手配するために事業者へ電話しなければなりません。3 - 乗車を手配するために運転手と調整しなければなりません。条件付き禁止: - start_pickup_drop_off_window または end_pickup_drop_off_window が定義されている場合、pickup_type=0 は禁止です。- start_pickup_drop_off_window または end_pickup_drop_off_window が定義されている場合、pickup_type=3 は禁止です。- それ以外の場合は任意です。 |
drop_off_type |
列挙型 | 条件付き禁止 | 降車方法を示します。有効な選択肢は次のとおりです:0 または空 - 定期的に予定された降車。1 - 降車不可。2 - 降車を手配するために事業者へ電話しなければなりません。3 - 降車を手配するために運転手と調整しなければなりません。条件付き禁止: - start_pickup_drop_off_window または end_pickup_drop_off_window が定義されている場合、drop_off_type=0 は禁止です。- それ以外の場合は任意です。 |
continuous_pickup |
列挙型 | 条件付き禁止 | 乗客が、この stop_time から便(trip)の stop_sequence における次の stop_time まで、shapes.txt で記述される車両の走行経路上の任意の地点で公共交通車両に乗車できることを示します。有効な選択肢は次のとおりです: 0 - 連続停車による乗車。1 または空 - 連続停車による乗車なし。2 - 連続停車による乗車を手配するために事業者へ電話しなければなりません。3 - 連続停車による乗車を手配するために運転手と調整しなければなりません。このフィールドが設定されている場合、routes.txt で定義された連続乗車の動作を上書きします。このフィールドが空の場合、stop_time は routes.txt で定義された連続乗車の動作を継承します。 条件付き禁止: - start_pickup_drop_off_window または end_pickup_drop_off_window が定義されている場合、1 または空以外の値は禁止です。- それ以外の場合は任意です。 |
continuous_drop_off |
列挙型 | 条件付き禁止 | 乗客が、この stop_time から便(trip)の stop_sequence における次の stop_time まで、shapes.txt で記述される車両の走行経路上の任意の地点で公共交通車両から降車できることを示します。有効な選択肢は次のとおりです: 0 - 連続停車による降車。1 または空 - 連続停車による降車なし。2 - 連続停車による降車を手配するために事業者へ電話しなければなりません。3 - 連続停車による降車を手配するために運転手と調整しなければなりません。このフィールドが設定されている場合、routes.txt で定義された連続降車の動作を上書きします。このフィールドが空の場合、stop_time は routes.txt で定義された連続降車の動作を継承します。 条件付き禁止: - start_pickup_drop_off_window または end_pickup_drop_off_window が定義されている場合、1 または空以外の値は禁止です。- それ以外の場合は任意です。 |
shape_dist_traveled |
非負浮動小数点数 | 任意 | 最初の停留所等(stop)から、このレコードで指定された停留所等(stop)まで、関連付けられたルート形状(shape)に沿って実際に移動した距離です。このフィールドは、便(trip)中の任意の2つの停留所等(stop)間で描画するルート形状(shape)の範囲を指定します。shapes.txt で使用されるものと同じ単位でなければなりません。shape_dist_traveled に使用される値は stop_sequence とともに増加しなければならず、ルート・路線系統(route)に沿った逆方向の移動を示すために使用してはいけません。ループまたは重複走行(車両が1つの便(trip)内で同じ線形の一部を横断または走行すること)があるルート・路線系統(route)に推奨されます。 shapes.shape_dist_traveled を参照してください。例: バスがルート形状(shape)の開始地点から停留所等(stop)まで 5.25 キロメートル移動する場合、 shape_dist_traveled=5.25 です。 |
timepoint |
列挙型 | 任意 | 停留所等(stop)の到着時刻および出発時刻が車両によって厳密に遵守されるか、または概算および/または補間された時刻であるかを示します。このフィールドにより、GTFS 作成者は、時刻が概算であることを示しながら補間された停車時刻(stop_time)を提供できます。有効な選択肢は次のとおりです:0 - 時刻は概算とみなされます。1 - 時刻は正確とみなされます。到着時刻または出発時刻が定義されている stop_times.txt のすべてのレコードには、timepoint 値を設定するべきです。timepoint 値が提供されない場合、すべての時刻は正確とみなされます。 |
pickup_booking_rule_id |
booking_rules.booking_rule_id を参照する外部 ID |
任意 | この停車時刻(stop_time)における乗車予約ルールを識別します。pickup_type=2 の場合に推奨されます。 |
drop_off_booking_rule_id |
booking_rules.booking_rule_id を参照する外部 ID |
任意 | この停車時刻(stop_time)における降車予約ルールを識別します。drop_off_type=2 の場合に推奨されます。 |
オンデマンドサービスの経路探索動作¶
- 出発地と目的地の間の経路探索または所要時間を提供する場合、データ利用者は、
start_pickup_drop_off_windowおよびend_pickup_drop_off_windowが定義されている、同じtrip_idを持つ中間の stop_times.txt レコードを無視するべきです。無視するべき内容を示す例については、データ例ページを参照してください。 - 同じ
trip_idを持つ2つ以上の stop_times.txt レコード間で、locations.geojson のidジオメトリ、start/end_pickup_drop_off_window時刻、およびpickup_typeまたはdrop_off_typeが同時に重複することは禁止されています。禁止されている内容を示す例については、データ例ページを参照してください。
calendar.txt¶
ファイル: 条件付き必須
主キー (service_id)
| フィールド名 | 型 | 存在要件 | 説明 |
|---|---|---|---|
service_id |
一意の ID | 必須 | 1つ以上のルート・路線系統(route)でサービスが利用可能な日付の集合を識別します。 |
monday |
列挙型 | 必須 | start_date および end_date フィールドで指定された日付範囲内のすべての月曜日にサービスが運行されるかどうかを示します。特定の日付に対する例外は calendar_dates.txt に記載される場合があることに注意してください。有効な選択肢は次のとおりです。1 - 日付範囲内のすべての月曜日にサービスが利用可能です。0 - 日付範囲内の月曜日にはサービスを利用できません。 |
tuesday |
列挙型 | 必須 | monday と同様に機能しますが、火曜日に適用されます。 |
wednesday |
列挙型 | 必須 | monday と同様に機能しますが、水曜日に適用されます。 |
thursday |
列挙型 | 必須 | monday と同様に機能しますが、木曜日に適用されます。 |
friday |
列挙型 | 必須 | monday と同様に機能しますが、金曜日に適用されます。 |
saturday |
列挙型 | 必須 | monday と同様に機能しますが、土曜日に適用されます。 |
sunday |
列挙型 | 必須 | monday と同様に機能しますが、日曜日に適用されます。 |
start_date |
日付 | 必須 | サービス期間の開始運行日(service day)です。 |
end_date |
日付 | 必須 | サービス期間の終了運行日(service day)です。この運行日(service day)は期間に含まれます。 |
calendar_dates.txt¶
ファイル: 条件付き必須
主キー (service_id, date)
calendar_dates.txt テーブルは、日付ごとに運行を明示的に有効化または無効化します。これは2つの方法で使用することができます。
- 推奨: calendar.txt で定義されたデフォルトの運行パターンに対する例外を定義するために、calendar.txt と併せて calendar_dates.txt を使用します。運行が概ね規則的であり、明示的な日付における変更が少数である場合(たとえば、特別イベント運行や学校のスケジュールに対応するため)は、これが適切な方法です。この場合、
calendar_dates.service_idはcalendar.service_idを参照する外部IDです。 - 代替: calendar.txt を省略し、運行日ごとに calendar_dates.txt で指定します。これにより、大幅な運行変動が可能となり、通常の週間スケジュールを持たない運行にも対応できます。この場合、
service_idはIDです。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
service_id |
calendar.service_id を参照する外部IDまたはID |
必須 | 1つ以上のルート・路線系統(route)において運行例外が発生する日付の集合を識別します。calendar.txt と calendar_dates.txt を併せて使用する場合、各 (service_id, date) の組は calendar_dates.txt に1回のみ出現することができます。service_id の値が calendar.txt と calendar_dates.txt の両方に出現する場合、calendar_dates.txt の情報は calendar.txt で指定された運行情報を変更します。 |
date |
日付 | 必須 | 運行例外が発生する日付です。 |
exception_type |
列挙型 | 必須 | date フィールドで指定された日付に運行が利用可能かどうかを示します。有効な選択肢は次のとおりです。1 - 指定された日付に運行が追加されています。2 - 指定された日付から運行が削除されています。例: あるルート・路線系統(route)に、休日に利用可能な便(trip)のセットと、それ以外のすべての日に利用可能な別の便(trip)のセットがあるとします。1つの service_id は通常の運行スケジュールに対応し、別の service_id は休日のスケジュールに対応することができます。特定の休日について、calendar_dates.txt ファイルを使用して、その休日を休日用の service_id に追加し、通常の service_id スケジュールからその休日を削除することができます。 |
fare_attributes.txt¶
ファイル: 任意
主キー (fare_id)
バージョン
運賃を記述するためのモデリングオプションは2つあります。GTFS-Fares V1は、最小限の運賃情報を記述するための従来のオプションです。GTFS-Fares V2は、事業者の運賃体系をより詳細に記述できる更新された方法です。両方をデータセット内に含めることができますが、データコンシューマーは特定のデータセットに対して1つの方法のみを使用するべきです。GTFS-Fares V2をGTFS-Fares V1より優先することが推奨されます。
GTFS-Fares V1に関連するファイルは次のとおりです。
- fare_attributes.txt
- fare_rules.txt
GTFS-Fares V2に関連するファイルは次のとおりです。
- fare_media.txt
- fare_products.txt
- rider_categories.txt
- fare_leg_rules.txt
- fare_leg_join_rules.txt
- fare_transfer_rules.txt
- timeframes.txt
- networks.txt
- route_networks.txt
- areas.txt
- stop_areas.txt
| フィールド名 | 型 | 存在要件 | 説明 |
|---|---|---|---|
fare_id |
一意のID | 必須 | 運賃クラスを識別します。 |
price |
非負の浮動小数点数 | 必須 | currency_typeで指定された単位による運賃価格です。 |
currency_type |
通貨コード | 必須 | 運賃の支払いに使用する通貨です。 |
payment_method |
列挙型 | 必須 | 運賃をいつ支払わなければならないかを示します。有効なオプションは次のとおりです。0 - 運賃は車内で支払われます。1 - 運賃は乗車前に支払わなければなりません。 |
transfers |
列挙型 | 必須 | この運賃で許可される乗換回数を示します。有効なオプションは次のとおりです。0 - この運賃では乗換は許可されません。1 - 乗客は1回乗り換えることができます。2 - 乗客は2回乗り換えることができます。空欄 - 無制限の乗換が許可されます。 |
agency_id |
agency.agency_idを参照する外部ID |
条件付き必須 | 運賃に関連する事業者を識別します。 条件付き必須: - agency.txtで複数の事業者が定義されている場合は必須です。 - それ以外の場合は推奨です。 |
transfer_duration |
非負の整数 | 任意 | 乗換が期限切れになるまでの秒単位の時間です。transfers=0の場合、このフィールドはチケットの有効期間を示すために使用することができ、または空欄のままにすることができます。 |
fare_rules.txt¶
ファイル: 任意
主キー (*)
fare_rules.txt テーブルは、fare_attributes.txt の運賃が旅程(journey)にどのように適用されるかを指定します。ほとんどの運賃体系では、以下のルールをいくつか組み合わせて使用します。
- 運賃は出発地または目的地の駅に依存します。
- 運賃は旅程(journey)が通過するゾーンに依存します。
- 運賃は旅程(journey)が使用するルート・路線系統(route)に依存します。
fare_rules.txt および fare_attributes.txt を使用して運賃体系を指定する方法を示す例については、GoogleTransitDataFeed オープンソースプロジェクト wiki の FareExamples を参照してください。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
fare_id |
fare_attributes.fare_id を参照する外部 ID |
必須 | 運賃クラスを識別します。 |
route_id |
routes.route_id を参照する外部 ID |
任意 | 運賃クラスに関連付けられたルート・路線系統(route)を識別します。同じ運賃属性を持つ複数のルート・路線系統(route)が存在する場合、各ルート・路線系統(route)について fare_rules.txt にレコードを作成します。 例: 運賃クラス「b」がルート・路線系統(route)「TSW」および「TSE」で有効である場合、fare_rules.txt ファイルには、この運賃クラスについて以下のレコードが含まれます。 fare_id,route_idb,TSW b,TSE |
origin_id |
stops.zone_id を参照する外部 ID |
任意 | 出発地ゾーンを識別します。運賃クラスに複数の出発地ゾーンがある場合、各 origin_id について fare_rules.txt にレコードを作成します。例: 運賃クラス「b」がゾーン「2」またはゾーン「8」のいずれかを出発地とするすべての移動で有効である場合、fare_rules.txt ファイルには、この運賃クラスについて以下のレコードが含まれます。 fare_id,...,origin_id b,...,2 b,...,8 |
destination_id |
stops.zone_id を参照する外部 ID |
任意 | 目的地ゾーンを識別します。運賃クラスに複数の目的地ゾーンがある場合、各 destination_id について fare_rules.txt にレコードを作成します。例: origin_id および destination_id フィールドを併用して、運賃クラス「b」がゾーン 3 と 4 の間の移動、およびゾーン 3 と 5 の間の移動で有効であることを指定できます。fare_rules.txt ファイルには、この運賃クラスについて以下のレコードが含まれます。 fare_id,...,origin_id,destination_id b,...,3,4b,...,3,5 |
contains_id |
stops.zone_id を参照する外部 ID |
任意 | 乗客が特定の運賃クラスを使用中に入るゾーンを識別します。一部のシステムでは、正しい運賃クラスを計算するために使用されます。 例: 運賃クラス「c」が、ゾーン 5、6、および 7 を通過する GRT ルート・路線系統(route)上のすべての移動に関連付けられている場合、fare_rules.txt には以下のレコードが含まれます。 fare_id,route_id,...,contains_id c,GRT,...,5 c,GRT,...,6 c,GRT,...,7 運賃を適用するにはすべての contains_id ゾーンが一致しなければならないため、ゾーン 5 および 6 を通過するがゾーン 7 を通過しない旅程(journey)には、運賃クラス「c」は適用されません。詳細については、GoogleTransitDataFeed プロジェクト wiki の https://code.google.com/p/googletransitdatafeed/wiki/FareExamples を参照してください。 |
timeframes.txt¶
ファイル: 任意
主キー (*)
時刻、曜日、または年内の特定の日に基づいて変動する運賃を記述するために使用されます。時間枠は、fare_leg_rules.txt のチケット商品に関連付けることができます。
同じ timeframe_group_id および service_id の値に対して、時間間隔が重複してはいけません。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
timeframe_group_id |
ID | 必須 | 時間枠または時間枠のセットを識別します。 |
start_time |
Local time | 条件付き必須 | 時間枠の開始を定義します。間隔には開始時刻が含まれます。24:00:00 より大きい値は禁止されています。start_time の空の値は 00:00:00 と見なされます。 条件付き必須: - timeframes.end_time が定義されている場合は必須です。- それ以外の場合は禁止されています。 |
end_time |
Local time | 条件付き必須 | 時間枠の終了を定義します。間隔には終了時刻が含まれません。24:00:00 より大きい値は禁止されています。end_time の空の値は 24:00:00 と見なされます。 条件付き必須: - timeframes.start_time が定義されている場合は必須です。- それ以外の場合は禁止されています。 |
service_id |
calendar.service_id または calendar_dates.service_id を参照する Foreign ID |
必須 | 時間枠が有効となる日付のセットを識別します。 |
時間枠のローカル時刻セマンティクス¶
- 運賃イベントの時刻を timeframes.txt と照合して評価する場合、イベント時刻は、運賃イベントの停留所等(stop)または親駅について指定されている場合は
stop_timezoneにより決定されるローカルタイムゾーンを使用して、ローカル時刻で計算されます。指定されていない場合は、代わりにフィードの事業者タイムゾーンを使用するべきです。 - 「現在の日」は、ローカルタイムゾーンを基準として計算された、運賃イベント時刻の現在の日付です。「現在の日」は、特に深夜をまたぐ便(trip)の場合、運賃区間の便(trip)の運行日(service day)とは異なることがあります。
- 運賃イベントの「時刻」は、GTFS Local time フィールド型のセマンティクスを使用して、「現在の日」を基準に計算されます。
rider_categories.txt¶
ファイル: 任意
主キー (rider_category_id)
乗客のカテゴリ(例: 高齢者、学生)を定義します。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
rider_category_id |
一意の ID | 必須 | 乗客カテゴリを識別します。 |
rider_category_name |
テキスト | 必須 | 乗客に表示される乗客カテゴリ名です。 |
is_default_fare_category |
列挙型 | 必須 | rider_categories.txt のエントリをデフォルトカテゴリ(すなわち、乗客に表示するべき主要カテゴリ)と見なすかどうかを指定します。例: 大人運賃、通常運賃など。有効な選択肢は次のとおりです。0 または空 - カテゴリはデフォルトと見なされません。1 - カテゴリはデフォルトと見なされます。fare_product_id で指定された1つのチケット商品に対して複数の乗客カテゴリが適格である場合、これらの適格な乗客カテゴリのうち、デフォルトの乗客カテゴリ(is_default_fare_category = 1)として示されるものが正確に1つなければなりません。 |
eligibility_url |
URL | 任意 | 特定の乗客カテゴリに関する詳細情報を提供し、かつ/またはその適格性基準を説明する、通常は運行事業者による Web ページの URL です。 |
fare_media.txt¶
ファイル: 任意
主キー (fare_media_id)
チケット商品を利用するために使用できるさまざまなチケットメディアを記述します。チケットメディアは、チケット商品の表現および/または検証に使用される物理的または仮想的な媒体です。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
fare_media_id |
一意の ID | 必須 | チケットメディアを識別します。 |
fare_media_name |
テキスト | 任意 | チケットメディアの名称。 交通カード( fare_media_type =2)またはモバイルアプリ(fare_media_type =4)であるチケットメディアについては、fare_media_name を含めるべきであり、それらを提供する組織が乗客向けに使用する名称と一致するべきです。 |
fare_media_type |
列挙型 | 必須 | チケットメディアの種類。有効な選択肢は次のとおりです。0 - なし。運転手または車掌に現金を支払い、物理的な乗車券が提供されない場合など、チケット商品の購入または検証にチケットメディアが関与しない場合に使用します。1 - 乗客が事前購入した一定回数の乗車、または固定期間内の無制限の乗車を利用できる物理的な紙の乗車券。2 - 保存された乗車券、定期券、または金銭的価値を持つ物理的な交通カード。3 - アカウントベースのチケッティングのためのオープンループトークンコンテナとしての cEMV(非接触 Europay、Mastercard、Visa)。4 - 仮想交通カード、乗車券、定期券、または金銭的価値を保存したモバイルアプリ。 |
fare_products.txt¶
ファイル: 任意
主キー (fare_product_id, rider_category_id, fare_media_id)
乗客が購入可能な運賃の範囲、または乗換費用など、複数の乗車区間(leg)を含む旅程(journey)の合計運賃を計算する際に考慮される運賃を記述するために使用されます。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
fare_product_id |
ID | 必須 | チケット商品、またはチケット商品のセットを識別します。 同じ fare_product_id を共有する複数のレコードは、異なる fare_media_id または rider_category_id を含む限り許可されます。異なる fare_media_id は、チケット商品を利用するためのさまざまな方法が利用可能であり、価格が異なる可能性があることを示します。異なる rider_category_id は、複数の乗客カテゴリがチケット商品の対象であり、価格が異なる可能性があることを示します。 |
fare_product_name |
Text | 任意 | 乗客に表示されるチケット商品の名称です。 |
rider_category_id |
rider_categories.rider_category_id を参照する外部ID |
任意 | チケット商品の対象となる乗客カテゴリを識別します。fare_products.rider_category_id が空の場合、チケット商品は任意の rider_category_id の対象となります。fare_product_id で指定される単一のチケット商品の対象となる乗客カテゴリが複数ある場合、これらの乗客カテゴリのうち、デフォルトの乗客カテゴリ(is_default_fare_category = 1)として示されるものは1つだけでなければなりません。 |
fare_media_id |
fare_media.fare_media_id を参照する外部ID |
任意 | 乗車中にチケット商品を利用するために使用できるチケットメディアを識別します。fare_media_id が空の場合、チケットメディアは不明であると見なされます。 |
amount |
通貨金額 | 必須 | チケット商品の費用です。乗換割引を表すために負の値とすることができます。無料のチケット商品を表すためにゼロとすることができます。通貨金額には、対応する通貨コードに対して ISO 4217 規格で指定された小数点以下の桁数を含めなければなりません。 例: 運賃が2米ドルの場合、金額は2ではなく2.00です。 |
currency |
通貨コード | 必須 | チケット商品の費用の通貨です。 |
fare_leg_rules.txt¶
ファイル: 任意
主キー (network_id, from_area_id, to_area_id, from_timeframe_group_id, to_timeframe_group_id, fare_product_id)
個々の乗車区間(leg)に対する運賃ルールです。
fare_leg_rules.txt の運賃は、ファイル内のすべてのレコードをフィルタリングして、乗客が移動する乗車区間(leg)に一致するルールを見つけることで照会しなければなりません。
乗車区間(leg)の費用を処理するには:
-
ファイル fare_leg_rules.txt は、移動の特性を定義するフィールドによってフィルタリングしなければなりません。これらのフィールドは次のとおりです:
fare_leg_rules.network_idfare_leg_rules.from_area_idfare_leg_rules.to_area_idfare_leg_rules.from_timeframe_group_idfare_leg_rules.to_timeframe_group_id
-
乗車区間(leg)が移動の特性に基づいて fare_leg_rules.txt のレコードと完全に一致する場合、そのレコードを処理して乗車区間(leg)の費用を決定しなければなりません。このファイルでは、空のエントリを2つの方法で処理します: 空のセマンティクスまたは rule_priority。
-
完全一致が見つからず、かつ
rule_priorityフィールドが存在しない場合、乗車区間(leg)の費用を処理するために、fare_leg_rules.network_id、fare_leg_rules.from_area_id、およびfare_leg_rules.to_area_idの空のエントリを確認しなければなりません:-
fare_leg_rules.network_idの空のエントリは、fare_leg_rules.network_idに列挙されているものを除く、routes.txt または networks.txt で定義されたすべてのネットワークに対応します。 -
fare_leg_rules.from_area_idの空のエントリは、fare_leg_rules.from_area_idに列挙されているものを除く、areas.area_idで定義されたすべてのエリアに対応します。 fare_leg_rules.to_area_idの空のエントリは、fare_leg_rules.to_area_idに列挙されているものを除く、areas.area_idで定義されたすべてのエリアに対応します。
-
-
rule_priorityフィールドが存在する場合:fare_leg_rules.network_idの空のエントリは、乗車区間(leg)のネットワークがこのルールの一致に影響しないことを示します。fare_leg_rules.from_area_idの空のエントリは、乗車区間(leg)の出発エリアがこのルールの一致に影響しないことを示します。fare_leg_rules.to_area_idの空のエントリは、乗車区間(leg)の到着エリアがこのルールの一致に影響しないことを示します。
-
乗車区間(leg)が上記のいずれのルールにも一致しない場合、運賃は不明です。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
leg_group_id |
ID | 任意 | fare_leg_rules.txt 内のエントリのグループを識別します。fare_transfer_rules.from_leg_group_id と fare_transfer_rules.to_leg_group_id 間の運賃乗換ルールを記述するために使用されます。fare_leg_rules.txt 内の複数のエントリが、同じ fare_leg_rules.leg_group_id に属することができます。fare_leg_rules.txt 内の同じエントリ( fare_leg_rules.leg_group_id を除く)は、複数の fare_leg_rules.leg_group_id に属してはいけません。 |
network_id |
routes.network_id または networks.network_id を参照する外部 ID |
任意 | 運賃乗車区間ルールに適用されるルートネットワークを識別します。rule_priority フィールドが存在せず、かつフィルタリング対象の network_id に一致する fare_leg_rules.network_id 値がない場合、空の fare_leg_rules.network_id がデフォルトで一致します。fare_leg_rules.network_id の空のエントリは、fare_leg_rules.network_id に列挙されているものを除く、routes.txt または networks.txt で定義されたすべてのネットワークに対応します。ファイル内に rule_priority フィールドが存在する場合、空の fare_leg_rules.network_id は、乗車区間(leg)のルートネットワークがこのルールの一致に影響しないことを示します。複数の乗車区間(leg)からなる有効運賃区間(effective fare leg)に対して一致させる場合、各乗車区間(leg)は一致に使用される同じ network_id を持たなければなりません。 |
from_area_id |
areas.area_id を参照する外部 ID |
任意 | 出発エリアを識別します。rule_priority フィールドが存在せず、かつフィルタリング対象の area_id に一致する fare_leg_rules.from_area_id 値がない場合、空の fare_leg_rules.from_area_id がデフォルトで一致します。 fare_leg_rules.from_area_id の空のエントリは、fare_leg_rules.from_area_id に列挙されているものを除く、areas.area_id で定義されたすべてのエリアに対応します。ファイル内に rule_priority フィールドが存在する場合、空の fare_leg_rules.from_area_id は、乗車区間(leg)の出発エリアがこのルールの一致に影響しないことを示します。複数の乗車区間(leg)からなる有効運賃区間(effective fare leg)に対して一致させる場合、有効運賃区間(effective fare leg)の最初の乗車区間(leg)を使用して出発エリアを決定します。 |
to_area_id |
areas.area_id を参照する外部 ID |
任意 | 到着エリアを識別します。rule_priority フィールドが存在せず、かつフィルタリング対象の area_id に一致する fare_leg_rules.to_area_id 値がない場合、空の fare_leg_rules.to_area_id がデフォルトで一致します。fare_leg_rules.to_area_id の空のエントリは、fare_leg_rules.to_area_id に列挙されているものを除く、areas.area_id で定義されたすべてのエリアに対応します。ファイル内に rule_priority フィールドが存在する場合、空の fare_leg_rules.to_area_id は、乗車区間(leg)の到着エリアがこのルールの一致に影響しないことを示します。複数の乗車区間(leg)からなる有効運賃区間(effective fare leg)に対して一致させる場合、有効運賃区間(effective fare leg)の最後の乗車区間(leg)を使用して到着エリアを決定します。 |
from_timeframe_group_id |
timeframes.timeframe_group_id を参照する外部 ID |
任意 | 運賃乗車区間の開始時における運賃検証イベントの時間枠を定義します。 運賃乗車区間の「開始時刻」は、イベントの発生が予定されている時刻です。たとえば、この時刻は、乗客が乗車して運賃を検証する運賃乗車区間の開始時におけるバスの予定出発時刻とすることができます。以下のルール一致セマンティクスでは、開始時刻は timeframes.txt の Local Time Semantics によって決定される現地時刻で計算されます。適切な場合、タイムゾーンの解決には運賃乗車区間の出発イベントの停留所等(stop)または駅を使用するべきです。 from_timeframe_group_id を指定する運賃乗車区間ルールについて、以下のすべての条件が真である timeframes.txt 内のレコードが少なくとも1つ存在する場合、そのルールは特定の乗車区間(leg)に一致します。- timeframe_group_id の値が from_timeframe_group_id の値と等しい。- レコードの service_id によって識別される日の集合に、運賃乗車区間の開始時刻の「当日」が含まれる。- 運賃乗車区間の開始時刻の「時刻」が、レコードの timeframes.start_time 値以上かつ timeframes.end_time 値未満である。空の fare_leg_rules.from_timeframe_group_id は、乗車区間(leg)の開始時刻がこのルールの一致に影響しないことを示します。複数の乗車区間(leg)からなる有効運賃区間(effective fare leg)に対して一致させる場合、有効運賃区間(effective fare leg)の最初の乗車区間(leg)を使用して開始運賃検証イベントを決定します。 |
to_timeframe_group_id |
timeframes.timeframe_group_id を参照する外部 ID |
任意 | 運賃乗車区間の終了時における運賃検証イベントの時間枠を定義します。 運賃乗車区間の「終了時刻」は、イベントの発生が予定されている時刻です。たとえば、この時刻は、乗客が降車して運賃を検証する運賃乗車区間の終了時におけるバスの予定到着時刻とすることができます。以下のルール一致セマンティクスでは、終了時刻は timeframes.txt の Local Time Semantics によって決定される現地時刻で計算されます。適切な場合、タイムゾーンの解決には運賃乗車区間の到着イベントの停留所等(stop)または駅を使用するべきです。 to_timeframe_group_id を指定する運賃乗車区間ルールについて、以下のすべての条件が真である timeframes.txt 内のレコードが少なくとも1つ存在する場合、そのルールは特定の乗車区間(leg)に一致します。- timeframe_group_id の値が to_timeframe_group_id の値と等しい。- レコードの service_id によって識別される日の集合に、運賃乗車区間の終了時刻の「当日」が含まれる。- 運賃乗車区間の終了時刻の「時刻」が、レコードの timeframes.start_time 値以上かつ timeframes.end_time 値未満である。空の fare_leg_rules.to_timeframe_group_id は、乗車区間(leg)の終了時刻がこのルールの一致に影響しないことを示します。複数の乗車区間(leg)からなる有効運賃区間(effective fare leg)に対して一致させる場合、有効運賃区間(effective fare leg)の最後の乗車区間(leg)を使用して終了運賃検証イベントを決定します。 |
fare_product_id |
fare_products.fare_product_id を参照する外部 ID |
必須 | 乗車区間(leg)を移動するために必要なチケット商品です。 |
rule_priority |
非負整数 | 任意 | 一致するルールが乗車区間(leg)に適用される優先順位を定義し、特定のルールを他のルールより優先させることができます。fare_leg_rules.txt 内の複数のエントリが一致する場合、rule_priority の値が最も高いルールまたはルールの集合が選択されます。rule_priority の空の値はゼロとして扱われます。 |
fare_leg_join_rules.txt¶
ファイル: 任意
主キー (from_network_id, to_network_id, from_stop_id, to_stop_id)
乗換を伴う連続する2つの乗車区間(leg)からなる部分旅程(sub-journey)について、乗換がファイル内の特定のレコードで指定されたすべての一致条件に一致する場合、それら2つの乗車区間(leg)は、fare_leg_rules.txt のルールとの照合において、単一の有効運賃区間(effective fare leg)として扱うべきです。
from_stop_idおよびto_stop_idによって明示的に上書きされない限り、乗換前の乗車区間(leg)の最後の駅と乗換後の乗車区間(leg)の最初の駅は、レコードにおいて同一でなければなりません。- ファイル内の特定のレコードについて、一致条件フィールド値が空白または未指定である場合、そのフィールドは照合において無視するべきです。
- 部分旅程(sub-journey)に、それぞれが結合ルールに一致する連続した乗換が含まれる場合、部分旅程(sub-journey)全体を単一の有効運賃区間(effective fare leg)として扱うべきです。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
from_network_id |
routes.network_id または networks.network_id を参照する外部ID |
必須 | 指定されたルートネットワークを使用する乗換前の乗車区間(leg)に一致します。指定する場合、同じ to_network_id も指定しなければなりません。 |
to_network_id |
routes.network_id または networks.network_id を参照する外部ID |
必須 | 指定されたルートネットワークを使用する乗換後の乗車区間(leg)に一致します。指定する場合、同じ from_network_id も指定しなければなりません。 |
from_stop_id |
stops.stop_id を参照する外部ID |
条件付き必須 | 指定された停留所等(stop)(location_type=0 または空)または駅(location_type=1)で終了する乗換前の乗車区間(leg)に一致します。条件付き必須: - to_stop_id が定義されている場合は必須です。- それ以外の場合は任意です。 |
to_stop_id |
stops.stop_id を参照する外部ID |
条件付き必須 | 指定された停留所等(stop)(location_type=0 または空)または駅(location_type=1)で開始する乗換後の乗車区間(leg)に一致します。条件付き必須: - from_stop_id が定義されている場合は必須です。- それ以外の場合は任意です。 |
fare_transfer_rules.txt¶
ファイル: 任意
主キー (from_leg_group_id, to_leg_group_id, fare_product_id, transfer_count, duration_limit)
fare_leg_rules.txt で定義される乗車区間(leg)間の乗り換えに関する運賃ルールです。from_leg_group_id から to_leg_group_id への運賃乗り換えルールは、逆方向には適用されません。
複数乗車区間の旅程(journey)の費用を処理するには:
- 乗客の旅程(journey)に基づき、移動のすべての個別の乗車区間(leg)または有効運賃区間(effective fare leg)について、fare_leg_rules.txt で定義される適用可能な運賃乗車区間グループを決定するべきです。
-
fare_transfer_rules.txt ファイルは、乗り換えの特性を定義するフィールドでフィルタリングしなければなりません。これらのフィールドは次のとおりです:
fare_transfer_rules.from_leg_group_idfare_transfer_rules.to_leg_group_id
-
乗り換えの特性に基づいて、乗り換えが fare_transfer_rules.txt 内のレコードと完全に一致する場合、そのレコードを処理して乗り換え費用を決定しなければなりません。
- 完全一致が見つからない場合、乗り換え費用を処理するために、
from_leg_group_idまたはto_leg_group_idの空のエントリを確認しなければなりません:fare_transfer_rules.from_leg_group_idの空のエントリは、fare_transfer_rules.from_leg_group_idに列挙されているものを除く、fare_leg_rules.leg_group_idで定義されるすべての乗車区間グループに対応しますfare_transfer_rules.to_leg_group_idの空のエントリは、fare_transfer_rules.to_leg_group_idに列挙されているものを除く、fare_leg_rules.leg_group_idで定義されるすべての乗車区間グループに対応します
- 乗り換えが上記のいずれのルールにも一致しない場合、乗り換えの取り決めはなく、乗車区間(leg)は別個のものと見なされます。
| フィールド名 | 型 | 存在性 | 説明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
from_leg_group_id |
fare_leg_rules.leg_group_id を参照する外部 ID |
任意 | 乗り換え前の運賃乗車区間ルールのグループを識別します。 フィルタリング対象の leg_group_id に一致する fare_transfer_rules.from_leg_group_id 値がない場合、空の fare_transfer_rules.from_leg_group_id がデフォルトで一致します。fare_transfer_rules.from_leg_group_id の空のエントリは、fare_transfer_rules.from_leg_group_id に列挙されているものを除く、fare_leg_rules.leg_group_id で定義されるすべての乗車区間グループに対応します。 |
||||||||||||
to_leg_group_id |
fare_leg_rules.leg_group_id を参照する外部 ID |
任意 | 乗り換え後の運賃乗車区間ルールのグループを識別します。 フィルタリング対象の leg_group_id に一致する fare_transfer_rules.to_leg_group_id 値がない場合、空の fare_transfer_rules.to_leg_group_id がデフォルトで一致します。fare_transfer_rules.to_leg_group_id の空のエントリは、fare_transfer_rules.to_leg_group_id に列挙されているものを除く、fare_leg_rules.leg_group_id で定義されるすべての乗車区間グループに対応します。 |
||||||||||||
transfer_count |
ゼロ以外の整数 | 条件付き禁止 | 乗り換えルールを適用できる連続した乗り換えの回数を定義します。 有効な選択肢は次のとおりです: -1 - 制限なし。1 以上 - 乗り換えルールが適用される乗り換え回数を定義します。部分旅程(sub-journey)が異なる transfer_count を持つ複数のレコードに一致する場合、部分旅程(sub-journey)の現在の乗り換え回数以上である最小の transfer_count を持つルールを選択するべきです。条件付き禁止: - fare_transfer_rules.from_leg_group_id が fare_transfer_rules.to_leg_group_id と等しくない場合は禁止です。- fare_transfer_rules.from_leg_group_id が fare_transfer_rules.to_leg_group_id と等しい場合は必須です。 |
||||||||||||
duration_limit |
正の整数 | 任意 | 乗り換えの時間制限を定義します。 秒単位の整数増分で表現しなければなりません。 時間制限がない場合、 fare_transfer_rules.duration_limit は空でなければなりません。 |
||||||||||||
duration_limit_type |
列挙型 | 条件付き必須 | fare_transfer_rules.duration_limit の相対的な開始および終了を定義します。有効な選択肢は次のとおりです: 0 - 乗り換え部分旅程(sub-journey)の最初の乗車区間(leg)の出発時運賃認証と、乗り換え部分旅程(sub-journey)の最後の乗車区間(leg)の到着時運賃認証の間。1 - 乗り換え部分旅程(sub-journey)の最初の乗車区間(leg)の出発時運賃認証と、乗り換え部分旅程(sub-journey)の最後の乗車区間(leg)の出発時運賃認証の間。2 - 乗り換え部分旅程(sub-journey)の最初の乗車区間(leg)の到着時運賃認証と、乗り換え部分旅程(sub-journey)の最後の乗車区間(leg)の出発時運賃認証の間。3 - 乗り換え部分旅程(sub-journey)の最初の乗車区間(leg)の到着時運賃認証と、乗り換え部分旅程(sub-journey)の最後の乗車区間(leg)の到着時運賃認証の間。複数乗車区間の旅程(journey)内で、同じ from_leg_group_id および to_leg_group_id を持つ乗り換えルールが連続して複数回一致する場合、ルールで指定された duration_limit は、最初に一致した乗車区間(leg)から測定するべきです。条件付き必須: - fare_transfer_rules.duration_limit が定義されている場合は必須です。- fare_transfer_rules.duration_limit が空の場合は禁止です。 |
||||||||||||
fare_transfer_type |
列挙型 | 必須 | 旅程(journey)内の乗車区間(leg)間を乗り換える際の費用処理方法を示します: 有効な選択肢は次のとおりです: 0 - 乗り換え元の乗車区間(leg)の fare_leg_rules.fare_product_id に fare_transfer_rules.fare_product_id を加算します。A + AB。1 - 乗り換え元の乗車区間(leg)の fare_leg_rules.fare_product_id に fare_transfer_rules.fare_product_id および乗り換え先の乗車区間(leg)の fare_leg_rules.fare_product_id を加算します。A + AB + B。2 - fare_transfer_rules.fare_product_id。AB。 旅程(journey)内の複数の乗り換え間における費用処理の相互作用:
|
||||||||||||
fare_product_id |
fare_products.fare_product_id を参照する外部 ID |
任意 | 2つの運賃乗車区間間を乗り換えるために必要なチケット商品です。空の場合、乗り換えルールの費用は 0 です。 |
areas.txt¶
ファイル: 任意
主キー(area_id)
エリア識別子を定義します。
| フィールド名 | 型 | 有無 | 説明 |
|---|---|---|---|
area_id |
一意の ID | 必須 | エリアを識別します。areas.txt 内で一意でなければなりません。 |
area_name |
テキスト | 任意 | 乗客に表示されるエリアの名称です。 |
stop_areas.txt¶
ファイル: 任意
主キー (*)
stops.txt の停留所等(stop)をエリアに割り当てます。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
area_id |
areas.area_id を参照する外部 ID |
必須 | 1つまたは複数の stop_id が属するエリアを識別します。同じ stop_id を複数の area_id で定義することができます。 |
stop_id |
stops.stop_id を参照する外部 ID |
必須 | 停留所等(stop)を識別します。駅(すなわち、stops.location_type=1 の停留所等(stop))がこのフィールドで定義されている場合、そのすべてのプラットフォーム(すなわち、stops.parent_station としてこの駅が定義されている、stops.location_type=0 のすべての停留所等(stop))は同じエリアの一部であると見なされます。この動作は、プラットフォームを他のエリアに割り当てることで上書きすることができます。 |
networks.txt¶
ファイル: 条件付きで禁止
主キー (network_id)
運賃区間ルールに適用されるネットワーク識別子を定義します。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
network_id |
一意の ID | 必須 | ネットワークを識別します。networks.txt 内で一意でなければなりません。 |
network_name |
テキスト | 任意 | 地域の事業者およびその乗客が使用する、運賃区間ルールに適用されるネットワークの名称です。 |
route_networks.txt¶
ファイル: 条件付きで禁止
主キー (route_id)
routes.txt のルート・路線系統(route)をネットワークに割り当てます。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
network_id |
networks.network_id を参照する外部 ID |
必須 | 1つまたは複数の route_id が属するネットワークを識別します。route_id は1つの network_id でのみ定義できます。 |
route_id |
routes.route_id を参照する外部 ID |
必須 | ルート・路線系統(route)を識別します。 |
shapes.txt¶
ファイル: 任意
主キー (shape_id, shape_pt_sequence)
ルート形状(shape)は、車両がルート・路線系統(route)の経路に沿って走行する経路を記述するものであり、shapes.txt ファイルで定義されます。ルート形状(shape)は便(trip)に関連付けられ、車両が順番に通過する一連の地点で構成されます。ルート形状(shape)は停留所等(stop)の位置と正確に交差する必要はありませんが、便(trip)上のすべての停留所等(stop)は、その便(trip)のルート形状(shape)から、すなわちルート形状(shape)の地点を結ぶ直線区間の近傍にあるべきです。shapes.txt ファイルは、すべてのルートベースのサービスに含めるべきです(ゾーンベースのデマンド型サービスには不要です)。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
shape_id |
ID | 必須 | ルート形状(shape)を識別します。 |
shape_pt_lat |
緯度 | 必須 | ルート形状(shape)の地点の緯度です。shapes.txt の各レコードは、ルート形状(shape)を定義するために使用されるルート形状(shape)の地点を表します。 |
shape_pt_lon |
経度 | 必須 | ルート形状(shape)の地点の経度です。 |
shape_pt_sequence |
非負整数 | 必須 | ルート形状(shape)を形成するためにルート形状(shape)の地点が接続される順序です。値は便(trip)に沿って増加しなければなりませんが、連続している必要はありません。 例: ルート形状(shape)「A_shp」の定義に3つの地点がある場合、shapes.txt ファイルにはルート形状(shape)を定義するために次のレコードが含まれることがあります。 shape_id,shape_pt_lat,shape_pt_lon,shape_pt_sequence A_shp,37.61956,-122.48161,0 A_shp,37.64430,-122.41070,6 A_shp,37.65863,-122.30839,11 |
shape_dist_traveled |
非負浮動小数点数 | 任意 | 最初のルート形状(shape)の地点から、このレコードで指定された地点まで、ルート形状(shape)に沿って実際に移動した距離です。旅程プランナーが地図上でルート形状(shape)の正しい部分を表示するために使用します。値は shape_pt_sequence とともに増加しなければなりません。ルート・路線系統(route)に沿った逆方向の移動を示すために使用してはいけません。距離の単位は、stop_times.txt で使用される単位と一貫していなければなりません。ループまたはインライン化(車両が1つの便(trip)内で同じ経路部分を横断または走行すること)があるルート・路線系統(route)に推奨されます。 車両が便(trip)の途中で経路を折り返す、または横断する場合、 shape_dist_traveled は、shapes.txt 内の地点の部分が stop_times.txt 内のレコードとどのように対応するかを明確にするために重要です。例: バスが上記で A_shp に対して定義された3つの地点に沿って走行する場合、追加の shape_dist_traveled 値(ここではキロメートルで示します)は次のようになります。 shape_id,shape_pt_lat,shape_pt_lon,shape_pt_sequence,shape_dist_traveledA_shp,37.61956,-122.48161,0,0A_shp,37.64430,-122.41070,6,6.8310 A_shp,37.65863,-122.30839,11,15.8765 |
frequencies.txt¶
ファイル: 任意
主キー (trip_id, start_time)
Frequencies.txt は、一定の運行間隔(便間の時間)で運行する便を表します。このファイルは、2種類の異なるサービスを表すために使用することができます。
- 1日を通して固定された時刻表に従わない、運行間隔ベースのサービス(
exact_times=0)。代わりに、運行事業者は便について事前に定められた運行間隔を厳密に維持しようとします。 - 指定された期間にわたり便の運行間隔が完全に同一である、時刻表ベースのサービス(
exact_times=1)の圧縮表現。時刻表ベースのサービスでは、運行事業者は時刻表を厳密に遵守しようとします。
| フィールド名 | 型 | 有無 | 説明 |
|---|---|---|---|
trip_id |
trips.trip_id を参照する外部 ID |
必須 | 指定された運行間隔のサービスが適用される便を識別します。 |
start_time |
時刻 | 必須 | 指定された運行間隔で、最初の車両が便の最初の停留所等(stop)から出発する時刻です。 |
end_time |
時刻 | 必須 | 便の最初の停留所等(stop)において、サービスが異なる運行間隔に変更される(または終了する)時刻です。 |
headway_secs |
正の整数 | 必須 | start_time と end_time で指定された時間間隔中における、便について同じ停留所等(stop)からの出発間の時間(運行間隔)を秒単位で表します。同じ便に対して複数の運行間隔を定義することができますが、重複してはいけません。新しい運行間隔は、前の運行間隔が終了する正確な時刻に開始することができます。 |
exact_times |
列挙型 | 任意 | 便のサービス種別を示します。詳細についてはファイルの説明を参照してください。有効な選択肢は次のとおりです。0 または空 - 運行間隔ベースの便。1 - 1日を通して運行間隔が完全に同一である時刻表ベースの便。この場合、end_time の値は最後に希望する便の start_time より大きく、かつ最後に希望する便の start_time + headway_secs より小さくなければなりません。 |
transfers.txt¶
ファイル: 任意
主キー (from_stop_id, to_stop_id, from_trip_id, to_trip_id, from_route_id, to_route_id)
旅程を計算する際、GTFSを利用するアプリケーションは、許容される時間および停留所等(stop)の近接性に基づいて乗換を補間します。Transfers.txt は、選択された乗換に対する追加ルールおよび上書きを指定します。
フィールド from_trip_id、to_trip_id、from_route_id、および to_route_id により、乗換ルールの特異性をより高い順序で指定できます。from_stop_id および to_stop_id とともに、特異性の順位は以下のとおりです。
- 両方の
trip_idが定義されている:from_trip_idおよびto_trip_id。 - 1つの
trip_idとroute_idの組が定義されている: (from_trip_idおよびto_route_id) または (from_route_idおよびto_trip_id)。 - 1つの
trip_idが定義されている:from_trip_idまたはto_trip_id。 - 両方の
route_idが定義されている:from_route_idおよびto_route_id。 - 1つの
route_idが定義されている:from_route_idまたはto_route_id。 from_stop_idおよびto_stop_idのみが定義されている: route または trip 関連フィールドは設定されていません。
到着する便(trip)と出発する便(trip)の所与の順序付き組に対して、これら2つの便(trip)間に適用される最も特異性の高い乗換が選択されます。任意の便(trip)の組に対して、適用可能な同等に最大の特異性を持つ乗換が2つ存在してはいけません。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
from_stop_id |
stops.stop_id を参照する外部ID |
条件付き必須 | ルート・路線系統(route)間の接続が開始する停留所等(stop)(location_type=0)または駅(location_type=1)を識別します。このフィールドが駅を参照する場合、乗換ルールはそのすべての子停留所等(stop)に適用されます。transfer_type が 4 または 5 の場合、停留所等(stop)(location_type=0)を参照しなければなりません。条件付き必須: - transfer_type が空、0、1、2、または 3 の場合は必須です。- transfer_type が 4 または 5 の場合は任意です。 |
to_stop_id |
stops.stop_id を参照する外部ID |
条件付き必須 | ルート・路線系統(route)間の接続が終了する停留所等(stop)(location_type=0)または駅(location_type=1)を識別します。このフィールドが駅を参照する場合、乗換ルールはすべての子停留所等(stop)に適用されます。transfer_type が 4 または 5 の場合、停留所等(stop)(location_type=0)を参照しなければなりません。条件付き必須: - transfer_type が空、0、1、2、または 3 の場合は必須です。- transfer_type が 4 または 5 の場合は任意です。 |
from_route_id |
routes.route_id を参照する外部ID |
任意 | 接続が開始するルート・路線系統(route)を識別します。from_route_id が定義されている場合、乗換は、指定された from_stop_id における当該ルート・路線系統(route)の到着便(trip)に適用されます。from_trip_id と from_route_id の両方が定義されている場合、trip_id は route_id に属していなければならず、from_trip_id が優先されます。 |
to_route_id |
routes.route_id を参照する外部ID |
任意 | 接続が終了するルート・路線系統(route)を識別します。to_route_id が定義されている場合、乗換は、指定された to_stop_id における当該ルート・路線系統(route)の出発便(trip)に適用されます。to_trip_id と to_route_id の両方が定義されている場合、trip_id は route_id に属していなければならず、to_trip_id が優先されます。 |
from_trip_id |
trips.trip_id を参照する外部ID |
条件付き必須 | ルート・路線系統(route)間の接続が開始する便(trip)を識別します。from_trip_id が定義されている場合、乗換は、指定された from_stop_id における到着便(trip)に適用されます。from_trip_id と from_route_id の両方が定義されている場合、trip_id は route_id に属していなければならず、from_trip_id が優先されます。条件付き必須: - transfer_type が 4 または 5 の場合は必須です。 - それ以外の場合は任意です。 |
to_trip_id |
trips.trip_id を参照する外部ID |
条件付き必須 | ルート・路線系統(route)間の接続が終了する便(trip)を識別します。to_trip_id が定義されている場合、乗換は、指定された to_stop_id における出発便(trip)に適用されます。to_trip_id と to_route_id の両方が定義されている場合、trip_id は route_id に属していなければならず、to_trip_id が優先されます。 条件付き必須: - transfer_type が 4 または 5 の場合は必須です。 - それ以外の場合は任意です。 |
transfer_type |
列挙型 | 必須 | 指定された (from_stop_id, to_stop_id) の組に対する接続の種類を示します。有効な選択肢は以下のとおりです。0 または空 - ルート・路線系統(route)間の推奨乗換地点です。1 - 2つのルート・路線系統(route)間の時刻指定乗換地点です。出発車両は到着車両を待機し、乗客がルート・路線系統(route)間を乗り換えるために十分な時間を確保して出発することが期待されます。2 - 接続を確保するため、乗換には到着と出発の間に最小限の時間が必要です。乗換に必要な時間は min_transfer_time で指定します。3 - 当該地点では、ルート・路線系統(route)間の乗換はできません。4 - 乗客は、同じ車両に乗車したまま1つの便(trip)から別の便(trip)へ乗り換えることができます(「in-seat transfer」)。この種類の乗換の詳細は以下を参照してください。 5 - 連続する便(trip)間では in-seat transfer は許可されません。乗客は車両から降車し、再乗車しなければなりません。この種類の乗換の詳細は以下を参照してください。 |
min_transfer_time |
非負整数 | 任意 | 指定された停留所等(stop)におけるルート・路線系統(route)間の乗換を許可するために利用可能でなければならない時間(秒)です。min_transfer_time は、各ルート・路線系統(route)の時刻表の変動を考慮するためのバッファ時間を含め、一般的な乗客が2つの停留所等(stop)間を移動できるのに十分であるべきです。 |
連結された便(trip)¶
以下は、座席を移動せずに乗り換える場合とそうでない場合の両方で、便(trip)同士を連結するために使用される transfer_type=4 および =5 に適用されます。
連結される便(trip)は、同じ車両によって運行されなければなりません。車両は、他の車両と連結または切り離しされることができます。
連結された便(trip)の乗り換えと block_id の両方が提供され、それらが矛盾する結果を生成する場合は、連結された便(trip)の乗り換えを使用しなければなりません。
from_trip_id の最後の停留所等(stop)は to_trip_id の最初の停留所等(stop)に地理的に近いべきであり、from_trip_id の最後の到着時刻は to_trip_id の最初の出発時刻より前で、かつ近いべきです。to_trip_id の便(trip)が翌運行日(service day)に発生する場合、from_trip_id の最後の到着時刻は to_trip_id の最初の出発時刻より後であることができます。
通常の場合、便(trip)は1対1で連結することができますが、より複雑な便(trip)の継続を表すために、1対n、n対1、またはn対nで連結することもできます。例えば、共通の駅での車両連結操作の後、2つの列車便(trip)(下図の便(trip) Aおよび便(trip) B)が1つの列車便(trip)(便(trip) C)に統合されることがあります。
- 1対nの継続では、各
to_trip_idのtrips.service_idは同一でなければなりません。 - n対1の継続では、各
from_trip_idのtrips.service_idは同一でなければなりません。 - n対nの継続は、両方の制約を満たさなければなりません。
trip.service_idがいずれの運行日(service day)にも重複してはいけないことを条件として、便(trip)は複数の異なる継続の一部として連結することができます。
便(trip) A
───────────────────\
\ 便(trip) C
─────────────
便(trip) B /
───────────────────/
pathways.txt¶
ファイル: 任意
主キー (pathway_id)
ファイル pathways.txt および levels.txt は、地下鉄または鉄道駅を記述するためにグラフ表現を使用します。ノードは場所を表し、エッジは構内通路(pathway)を表します。
駅の入口・出口(location_type=2 の場所として表されるノード)からプラットフォーム(location_type=0 または空の場所として表されるノード)へ移動するために、乗客は通路、改札口、階段、および構内通路(pathway)として表されるその他のエッジを通過します。汎用ノード(location_type=3 で表されるノード)は、駅全体の構内通路(pathway)を接続するために使用できます。
構内通路(pathway)は、駅の内部アクセスグラフを網羅的に定義することを意図しています。駅内で何らかの構内通路(pathway)が定義されている場合、データ利用者は、その駅内の関連するすべての接続が記述されていると仮定するべきです。ただし、stops.txt の任意の stop_access フィールドを使用して、停留所等(stop)が道路ネットワークから直接アクセス可能か、または駅で定義された構内通路(pathway)を通じてアクセス可能かを明示的に定義できます。したがって、以下のガイドラインが適用されます。
- 孤立した場所を作らない: 駅内のいずれかの場所に構内通路(pathway)がある場合、その駅内のすべての場所には構内通路(pathway)があるべきです。ただし、以下を除きます。
- 乗車エリア(
location_type=4、以下のガイドラインを参照)があるプラットフォーム stops.stop_access=1を持つ停留所等(stop)(location_type=0または空)
- 乗車エリア(
- 乗車エリアがあるプラットフォームには構内通路(pathway)を設定しない: 乗車エリア(
location_type=4)があるプラットフォーム(location_type=0または空)は、点ではなく親オブジェクトとして扱われます。この場合、プラットフォームには構内通路(pathway)を割り当ててはいけません。すべての構内通路(pathway)は、プラットフォームの各乗車エリアに割り当てるべきです。 - 到達不能なプラットフォームを作らない: 駅内のいずれかの場所に構内通路(pathway)がある場合、各プラットフォーム(
location_type=0または空)または乗車エリア(location_type=4)は、構内通路(pathway)の連鎖を介して少なくとも1つの入口・出口(location_type=2)に接続されていなければなりません。ただし、以下の場合を除きます。- 停留所等(stop)(
location_type=0または空)がstops.stop_access=1で明示的にマークされている場合。この場合、道路ネットワークから直接アクセス可能であると見なされます。
- 停留所等(stop)(
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
pathway_id |
一意の ID | 必須 | 構内通路(pathway)を識別します。システムがレコードの内部識別子として使用します。データセット内で一意でなければなりません。 異なる構内通路(pathway)が、 from_stop_id と to_stop_id に同じ値を持つことができます。例: 2つのエスカレーターが反対方向に並んでいる場合、または階段とエレベーターが同じ場所から同じ場所へ移動する場合、異なる pathway_id が同じ from_stop_id および to_stop_id の値を持つことがあります。 |
from_stop_id |
stops.stop_id を参照する外部 ID |
必須 | 構内通路(pathway)が始まる場所です。 プラットフォーム( location_type=0 または空)、入口・出口(location_type=2)、汎用ノード(location_type=3)、または乗車エリア(location_type=4)を識別する stop_id を含めなければなりません。駅( location_type=1)、または stop_access=1 を持つ停留所等(stop)(location_type=0 または空)を識別する stop_id の値は禁止されています。 |
to_stop_id |
stops.stop_id を参照する外部 ID |
必須 | 構内通路(pathway)が終わる場所です。 プラットフォーム( location_type=0 または空)、入口・出口(location_type=2)、汎用ノード(location_type=3)、または乗車エリア(location_type=4)を識別する stop_id を含めなければなりません。駅( location_type=1)、または stop_access=1 を持つ停留所等(stop)(location_type=0 または空)を識別する stop_id の値は禁止されています。 |
pathway_mode |
列挙型 | 必須 | 指定された (from_stop_id, to_stop_id) の組における構内通路(pathway)の種類です。有効な選択肢は以下のとおりです。 1 - 通路。 2 - 階段。 3 - 動く歩道・トラベレーター。 4 - エスカレーター。 5 - エレベーター。 6 - 改札口(または支払いゲート): 支払い証明が必要な駅構内のエリアへ入る構内通路(pathway)です。改札口は、駅の有料エリアと無料エリアを分離する場合や、同じ駅内の異なる支払いエリア同士を分離する場合があります。この情報は、乗客が地下鉄のプラットフォームを通り抜けてバス専用道路へ向かうよう案内するなど、不必要な支払いを必要とする近道を通って駅内を経路探索することを避けるために使用できます。 7- 出場ゲート: 支払い証明が不要な無料エリアへ、有料エリアから出る構内通路(pathway)です。 |
is_bidirectional |
列挙型 | 必須 | 構内通路(pathway)を通行できる方向を示します。0 - from_stop_id から to_stop_id へのみ使用できる一方向の構内通路(pathway)。1 - 両方向に使用できる双方向の構内通路(pathway)。出場ゲート( pathway_mode=7)は双方向であってはいけません。 |
length |
非負の浮動小数点数 | 任意 | 出発場所(from_stop_id で定義)から到着場所(to_stop_id で定義)までの構内通路(pathway)の水平方向の長さ(メートル単位)です。このフィールドは、通路( pathway_mode=1)、改札口(pathway_mode=6)、および出場ゲート(pathway_mode=7)に推奨です。 |
traversal_time |
正の整数 | 任意 | 出発場所(from_stop_id で定義)から到着場所(to_stop_id で定義)まで構内通路(pathway)を歩いて通過するために必要な平均時間(秒単位)です。このフィールドは、動く歩道( pathway_mode=3)、エスカレーター(pathway_mode=4)、およびエレベーター(pathway_mode=5)に推奨です。 |
stair_count |
null でない整数 | 任意 | 構内通路(pathway)の階段数です。 正の stair_count は、乗客が from_stop_id から to_stop_id へ上ることを意味します。負の stair_count は、乗客が from_stop_id から to_stop_id へ下ることを意味します。このフィールドは、階段( pathway_mode=2)に推奨です。推定された階段数しか提供できない場合、1階あたり15段として近似することが推奨です。 |
max_slope |
浮動小数点数 | 任意 | 構内通路(pathway)の最大勾配比です。有効な選択肢は以下のとおりです。0 または空 - 勾配なし。Float - 構内通路(pathway)の勾配比。上りは正、下りは負です。このフィールドは、通路( pathway_mode=1)および動く歩道(pathway_mode=3)でのみ使用するべきです。例: 米国では、0.083(8.3% とも表記)は手動車いすの最大勾配比であり、1m ごとに 0.083m(すなわち 8.3cm)上昇することを意味します。 |
min_width |
正の浮動小数点数 | 任意 | 構内通路(pathway)の最小幅(メートル単位)です。 最小幅が1メートル未満の場合、このフィールドが推奨です。 |
signposted_as |
テキスト | 任意 | 乗客に見える物理的な案内標識上の一般向けテキストです。follow signs to のように、乗客へのテキストによる案内を提供するために使用できます。singposted_as のテキストは、標識に印刷されているとおりに正確に表示されるべきです。物理的な案内標識が多言語の場合、このフィールドには feed_info.feed_lang のフィールド定義における stops.stop_name の例に従って値を設定し、翻訳することができます。 |
reversed_signposted_as |
テキスト | 任意 | signposted_as と同じですが、構内通路(pathway)を to_stop_id から from_stop_id へ使用する場合のものです。 |
levels.txt¶
ファイル: 条件付き必須
主キー (level_id)
駅構内の階層を記述します。pathways.txt と併用すると有用です。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
level_id |
一意の ID | 必須 | 駅構内の階層を識別します。 |
level_index |
Float | 必須 | 階層の相対的な位置を示す数値インデックスです。 地上階のインデックスは 0 とするべきであり、地上より上の階層は正のインデックス、地上より下の階層は負のインデックスで示します。 |
level_name |
Text | 任意 | 建物または駅構内で乗客が目にする階層の名称です。 例: エレベーターで「中二階」、「プラットフォーム」、または「-1」へ移動します。 |
location_groups.txt¶
ファイル: 任意
主キー (location_group_id)
乗客が乗車または降車をリクエストできる停留所等(stop)のグループである、ロケーショングループを定義します。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
location_group_id |
一意の ID | 必須 | ロケーショングループを識別します。ID は、すべての stops.stop_id、locations.geojson の id、および location_groups.location_group_id の値全体で一意でなければなりません。ロケーショングループは、乗客が乗車または降車をリクエストできる場所をまとめて示す停留所等(stop)のグループです。 |
location_group_name |
テキスト | 任意 | 乗客に表示されるロケーショングループの名称です。 |
location_group_stops.txt¶
ファイル: 任意
主キー (*)
stops.txt の停留所等(stop)をロケーショングループに割り当てます。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
location_group_id |
location_groups.location_group_id を参照する外部 ID |
必須 | 1つまたは複数の stop_id が属するロケーショングループを識別します。同じ stop_id を複数の location_group_id で定義することができます。 |
stop_id |
stops.stop_id を参照する外部 ID |
必須 | ロケーショングループに属する停留所等(stop)を識別します。 |
locations.geojson¶
ファイル: 任意
乗客がデマンド型サービスによる乗車または降車をリクエストできるゾーンを定義します。これらのゾーンはGeoJSONポリゴンとして表現されます。
- このファイルは、RFC 7946で説明されているGeoJSON形式のサブセットを使用します。
- 各ポリゴンは、OpenGIS Simple Features Specification, section 6.1.11の定義により有効でなければなりません。
locations.geojsonファイルにはFeatureCollectionを含めなければなりません。FeatureCollectionは、乗客が乗車または降車をリクエストできるさまざまな停留所等(stop)の位置を定義します。- すべてのGeoJSON
Featureにはidがなければなりません。idは、すべてのstops.stop_id、locations.geojsonのid、およびlocation_group_id値にわたって一意でなければなりません。 - すべてのGeoJSON
Featureは、以下の表に従ったオブジェクトおよび関連するキーを持つべきです。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
- type |
String | 必須 | 位置の"FeatureCollection"。 |
- features |
Array | 必須 | 位置を記述する"Feature"オブジェクトのコレクション。 |
- type |
String | 必須 | "Feature" |
- id |
String | 必須 | 位置を識別します。IDは、すべてのstops.stop_id、locations.geojsonのid、およびlocation_groups.location_group_id値にわたって一意でなければなりません。 |
- properties |
Object | 必須 | 位置のプロパティキー。 |
- stop_name |
String | 任意 | 乗客に表示される位置の名称を示します。 |
- stop_desc |
String | 任意 | 乗客の位置把握を支援する、位置に関する意味のある説明。 |
- geometry |
Object | 必須 | 位置のジオメトリ。 |
- type |
String | 必須 | 次の型でなければなりません: - "Polygon"- "MultiPolygon" |
- coordinates |
Array | 必須 | 位置のジオメトリを定義する地理座標(緯度および経度)。 |
booking_rules.txt¶
ファイル: 任意
主キー (booking_rule_id)
乗客がリクエストするサービスの予約ルールを定義します
| フィールド名 | 型 | 存在要件 | 説明 |
|---|---|---|---|
booking_rule_id |
一意のID | 必須 | ルールを識別します。 |
booking_type |
Enum | 必須 | 予約可能な期間を示します。有効な選択肢は以下のとおりです。0 - リアルタイム予約。1 - 事前通知を伴う当日までの予約。2 - 前日以前までの予約。 |
prior_notice_duration_min |
Integer | 条件付き必須 | リクエストを行うために移動前に必要な最小分数。 条件付き必須: - booking_type=1 の場合は必須です。- それ以外の場合は禁止です。 |
prior_notice_duration_max |
Integer | 条件付き禁止 | 予約リクエストを行うために移動前に許容される最大分数。 条件付き禁止: - booking_type=0 および booking_type=2 の場合は禁止です。- booking_type=1 の場合は任意です。 |
prior_notice_last_day |
Integer | 条件付き必須 | 予約リクエストを行うための移動前の最終日。 例: 「乗車は1日前の午後5時までに予約しなければなりません」は、 prior_notice_last_day=1 としてエンコードされます。条件付き必須: - booking_type=2 の場合は必須です。- それ以外の場合は禁止です。 |
prior_notice_last_time |
Time | 条件付き必須 | 予約リクエストを行うための移動前の最終日における最終時刻。 例: 「乗車は1日前の午後5時までに予約しなければなりません」は、 prior_notice_last_time=17:00:00 としてエンコードされます。条件付き必須: - prior_notice_last_day が定義されている場合は必須です。- それ以外の場合は禁止です。 |
prior_notice_start_day |
Integer | 条件付き禁止 | 予約リクエストを行うための移動前の最も早い日。 例: 「乗車は最も早くて1週間前の午前0時から予約できます」は、 prior_notice_start_day=7 としてエンコードされます。条件付き禁止: - booking_type=0 の場合は禁止です。- prior_notice_duration_max が定義されている場合、booking_type=1 では禁止です。- それ以外の場合は任意です。 |
prior_notice_start_time |
Time | 条件付き必須 | 予約リクエストを行うための移動前の最も早い日における最も早い時刻。 例: 「乗車は最も早くて1週間前の午前0時から予約できます」は、 prior_notice_start_time=00:00:00 としてエンコードされます。条件付き必須: - prior_notice_start_day が定義されている場合は必須です。- それ以外の場合は禁止です。 |
prior_notice_service_id |
calendar.service_id を参照する外部ID |
条件付き禁止 | prior_notice_last_day または prior_notice_start_day を数える運行日(service day)を示します。例: 空の場合、 prior_notice_start_day=2 は2暦日前となります。休日を除く平日のみを含む service_id として定義されている場合、prior_notice_start_day=2 は2営業日前となります。条件付き禁止: - booking_type=2 の場合は任意です。- それ以外の場合は禁止です。 |
message |
Text | 任意 | オンデマンドの乗車・降車を予約する際に、stop_time でサービスを利用する乗客へのメッセージです。乗客がサービスを利用するために取る必要がある行動について、ユーザーインターフェース内で伝達される最小限の情報を提供することを目的としています。 |
pickup_message |
Text | 任意 | message と同様に機能しますが、乗客がオンデマンド乗車のみを利用する場合に使用されます。 |
drop_off_message |
Text | 任意 | message と同様に機能しますが、乗客がオンデマンド降車のみを利用する場合に使用されます。 |
phone_number |
Phone number | 任意 | 予約リクエストを行うために電話する電話番号。 |
info_url |
URL | 任意 | 予約ルールに関する情報を提供するURL。 |
booking_url |
URL | 任意 | 予約リクエストを行うことができるオンラインインターフェースまたはアプリのURL。 |
translations.txt¶
ファイル: 任意
主キー (table_name, field_name, language, record_id, record_sub_id, field_value)
複数の公用語がある地域では、交通事業者・運行事業者は通常、言語固有の名称やWebページを持っています。そのような地域の乗客に最適なサービスを提供するため、データセットにこれらの言語依存の値を含めることが有用です。
同じ値を翻訳するために、参照方法(record_id、record_sub_id)とfield_valueの両方が異なる2つの行で使用されている場合、(record_id、record_sub_id)で提供された翻訳が優先されます。
| フィールド名 | 型 | 存在要件 | 説明 |
|---|---|---|---|
table_name |
Enum | 必須 | 翻訳対象のフィールドを含むテーブルを定義します。許可される値は以下のとおりです。 - agency- stops- routes- trips- stop_times- pathways- levels- feed_info- attributionsGTFSに追加されるすべてのファイルは、上記の一覧にあるファイル名と同等の table_name値を持ちます(つまり、.txtファイル拡張子は含みません)。 |
field_name |
Text | 必須 | 翻訳対象のフィールド名です。型がTextのフィールドは翻訳することができます。型がURL、Email、Phone numberのフィールドも、適切な言語のリソースを提供するために「翻訳」することができます。その他の型のフィールドは翻訳するべきではありません。 |
language |
Language code | 必須 | 翻訳の言語です。 言語が feed_info.feed_langと同じ場合、フィールドの元の値は、特定の翻訳がない言語で使用するデフォルト値であると見なされます(default_langで別途指定されている場合を除きます)。例: スイスでは、公式に二言語使用の州にある都市は公式には「Biel/Bienne」と呼ばれますが、フランス語では単に「Bienne」、ドイツ語では「Biel」と呼ばれます。 |
translation |
Text or URL or Email or Phone number | 必須 | 翻訳された値です。 |
record_id |
Foreign ID | 条件付き必須 | 翻訳対象のフィールドに対応するレコードを定義します。record_idの値は、各テーブルの主キー属性および以下で定義される、テーブルの主キーの最初のフィールドまたは唯一のフィールドでなければなりません。- agency.txtの agency_id- stops.txtの stop_id- routes.txtの route_id- trips.txtの trip_id- stop_times.txtの trip_id- pathways.txtの pathway_id- levels.txtの level_id- attributions.txtの attribution_id上記で定義されていないテーブルのフィールドは翻訳するべきではありません。ただし、作成者が公式仕様の範囲外である追加フィールドを加える場合があり、これらの非公式フィールドは翻訳することができます。これらのテーブルにおける record_idの推奨される使用方法を以下に示します。- calendar.txtの service_id- calendar_dates.txtの service_id- fare_attributes.txtの fare_id- fare_rules.txtの fare_id- shapes.txtの shape_id- frequencies.txtの trip_id- transfers.txtの from_stop_id条件付き必須: - table_nameがfeed_infoの場合は禁止です。- field_valueが定義されている場合は禁止です。- field_valueが空の場合は必須です。 |
record_sub_id |
Foreign ID | 条件付き必須 | テーブルに一意のIDがない場合に、翻訳対象のフィールドを含むレコードを特定するのに役立ちます。したがって、record_sub_idの値は、以下のテーブルで定義されるテーブルの副IDです。- agency.txtではなし - stops.txtではなし - routes.txtではなし - trips.txtではなし - stop_times.txtの stop_sequence- pathways.txtではなし - levels.txtではなし - attributions.txtではなし 上記で定義されていないテーブルのフィールドは翻訳するべきではありません。ただし、作成者が公式仕様の範囲外である追加フィールドを加える場合があり、これらの非公式フィールドは翻訳することができます。これらのテーブルにおける record_sub_idの推奨される使用方法を以下に示します。- calendar.txtではなし - calendar_dates.txtの date- fare_attributes.txtではなし - fare_rules.txtの route_id- shapes.txtではなし - frequencies.txtの start_time- transfers.txtの to_stop_id条件付き必須: - table_nameがfeed_infoの場合は禁止です。- field_valueが定義されている場合は禁止です。- table_name=stop_timesかつrecord_idが定義されている場合は必須です。 |
field_value |
Text or URL or Email or Phone number | 条件付き必須 | record_idおよびrecord_sub_idを使用して翻訳対象のレコードを定義する代わりに、このフィールドを使用して翻訳対象の値を定義することができます。使用する場合、table_nameおよびfield_nameで識別されるフィールドがfield_valueで定義された値と完全に同じ値を含むときに、翻訳が適用されます。フィールドは、 field_valueで定義された値と完全に一致しなければなりません。値の一部のみがfield_valueと一致する場合、翻訳は適用されません。2つの翻訳ルールが同じレコードに一致する場合(1つは field_valueを使用し、もう1つはrecord_idを使用する場合)、record_idを使用するルールが優先されます。条件付き必須: - table_nameがfeed_infoの場合は禁止です。- record_idが定義されている場合は禁止です。- record_idが空の場合は必須です。 |
feed_info.txt¶
ファイル: 条件付き必須
主キー(なし)
このファイルには、データセットが記述するサービスではなく、データセット自体に関する情報が含まれます。場合によっては、データセットの発行者は、いずれの事業者とも異なる組織です。
| フィールド名 | 型 | 存在要件 | 説明 |
|---|---|---|---|
feed_publisher_name |
テキスト | 必須 | データセットを発行する組織の正式名称です。これは agency.agency_name の値のいずれかと同じであることがあります。 |
feed_publisher_url |
URL | 必須 | データセットを発行する組織のウェブサイトのURLです。これは agency.agency_url の値のいずれかと同じであることがあります。 |
feed_lang |
言語コード | 必須 | このデータセット内のテキストに使用されるデフォルト言語です。この設定は、GTFSコンシューマーがデータセットに対する大文字・小文字の規則やその他の言語固有の設定を選択するのに役立ちます。テキストをデフォルト以外の言語に翻訳する必要がある場合は、ファイル translations.txt を使用できます。複数の言語で原文テキストが提供されるデータセットでは、デフォルト言語を多言語とすることができます。そのような場合、 feed_lang フィールドには規格 ISO 639-2 で定義された言語コード mul を含め、データセットで使用される各言語の翻訳を translations.txt で提供するべきです。データセット内のすべての原文テキストが同じ言語である場合、mul を使用するべきではありません。例: スイスのような多言語国家のデータセットを考えます。そこでは、元の stops.stop_name フィールドに異なる言語の停留所等(stop)名が設定されています。各停留所等(stop)名は、その停留所等(stop)の地理的位置における主要言語に従って記述されます。例えば、フランス語圏の都市ジュネーブでは Genève、ドイツ語圏の都市チューリッヒでは Zürich、バイリンガルの都市ビール/ビエンヌでは Biel/Bienne です。データセットの feed_lang は mul とし、翻訳は translations.txt で提供されます。ドイツ語では Genf、Zürich、Biel、フランス語では Genève、Zurich、Bienne、イタリア語では Ginevra、Zurigo、Bienna、英語では Geneva、Zurich、Biel/Bienne です。 |
default_lang |
言語コード | 任意 | データコンシューマーが乗客の言語を把握していない場合に使用するべき言語を定義します。多くの場合、en(英語)です。 |
feed_start_date |
日付 | 推奨 | データセットは、feed_start_date の日の開始から feed_end_date の日の終了までの期間におけるサービスについて、完全かつ信頼できるスケジュール情報を提供します。利用できない場合は、両方の日を空欄のままにすることができます。両方が指定されている場合、feed_end_date の日付は feed_start_date の日付より前であってはいけません。データセット提供者は、将来のサービスの見込みを示すためにこの期間外のスケジュールデータを提供することが推奨されますが、データセットコンシューマーは、その非公式な性質を考慮して扱うべきです。feed_start_date または feed_end_date が calendar.txt および calendar_dates.txt で定義される有効なカレンダー日付を超える場合、データセットは、feed_start_date または feed_end_date の範囲内であるものの有効なカレンダー日付に含まれない日付にはサービスがないことを明示的に表明しています。 |
feed_end_date |
日付 | 推奨 | (上記を参照) |
feed_version |
テキスト | 推奨 | 現在のGTFSデータセットのバージョンを示す文字列です。GTFSを利用するアプリケーションは、この値を表示して、データセット発行者が最新のデータセットが取り込まれたかどうかを判断できるようにすることができます。 |
feed_contact_email |
メールアドレス | 任意 | GTFSデータセットおよびデータ公開の慣行に関する連絡用メールアドレスです。feed_contact_email は、GTFSを利用するアプリケーション向けの技術的な連絡先です。カスタマーサービスの連絡先情報は agency.txt を通じて提供してください。feed_contact_email または feed_contact_url の少なくとも一方を提供することが推奨されます。 |
feed_contact_url |
URL | 任意 | GTFSデータセットおよびデータ公開の慣行に関する連絡のための、連絡先情報、ウェブフォーム、サポートデスク、またはその他のツールのURLです。feed_contact_url は、GTFSを利用するアプリケーション向けの技術的な連絡先です。カスタマーサービスの連絡先情報は agency.txt を通じて提供してください。feed_contact_url または feed_contact_email の少なくとも一方を提供することが推奨されます。 |
attributions.txt¶
ファイル: 任意
主キー (attribution_id)
このファイルは、データセットに適用される帰属情報を定義します。
| フィールド名 | 型 | 存在 | 説明 |
|---|---|---|---|
attribution_id |
一意の ID | 任意 | データセットまたはそのサブセットに対する帰属情報を識別します。これは主に翻訳に役立ちます。 |
agency_id |
agency.agency_id を参照する外部 ID |
任意 | 帰属情報が適用される事業者。 1つの agency_id、route_id、または trip_id の帰属情報が定義されている場合、他のものは空でなければなりません。いずれも指定されていない場合、帰属情報はデータセット全体に適用されます。 |
route_id |
routes.route_id を参照する外部 ID |
任意 | 帰属情報がルート・路線系統(route)に適用される点を除き、agency_id と同じように機能します。同じルート・路線系統(route)に複数の帰属情報を適用することができます。 |
trip_id |
trips.trip_id を参照する外部 ID |
任意 | 帰属情報が便(trip)に適用される点を除き、agency_id と同じように機能します。同じ便(trip)に複数の帰属情報を適用することができます。 |
organization_name |
テキスト | 必須 | データセットの帰属先となる組織の名称。 |
is_producer |
列挙型 | 任意 | 組織の役割がプロデューサーであることを示します。有効な選択肢は以下のとおりです。0 または空 - 組織はこの役割を持ちません。1 - 組織はこの役割を持ちます。is_producer、is_operator、または is_authority のフィールドのうち、少なくとも1つを 1 に設定するべきです。 |
is_operator |
列挙型 | 任意 | 組織の役割がオペレーターである点を除き、is_producer と同じように機能します。 |
is_authority |
列挙型 | 任意 | 組織の役割が当局である点を除き、is_producer と同じように機能します。 |
attribution_url |
URL | 任意 | 組織の URL。 |
attribution_email |
メールアドレス | 任意 | 組織のメールアドレス。 |
attribution_phone |
電話番号 | 任意 | 組織の電話番号。 |