コンテンツにスキップ

参照

General Transit Feed Specificationリファレンス

2024年8月16日に改訂されました。詳細については、改訂履歴を参照してください。

このドキュメントでは、GTFS データセットを構成するファイルの形式と構造を定義します。

目次

  1. ドキュメントの規則
  2. データセット ファイル
  3. ファイル要件
  4. データセットの公開と一般的なプラクティス
  5. フィールド定義

ドキュメントの規則

このドキュメント内のキーワード「しなければならない」、「してはいけない」、「必須」、「しなければならない」、「してはならない」、「するべきである」、「するべきではない」、「推奨」、「してもよい」、および「任意」は、RFC 2119 で説明されているとおりに解釈されます。

用語定義

このセクションでは、このドキュメント全体で使用される用語を定義します。

  • データセット - この仕様リファレンスで定義されるファイルの完全なセット。データセットを変更すると、データセットの新しいバージョンが作成されます。データセットは、zip ファイル名を含むパブリックの永続的な URL で公開するべきである必要があります。(例: https://www.agency.org/gtfs/gtfs.zip)。
  • レコード - 単一のエンティティ (交通事業者、停留所、ルートなど) を説明するさまざまなフィールド値で構成される基本データ構造。表では行として表されます。
  • フィールド - オブジェクトまたはエンティティのプロパティ。表では列として表されます。フィールドは、ファイルにヘッダーとして追加された場合に存在します。フィールド値が定義されてしてもよいと定義されてしてもよい。
  • フィールド値 - フィールド内の個々のエントリ。表では 1 つのセルとして表されます。
  • サービス日 - サービス日は、ルートのスケジュールを示すために使用される期間です。サービス日の正確な定義は事業者によって異なりますが、サービス日は暦日と一致しないことがよくありしてもよい。たとえば、金曜日の 08:00:00 から土曜日の 02:00:00 まで実行されるサービスは、1つのサービス日に 08:00:00 から 26:00:00 まで実行されると示される場合があります。
  • テキスト読み上げフィールド - このフィールドには、親フィールドと同じ情報が含まれている必要があります (親フィールドが空の場合は、親フィールドが参照されます)。このフィールドは、テキスト読み上げを目的としているため、省略形は削除するか (「St」は「Street」または「Saint」と読み上げます。「Elizabeth I」は「Elizabeth the first」と読み上げます)、そのまま読み上げます (「JFK Airport」は省略形として読み上げます)。
  • 区間 - 乗客が旅行中の 2 つの連続する場所の間で乗降する便。
  • 旅程 - 出発地から目的地までの全体的な旅行で、途中のすべての区間と乗り換えが含まれます。
  • サブ旅程 - 旅程のサブセットを構成する 2 つ以上の区間。
  • チケット商品 - 旅行の支払いや検証に使用できる購入可能なチケット商品。

存在

フィールドとファイルに適用可能な存在条件:

  • 必須- フィールドまたはファイルはデータセットに含まれ、各レコードに有効な値が含まれているしなければならない。
  • 任意- フィールドまたはファイルは、データセットから省略してもよい。
  • 条件付きで必須- フィールドまたはファイルは、フィールドまたはファイルの説明に記載されている条件に従って含めるしなければならないがあります。
  • 条件付きで禁止- フィールドまたはファイルは、フィールドまたはファイルの説明に記載されている条件に従って含めしてはいけないでください。
  • 推奨- フィールドまたはファイルはデータセットから省略してもよいが、含めることがベストプラクティスです。このフィールドまたはファイルを省略する前に、ベストプラクティスを慎重に評価し、省略による影響を完全に理解するするべきである。

フィールドタイプ

  • 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- 通貨金額を示す小数値。小数点以下の桁数は、付随する通貨コードの ISO 4217 で指定されています。すべての財務計算は、データの使用に使用するプログラミング言語に応じて、小数点、通貨、または財務計算に適した同等の型として処理するするべきである。計算中に金銭の損益が発生する可能性があるため、通貨金額をfloat小数点として処理することは推奨されません。
  • Date- YYYYMMDD 形式のサービス日。サービス日内の時刻は 24:00:00 を超えるしてもよいため、サービス日には後続の日の情報が含まれるしてもよい。
    例: 2018 年 9 月 13 日の場合は20180913。
  • Email- 電子メール アドレス。
    例: example@example.com
  • Enum- 説明列で定義された定義済み定数のセットからの任意。
    例: route_typeフィールドには、路面電車の場合は 0、地下鉄の場合は1す`...
  • ID- ID フィールドの値は内部 ID であり、乗客に表示されることは意図されておらず、UTF-8 文字のシーケンスです。印刷可能な ASCII 文字のみを使用することをお勧めします。ファイル内で一意である必要がある ID には、「一意の ID」というラベルが付けられます。1 つの .txt ファイルで定義された ID は、別の .txt ファイルで参照されることがよくあります。別のテーブルの ID を参照する ID には、「外部 ID」というラベルが付けられます。
    例: stops.txt の stop_id フィールドは「一意の ID」です。stops.txt の parent_station フィールドは、「stops.stop_id を参照する外部 ID」です。
  • Language code- IETF BCP 47 言語コード。IETF BCP 47 の概要については、http://www.rfc-editor.org/rfc/bcp/bcp47 .txt および http://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 も使用できます)。時間は、サービス日の「正午から 12 時間前」から計測されます (夏時間の変更が行われる日を除いて、実質的には真夜中)。サービス日の真夜中以降の時間については、HH:MM:SS で 24:00:00 より大きい値として時間を入力します。
    例: 2:30PM の場合は 14:30:00、翌日の 1:35AM の場合は 25:35:00。
  • Text- UTF-8 文字の文字string。表示を目的としているため、人間が判読できるしなければならないタイムゾーン- 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 を参照してください。

フィールドの符号

浮動小数点または整数フィールド タイプに適用可能な符号:

  • 非負 - 0 以上。
  • 非ゼロ - 0 と等しくない。
  • 正 - 0 より大きい。

例: 非負浮動小数点 - 0 以上の浮動小数点数。

データセットの属性

データセットの **

主キー** は、行を一意に識別するフィールドまたはフィールドの組み合わせです。主キー (*) は、ファイルに提供されているすべてのフィールドを使用して行を一意に識別する場合に使用されます。主キー (なし) は、ファイルに 1 行のみが許可されることを意味します。

例: trip_id フィールドと stop_sequence フィールドは、stop_times.txt の主キーになります。

データセット ファイル

この仕様では、次のファイルを定義します:

ファイル名 存在 説明
agency.txt 必須 このデータセットで表されるサービスを提供する交通事業者。
stops.txt 条件付きで必須 車両が乗客を乗降させる停留所等。駅と駅の入口も定義します。

条件付きで必須:
- locations.geojson で需要対応ゾーンが定義されている場合は任意。
-それ以外の場合は必須。
routes.txt 必須 交通ルート・路線系統。ルートは、乗客に単一のサービスとして表示される便のグループです。
trips.txt 必須 各ルートの便。便とは、特定の期間内に発生する 2 つ以上の停留所等のシーケンスです。
stop_times.txt 必須 各便で車両が停留所等に到着および出発する時刻。
calendar.txt 条件付きで必須 開始日と終了日を含む週間スケジュールを使用して指定された運行日。

条件付きで必須:
- calendar_dates.txt ですべてのサービス日付が定義されていない限り、必須です。
- それ以外の場合は任意。
calendar_dates.txt 条件付きで必須 calendar.txt で定義されたサービスの例外。

条件付きで必須:
-** calendar.txt が省略されている場合は必須。その場合、calendar_dates.txt にはサービスの日付がすべて含まれているしなければならない。
- それ以外の場合は任意。
fare_attributes.txt 任意 交通事業者のルート・路線系統の運賃情報。
fare_rules.txt 任意 旅程に運賃を適用するルール。
timeframes.txt 任意 dateと時間の要素に依存する運賃の運賃ルールで使用するdateと時間の期間。
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 任意 個々の旅行区間の運賃規則。

ファイル fare_leg_rules.txt は、運賃構造をモデル化するためのより詳細な方法を提供します。そのため、fare_leg_rules.txt の使用は、ファイル fare_attributes.txt および fare_rules.txt とは完全に別です。
fare_transfer_rules.txt 任意 旅行区間間の乗り換えに関する運賃規則。

fare_leg_rules.txt とともに、ファイル fare_transfer_rules.txt は、運賃構造をモデル化するより詳細な方法を提供します。そのため、fare_transfer_rules.txt の使用は、ファイル fare_attributes.txt および fare_rules.txt とは完全に別です。
areas.txt 任意 場所のエリアグループ化。
stop_areas.txt 任意 停留所等をエリアに割り当てるルール。
networks.txt 条件付きで禁止 ルートのネットワーク グループ化。

条件付きで禁止:
- network_id が routes.txt に存在する場合は 禁止。
- それ以外の場合は任意。
route_networks.txt 条件付きで禁止 ルートをネットワークに割り当てるルール。

条件付きで禁止:
- network_id が routes.txt に存在する場合は 禁止。
- それ以外の場合は任意。
shapes.txt 任意 車両の移動経路をマッピングするためのルール。ルート配置と呼ばれることもあります。
frequencies.txt 任意 ヘッドウェイベースのサービスのヘッドウェイ (便間の時間) または固定スケジュールサービスの圧縮表現。
transfers.txt 任意 ルート・路線系統間の乗り換えポイントで接続を行うためのルール。
pathways.txt 任意 駅内の場所をリンクする構内通路。
levels.txt 条件付きで必須 駅内の階・フロア。

条件付きで必須:
- エレベーター付きの構内通路を記述する場合 (pathway_mode=5 )必須。
- それ以外の場合は任意。
location_groups.txt 任意 乗客が乗車または降車をリクエストしてもよい場所を示す停留所等のグループ。
location_group_stops.txt 任意 停留所等を場所グループに割り当てるルール。
locations.geojson 任意 オンデマンド サービスによる乗客の乗車または降車リクエストのゾーン。GeoJSON ポリゴンとして表されます。
booking_rules.txt 任意 乗客がリクエストしたサービスの予約情報。
translations.txt 任意 顧客向けのデータセット値の翻訳。
feed_info.txt 条件付きで必須 発行者、バージョン、有効期限情報を含むデータセットのメタデータ。

条件付きで必須:
- translations.txt が提供されている場合は必須です。
- それ以外の場合は推奨。
attributions.txt 任意 データセットの帰属帰属組織。

ファイル要件

データセット ファイルの形式と内容には、次の要件が適用されます。

  • すべてのファイルは、カンマ区切りのTextとして保存するしなければならない。
  • 各ファイルの最初の行には、フィールド名が含まれているしなければならない。フィールド定義 セクションの各サブセクションは、GTFS データセット内のファイルの 1 つに対応し、そのファイルで使用してもよいフィールド名をリストします。
  • すべてのファイル名とフィールド名は、大文字と小文字が区別されます。
  • フィールド値には、タブ、復帰改行、または改行を含めるしてはいけない。
  • 引用符またはカンマを含むフィールド値は、引用符で囲むしなければならない。また、フィールド値内の各引用符の前には引用符を付けるしなければならない。これは、Microsoft Excel がカンマ区切り (CSV) ファイルを出力する方法と一致しています。 CSV ファイル形式の詳細については、http://tools.ietf.org/html/rfc4180 を参照してください。次の例は、フィールド値がコンマ区切りファイルでどのように表示されるかを示しています:
  • 元のフィールド値: 「引用符」、カンマ、テキストが含まれています
  • CSV ファイル内のフィールド値: 「「引用符」、カンマ、テキストが含まれています」
  • フィールド値には、HTML タグ、コメント、またはエスケープ シーケンスを含めるしてはいけない。
  • フィールド間またはフィールド名間の余分なスペースは削除するするべきである。多くのパーサーは、スペースを値の一部と見なすため、エラーが発生するしてもよい。
  • 各行は、CRLF または LF 改行文字で終了するしなければならない。
  • すべての Unicode 文字をサポートするには、ファイルを UTF-8 でエンコードするするべきである。Unicode バイト オーダー マーク (BOM) 文字を含むファイルは許容されます。 BOM 文字と UTF-8 の詳細については、http://unicode.org/faq/utf_bom.html#BOM を参照してください。
  • すべてのデータセット ファイルは、まとめて zip 圧縮するしなければならない。ファイルは、サブフォルダーではなく、ルート レベルに直接配置するしなければならない。
  • 顧客向けのすべてのテキスト文字列（停留所名、路線名、ヘッドサインを含む）では、小文字を表示できるディスプレイ上の地名の大文字表記に関する現地の慣例に従い、大文字と小文字を混在させる（すべて大文字にしない）必要があります（例：「Brighton Churchill Square」、「Villiers-sur-Marne」、「Market Street」）。
  • フィード全体を通じて、名前やその他のテキストに略語を使用することは避けてください (例: Street の代わりに St. を使用するなど)。ただし、場所が略称で呼ばれる場合は除きます (例: 「JFK 空港」)。略語は、スクリーン リーダー ソフトウェアや音声ユーザー インターフェイスによるアクセシビリティに問題が生じる可能性があります。使用ソフトウェアは、完全な単語を略語に確実に変換して表示するように設計できますが、略語から完全な単語に変換すると、エラーが発生するリスクが高くなります。

データセットの公開と一般的なプラクティス

  • データセットは、zip ファイル名を含むパブリックの永続的な URL で公開するするべきである。(例: www.agency.org/gtfs/gtfs.zip) 理想的には、使用ソフトウェア アプリケーションによるダウンロードを容易にするために、ファイルにアクセスするためにログインする必要なく、URL を直接ダウンロードできるするべきである。 GTFS データセットはオープンにダウンロード可能にすることが推奨（最も一般的な方法）が、データ プロバイダーがライセンスやその他の理由で GTFS へのアクセスを制御する必要がある場合は、自動ダウンロードを容易にする API キーを使用して GTFS データセットへのアクセスを制御することが推奨。
  • GTFS データは、安定した場所にある 1 つのファイルに、交通事業者（または複数の交通事業者）のサービスの最新の公式説明が常に含まれるように、反復して公開するするべきであるがあります。
  • データセットは、可能な限り、データの反復をまたいでstop_id、 route_id、およびagency_idの永続的な識別子（ IDフィールド）を維持するするべきである。
  • 1 つの GTFS データセットには、現在のサービスと今後のサービス（マージされたデータセットと呼ばれることもあります）を含める必要がするべきである。 2 つの異なる GTFS フィードから結合されたデータセットを作成するために使用できる マージ ツール が複数あります。
    • 公開された GTFS データセットは、いつでも少なくとも今後 7 日間は有効であるするべきである。理想的には、運行会社がスケジュールが継続して運用されると確信している限り有効です。
    • 可能であれば、GTFS データセットは少なくとも今後 30 日間のサービスをカバーするするべきである。
  • 古いサービス (期限切れのカレンダー) はフィードから削除するするべきである。
  • サービスのModificationが7 日以内に有効になる場合は、このサービスの変更は、静的な GTFS データセットではなく、GTFS リアルタイム フィード (サービス アドバイザリまたは便更新) を通じて表現するするべきである。
  • GTFS データをホストする Web サーバーは、ファイル Modificationdate を正しく報告するように構成するするべきである(HTTP/1.1 - Request for Comments 2616, under Section 14.29).

フィールド定義

agency.txt

ファイル: 必須

主キー(agency_id)

フィールド名 タイプ 存在 説明
agency_id ユニーク ID 条件付きで必須 交通事業者と同義であることが多い交通ブランドを識別します。 1 つの事業者が複数の個別のサービスを運営している場合など、事業者とブランドは異なる場合があることに注意してください。 このドキュメントでは、ブランドの代わりに事業者という用語を使用します。 データセットには、複数の事業者のデータが含まれるしてもよい。

条件付きで必須:
- データセットに複数の交通事業者のデータが含まれている場合は必須です。
- それ以外の場合は推奨。
agency_name Text 必須 交通事業者の正式名称。
agency_url URL 必須 交通事業者の URL。
agency_timezone タイムゾーン 必須 交通事業者が所在するタイムゾーン。データセットで複数の事業者が指定されている場合、それぞれに同じagency_timezoneがしなければならない。
agency_lang 言語コード 任意 この交通事業者が使用する主な言語。GTFS のユーザーがデータセットの大文字と小文字の規則やその他の言語固有の設定を選択できるようにするために提供するするべきである。
agency_phone 電話番号 任意 指定された事業者の音声電話番号。このフィールドは、事業者のサービスエリアの一般的な電話番号を表すstring値です。番号の桁をグループ化するために句読点を含めるしてもよい。ダイヤル可能なText(TriMet の503-238-RIDEなど) は許可されていますが、フィールドにその他の説明Textを含めるしてはいけない。
agency_fare_url URL 任意 乗客がその事業者のチケットやその他の運賃手段をオンラインで購入できる Web ページの URL。
agency_email 電子メール 任意 交通事業者のカスタマー サービス部門によってアクティブに監視されている電子メール アドレス。この電子メール アドレスは、交通事業者の乗客が事業者のカスタマー サービス担当者に連絡できる直接の連絡先であるするべきである。

stops.txt

ファイル: 条件付きで必須

主キー(stop_id)

フィールド名 タイプ 存在 説明
stop_id 一意の ID 必須 場所を識別します: 停留所/プラットフォーム、駅、入口/出口、汎用ノードまたは乗車エリア (location_type を参照)。

ID は、すべての stops.stop_id、locations.geojson id、および location_groups.location_group_id 値で一意である必要があります。

複数のルートで同じ stop_id を使用できます。
stop_code テキスト 任意 乗客の場所を識別する短いテキストまたは番号。これらのコードは、電話ベースの交通情報システムで使用されることが多く、乗客が特定の場所の情報を簡単に入手できるようにするために標識に印刷されます。stop_code は、一般向けである場合は stop_id と同じになることがあります。乗客にコードが提示されない場所では、このフィールドは空白のままにしてください。
stop_name テキスト 条件付きで必須 場所の名前。stop_name は、時刻表に印刷されているか、オンラインで公開されているか、標識に表示されている、事業者の乗客向けの場所の名前と一致する必要があります。他の言語に翻訳するには、translations.txt を使用します。

場所が乗車エリア (location_type=4) の場合、stop_name には事業者が表示する乗車エリアの名前を含める必要があります。ヨーロッパの一部の都市間鉄道駅のように 1 文字だけの場合もあれば、「車椅子乗車エリア」（ニューヨーク市の地下鉄）や「短距離列車の先頭」（パリの RER）のようなテキストの場合もあります。

条件付きで必須:
- 停留所 (location_type=0)、駅 (location_type=1)、または出入口 (location_type=2) の場所の場合は 必須 です。
- 汎用ノード (location_type=3) または乗車エリア (location_type=4) の場所の場合は任意です。
tts_stop_name テキスト 任意 stop_name の読み取り可能なバージョンです。詳細については、用語の定義 の「音声合成フィールド」を参照してください。
stop_desc テキスト 任意 有用で質の高い情報を提供する場所の説明。 stop_name と重複してはいけません。
stop_lat 緯度 条件付きで必須 場所の緯度。

停留所/プラットフォーム (location_type=0) および乗車エリア (location_type=4) の場合、座標はバスポール (存在する場合) の座標、ない場合は旅行者が車両に乗車する場所 (車両が停止する道路や線路ではなく、歩道またはプラットフォーム) の座標である必要があります。

条件付きで必須:
- 停留所 (location_type=0)、駅 (location_type=1)、または入口/出口 (location_type=2) の場所の場合は 必須。
- 汎用ノード (location_type=3) または乗車エリア (location_type=4) の場所の場合は任意。
stop_lon 経度 条件付きで必須 場所の経度。

停留所/プラットフォーム (location_type=0) および乗車エリア (location_type=4) の場合、座標はバスポール (存在する場合) の座標、ない場合は旅行者が車両に乗車する場所 (車両が停車する道路や線路ではなく、歩道またはプラットフォーム) の座標である必要があります。

条件付きで必須:
- 停留所 (location_type=0)、駅 (location_type=1)、または入口/出口 (location_type=2) の場所の場合は 必須 です。
- 汎用ノード (location_type=3) または乗車エリア (location_type=4) の場所の場合は任意です。
zone_id ID 任意 停留所の料金ゾーンを識別します。このレコードが駅または駅の入口を表す場合、zone_id は無視されます。
stop_url URL 任意 場所に関する Web ページの URL。これは、agency.agency_url および routes.route_url フィールド値とは異なる必要があります。
location_type 列挙型 任意 場所の種類。有効なオプションは次のとおりです:

0 (または空白) - 停留所 (または プラットフォーム)。乗客が交通事業者の車両に乗降する場所です。parent_station 内で定義されている場合はプラットフォームと呼ばれます。
1 - 駅。1 つ以上のプラットフォームを含む物理的な構造またはエリア。
2 - 入口/出口。乗客が通りから駅に出入りできる場所です。入口/出口が複数の駅に属している場合、経路によって両方にリンクできますが、データ プロバイダーはそのうちの 1 つを親として選択する必要があります。
3 - 汎用ノード。駅内の場所。他の location_type に一致せず、pathways.txt で定義されている経路をリンクするために使用できます。
4 - 乗車エリア。プラットフォーム上の特定の場所で、乗客が車両に乗ったり降車したりすることができます。
parent_station stops.stop_id を参照する外部 ID 条件付きで必須 stops.txt で定義されているさまざまな場所間の階層を定義します。親の場所の ID が次のように含まれます:

- 停留所/プラットフォーム (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) の場所の場合は 必須 です。
- 停留所/プラットフォームの場合は任意です。 (location_type=0)。
- 駅 (location_type=1) では禁止されています。
stop_timezone タイムゾーン 任意 場所のタイムゾーン。場所に親駅がある場合は、その場所のタイムゾーンを適用する代わりに、親駅のタイムゾーンを継承します。stop_timezone が空の駅と親のない停留所は、agency.agency_timezone で指定されたタイムゾーンを継承します。stop_times.txt で提供される時間は、stop_timezone ではなく、agency.agency_timezone で指定されたタイムゾーンです。これにより、便がどのタイムゾーンを通過するかに関係なく、便の途中で便の時間値が常に増加することが保証されます。
wheelchair_boarding 列挙型 任意 場所から車椅子での乗車が可能かどうかを示します。有効なオプションは次のとおりです:

親のない停留所の場合:
0 または空 - 停留所のアクセシビリティ情報がありません。
1 - この停留所の一部の車両には、車椅子の乗客が乗車できます。
2 - この停留所では車椅子での乗車はできません。

子の停留所の場合:
0 または空 - 親で指定されている場合、停留所は親ステーションから wheelchair_boarding 動作を継承します。
1 - ステーションの外から特定の停留所/プラットフォームへのアクセス可能なパスが存在します。
2 - ステーションの外から特定の停留所/プラットフォームへのアクセス可能なパスが存在しません。

ステーションの出入口の場合:
0 または空 - 親で指定されている場合、ステーションの出入口は親ステーションから wheelchair_boarding 動作を継承します。
1 - ステーションの出入口は車椅子でアクセスできます。
2 - ステーションの出入口から停留所/プラットフォームへのアクセス可能なパスはありません。
level_id levels.level_id を参照する外部 ID 任意 場所のレベル。同じレベルが、リンクされていない複数の駅で使用される場合があります。
platform_code テキスト 任意 プラットフォーム ストップ (駅に属するストップ) のプラットフォーム識別子。これは、プラットフォーム識別子のみである必要があります (例: "G" または "3")。「プラットフォーム」や「トラック」などの単語 (またはフィードの言語固有の同等語) は含めないでください。これにより、フィード コンシューマーは、プラットフォーム識別子を他の言語に国際化およびローカライズしやすくなります。

routes.txt

ファイル: 必須

主キー(route_id)

フィールド名 タイプ 存在 説明
route_id 一意の ID 必須 ルートを識別します。
agency_id agency.agency_id を参照する外部 ID 条件付きで必須 指定されたルートの事業者。

条件付きで必須:
- agency.txt で複数の事業者が定義されている場合は 必須。
- それ以外の場合は推奨。
route_short_name テキスト 条件付きで必須 ルートの短縮名。多くの場合、乗客がルートを識別するために使用する短い抽象的な識別子 (例: "32"、"100X"、"Green") です。 route_short_name と route_long_name の両方を定義できます。

条件付きで必須:
- routes.route_long_name が空の場合は 必須 です。
- 簡単なサービス指定がある場合は推奨されます。これは、サービスの一般的な乗客名である必要があり、12 文字以内にする必要があります。
route_long_name テキスト 条件付きで必須 ルートの完全な名前。この名前は通常、route_short_name よりも説明的で、ルートの目的地または停留所が含まれることがよくあります。route_short_name と route_long_name の両方を定義できます。

条件付きで必須:
- routes.route_short_name が空の場合は 必須 です。
- それ以外の場合は任意です。
route_desc テキスト 任意 有用で質の高い情報を提供するルートの説明。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 列挙型 必須 ルートで使用される交通事業者の種類を示します。有効なオプションは次のとおりです:

0 - 路面電車、路面電車、ライトレール。大都市圏内のライトレールまたはストリート レベルのシステム。
1 - 地下鉄、メトロ。大都市圏内の地下鉄システム。
2 - 鉄道。都市間または長距離の移動に使用します。
3 - バス。短距離および長距離のバス路線に使用します。
4 - フェリー。短距離および長距離の船便に使用します。
5 - ケーブル トラム。ケーブルが車両の下を走る路面電車に使用します (例: サンフランシスコのケーブル カー)。
6 - 空中リフト、吊り下げ式ケーブル カー (例: ゴンドラ リフト、空中トラムウェイ)。1 つ以上のケーブルを使用して、キャビン、車両、ゴンドラ、またはオープン チェアが吊り下げられているケーブル輸送。
7 - ケーブルカー。急勾配用に設計された鉄道システム。
11 - トロリーバス。ポールを使用して頭上の電線から電力を引き出す電気バス。
12 - モノレール。線路が単一のレールまたはビームで構成されている鉄道。
route_url URL 任意 特定のルートに関する Web ページの URL。agency.agency_url 値とは異なる必要があります。
route_color 色 任意 公開資料に一致するルートの色の指定。省略または空白のままにした場合、デフォルトで白 (FFFFFF) になります。route_color と route_text_color の色の違いは、白黒画面で表示したときに十分なコントラストを提供する必要があります。
route_text_color 色 任意 route_color の背景に描画されるテキストに使用する判読可能な色。省略または空白のままにした場合、デフォルトで黒 (000000) になります。route_color と route_text_color の色の違いは、白黒画面で表示したときに十分なコントラストを提供する必要があります。
route_sort_order 負でない整数 任意 顧客へのプレゼンテーションに最適な方法でルートを順序付けます。 route_sort_order 値が小さいルートが最初に表示されます。
continuous_pickup 列挙型 条件付きで禁止 ルートのすべての便で、shapes.txt で説明されているように、乗客が車両の移動経路に沿った任意の地点で交通事業者の車両に乗車できることを示します。有効なオプションは次のとおりです:

0 - 連続停止ピックアップ。
1 または空 - 連続停止ピックアップなし。
2 - 連続停止ピックアップを手配するには代理店に電話する必要があります。
3 - 連続停止ピックアップを手配するにはドライバーと調整する必要があります。

routes.continuous_pickup の値は、ルート沿いの特定の stop_time の stop_times.continuous_pickup の値を定義することで上書きできます。

条件付きで禁止:
- このルートの任意の便に stop_times.start_pickup_drop_off_window または stop_times.end_pickup_drop_off_window が定義されている場合は 禁止 です。
- それ以外の場合は任意です。
continuous_drop_off 列挙型 条件付き禁止 乗客は、ルートのすべての便において、shapes.txt で説明されているように、車両の移動経路に沿った任意の地点で交通事業者の車両から降車できることを示します。有効なオプションは次のとおりです:

0 - 連続停車降車。
1 または空 - 連続停車降車なし。
2 - 連続停車降車を手配するには、代理店に電話する必要があります。
3 - 連続停車降車を手配するには、運転手と調整する必要があります。

routes.continuous_drop_off の値は、ルート沿いの特定の stop_time に対して stop_times.continuous_drop_off の値を定義することで上書きできます。

条件付きで禁止:
- 禁止: このルートの任意の便に stop_times.start_pickup_drop_off_window または stop_times.end_pickup_drop_off_window が定義されている場合。
- それ以外の場合は任意です。
network_id ID 条件付きで禁止 ルートのグループを識別します。routes.txt 内の複数の行に同じ network_id が含まれる場合があります。

条件付きで禁止:
- 禁止: route_networks.txt ファイルが存在する場合。
- それ以外の場合は任意です。

trips.txt

ファイル: 必須

主キー(trip_id)

フィールド名 タイプ 存在 説明
route_id routes.route_id を参照する外部 ID 必須 ルートを識別します。
service_id calendar.service_id または calendar_dates.service_id を参照する外部 ID 必須 1 つ以上のルートでサービスが利用可能な日付のセットを識別します。
trip_id 一意の ID 必須 便を識別します。
trip_headsign テキスト 任意 便の目的地を乗客に示す標識に表示されるテキスト。このフィールドは、ルート内の便を区別するために使用できる、車両にヘッドサイン テキストが表示されるすべてのサービスに推奨されます。

便中にヘッドサインが変わる場合、便中の特定の stop_time の stop_times.stop_headsign の値を定義することで、trip_headsign の値を上書きできます。
trip_short_name テキスト 任意 乗客に便を識別するために使用される一般向けのテキスト。たとえば、通勤電車の便で列車番号を識別する場合などです。乗客が便名をあまり使用しない場合は、trip_short_name を空にする必要があります。trip_short_name 値を指定する場合、サービス日内の便を一意に識別する必要があります。目的地名や特急/急行の指定には使用しないでください。
direction_id 列挙型 任意 便の移動方向を示します。このフィールドはルーティングには使用しないでください。時刻表を公開するときに、方向別に便を分ける方法を提供します。有効なオプションは次のとおりです:

0 - 一方向への移動 (例: 往路)。
1 - 反対方向への移動 (例: 復路)。
例: trip_headsign フィールドと direction_id フィールドを一緒に使用して、一連の便の各方向への移動に名前を割り当てることができます。trips.txt ファイルには、時刻表で使用するために次のレコードを含めることができます:
trip_id,...,trip_headsign,direction_id
1234,...,Airport,0
1505,...,Downtown,1
block_id ID 任意 便が属するブロックを識別します。ブロックは、共有サービス日と block_id によって定義される、単一の便または同じ車両を使用して行われる多数の連続した便で構成されます。 block_id には、異なる運行日の便が含まれる場合があり、ブロックが別々になります。以下の例 を参照してください。座席内での乗り換え情報を提供するには、代わりに transfer_type 4 の transfers を指定する必要があります。
shape_id shapes.shape_id を参照する外部 ID 条件付きで必須 便の車両移動経路を示す地理空間形状を識別します。

条件付きで必須:
- 便に routes.txt または stop_times.txt のいずれかで定義された連続的な乗車または降車動作がある場合は 必須 です。
- それ以外の場合は任意です。
wheelchair_accessible 列挙型 任意 車椅子でのアクセス可能性を示します。有効なオプションは次のとおりです:

0 または空 - 便のアクセシビリティ情報がありません。
1 - この特定の便で使用される車両には、少なくとも 1 人の車椅子のライダーを収容できます。
2 - この便では、車椅子のライダーを収容できません。
bikes_allowed Enum 任意 自転車が許可されているかどうかを示します。有効なオプションは次のとおりです:

0 または空 - 便の自転車情報がありません。
1 - この特定の便で使用される車両には、少なくとも 1 台の自転車を収容できます。
2 - この便では、自転車は許可されていません。

例: ブロックとサービス日

以下の例は有効で、曜日ごとにブロックが異なります。

route_id trip_id service_id block_id (first stop time) (last 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 時から午前 12 時 55 分まで)。最後の運行は土曜日の午前 12 時から午前 12 時 55 分までですが、時刻が 24:00:00 から 24:55:00 であるため、金曜日の​​運行日の一部であることに注意してください。
  • 月曜日、火曜日、水曜日、および木曜日には、1 台の車両が午後 8 時から午後 10 時 55 分までのブロックで trip_1、trip_4、および trip_5 を運行します。

stop_times.txt

ファイル: 必須

主キー(trip_id、 stop_sequence)

フィールド名 タイプ 存在 説明
trip_id trips.trip_id を参照する外部 ID 必須 便を識別します。
arrival_time 時間 条件付きで必須 stops.stop_timezone ではなく agency.agency_timezone で指定されたタイム ゾーンでの、特定の便 (stop_times.trip_id で定義) の停留所 (stop_times.stop_id で定義) への到着時刻。

停留所への到着時刻と出発時刻が別々でない場合は、arrival_time と departure_time は同じである必要があります。

運行日の深夜 0 時以降の時刻については、HH:MM:SS 形式で 24:00:00 より大きい値を入力します。

正確な到着時刻と出発時刻 (timepoint=1) が利用できない場合は、推定または補間された到着時刻と出発時刻 (timepoint=0) を指定する必要があります。

条件付きで必須:
- 便の最初と最後の停留所 (stop_times.stop_sequence で定義) の場合は 必須 です。
- timepoint=1 の場合は 必須 です。
- start_pickup_drop_off_window または end_pickup_drop_off_window が定義されている場合は 禁止 です。
- それ以外の場合は任意です。
departure_time 時間 条件付きで必須 stops.stop_timezone ではなく agency.agency_timezone で指定されたタイムゾーンでの、特定の旅程 (stop_times.trip_id で定義) の停留所 (stop_times.stop_id で定義) からの出発時刻。

停留所での到着時間と出発時間が別々でない場合は、arrival_time と departure_time は同じである必要があります。

運行日の深夜 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_times.txt に記録されている必要があります。参照される場所は停留所/プラットフォームである必要があります。つまり、stops.location_type 値は 0 または空である必要があります。同じ旅程で 1 つの停留所が複数回サービスされる場合があり、複数の旅程とルートが同じ停留所にサービスを提供する場合があります。

停留所を使用するオンデマンド サービスは、それらの停留所でサービスが利用できる順序で参照する必要があります。データ コンシューマーは、各 stop_time の pickup/drop_off_type と各 start/end_pickup_drop_off_window の時間制約によって禁止されていない限り、ある停留所または場所から便中の任意の停留所または場所への移動が可能であると想定する必要があります。

条件付きで必須:
- 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_times.txt に記録されている必要があります。複数の便とルートが同じ場所グループにサービスを提供する場合があります。

場所グループを使用するオンデマンド サービスは、それらの場所グループでサービスが利用できる順序で参照する必要があります。データ コンシューマーは、各 stop_time の pickup/drop_off_type と各 start/end_pickup_drop_off_window の時間制約によって禁止されていない限り、便中のある停留所または場所から後の任意の停留所または場所への移動が可能であると想定する必要があります。

条件付きで禁止:
- stop_times.stop_id または stop_times.location_id が定義されている場合は 禁止 です。
location_id locations.geojson から id を参照する外部 ID 条件付きで禁止 乗客が乗車または降車をリクエストできるサービス提供ゾーンに対応する GeoJSON ロケーションを識別します。便中にサービス提供されたすべての GeoJSON ロケーションは、stop_times.txt に記録されている必要があります。複数の便およびルートが同じ GeoJSON ロケーションにサービスを提供する場合があります。

ロケーション内のオンデマンド サービスは、それらのロケーションでサービスが利用できる順序で参照する必要があります。データ コンシューマーは、各 stop_time の pickup/drop_off_type および各 start/end_pickup_drop_off_window の時間制約によって禁止されていない限り、ある停留所またはロケーションから便中の後の任意の停留所またはロケーションへの移動が可能であると想定する必要があります。

条件付きで禁止:
- stop_times.stop_id または stop_times.location_group_id が定義されている場合は 禁止 です。
stop_sequence 負でない整数 必須 特定の便の停留所、場所グループ、または GeoJSON の場所の順序。値は便に沿って増加する必要がありますが、連続している必要はありません。
例: 便の最初の場所には stop_sequence=1、便の 2 番目の場所には stop_sequence=23、3 番目の場所には stop_sequence=40 などを設定できます。

同じ場所グループまたは GeoJSON の場所内で旅行するには、stop_times.txt に同じ location_group_id または location_id を持つ 2 つのレコードが必要です。
stop_headsign テキスト 任意 乗客に便の目的地を示す標識に表示されるテキスト。このフィールドは、停留所間でヘッドサインが変わる場合にデフォルトの trips.trip_headsign を上書きします。行程全体でヘッドサインが表示される場合は、代わりに trips.trip_headsign を使用する必要があります。

1 つの stop_time に指定された stop_headsign 値は、同じ行程内の後続の stop_time には適用されません。同じ行程内の複数の stop_time に対して trip_headsign をオーバーライドする場合は、各 stop_time 行で stop_headsign 値を繰り返す必要があります。
start_pickup_drop_off_window 時間 条件付きで必須 GeoJSON の場所、場所グループ、または停留所でオンデマンド サービスが利用可能になる時間。

条件付きで必須:
- 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_times.location_group_id または stop_times.location_id が定義されている場合は 必須。
- start_pickup_drop_off_window が定義されている場合は 必須。
- arrival_time または departure_time が定義されている場合は 禁止。
- それ以外の場合は任意。
pickup_type 列挙型 条件付きで禁止 ピックアップ方法を示します。有効なオプションは次のとおりです:

0 または空 - 定期的にスケジュールされたピックアップ。
1 - ピックアップは利用できません。
2 - ピックアップを手配するには代理店に電話する必要があります。
3 - ピックアップを手配するにはドライバーと調整する必要があります。

条件付きで禁止:
- pickup_type=0 は、start_pickup_drop_off_window または end_pickup_drop_off_window が定義されている場合は 禁止 です。
- pickup_type=3 は、start_pickup_drop_off_window または end_pickup_drop_off_window が定義されている場合は 禁止 です。
- それ以外の場合は任意です。
drop_off_type 列挙型 条件付きで禁止 ドロップオフ方法を示します。有効なオプションは次のとおりです:

0 または空 - 定期的に予定されている降車。
1 - 降車はありません。
2 - 降車を手配するには代理店に電話する必要があります。
3 - 降車を手配するには運転手と調整する必要があります。

条件付きで禁止:
- start_pickup_drop_off_window または end_pickup_drop_off_window が定義されている場合は drop_off_type=0 禁止。
- それ以外の場合は任意。
continuous_pickup Enum 条件付きで禁止 乗客は、shapes.txt で説明されているように、この stop_time から便の stop_sequence の次の stop_time まで、車両の移動経路に沿った任意の時点で交通事業者の車両に乗車できることを示します。有効なオプションは次のとおりです:

0 - 連続停止ピックアップ。
1 または空 - 連続停止ピックアップなし。
2 - 連続停止ピックアップを手配するには代理店に電話する必要があります。
3 - 連続停止ピックアップを手配するにはドライバーと調整する必要があります。

このフィールドに値が入力されている場合は、routes.txt で定義されている連続ピックアップ動作がオーバーライドされます。 このフィールドが空の場合、stop_time は routes.txt で定義されている連続ピックアップ動作を継承します。

条件付きで禁止:
- start_pickup_drop_off_window または end_pickup_drop_off_window が定義されている場合は 禁止 です。
- それ以外の場合は任意です。
continuous_drop_off 列挙型 条件付きで禁止 乗客は、shapes.txt で説明されているように、この stop_time から便の stop_sequence の次の stop_time まで、車両の移動経路に沿った任意の地点で交通事業者の車両から降車できることを示します。有効なオプションは次のとおりです:

0 - 連続停車降車。
1 または空 - 連続停車降車なし。
2 - 連続停車降車を手配するには、代理店に電話する必要があります。
3 - 連続停車降車を手配するには、運転手と調整する必要があります。

このフィールドに値が入力されている場合は、routes.txt で定義されている連続降車動作がオーバーライドされます。このフィールドが空の場合、stop_time は routes.txt で定義されている連続降車動作を継承します。

条件付き禁止:
- start_pickup_drop_off_window または end_pickup_drop_off_window が定義されている場合は 禁止 です。
- それ以外の場合は任意です。
shape_dist_traveled 負でない浮動小数点数 任意 関連する形状に沿って、最初の停留所からこのレコードで指定された停留所まで実際に移動した距離。このフィールドは、便中に任意の 2 つの停留所の間に形状をどれだけ描画するかを指定します。shapes.txt で使用されているのと同じ単位にする必要があります。shape_dist_traveled に使用する値は、stop_sequence とともに増加する必要があります。ルートに沿った逆方向の移動を示すために使用しないでください。

ループまたはインライン (車両が 1 回の移動で同じ部分の線形を横切ったり移動したりする) があるルートに推奨されます。shapes.shape_dist_traveled を参照してください。
例: バスが形状の開始から停留所まで 5.25 キロメートルの距離を移動する場合、shape_dist_traveled=5.25。
timepoint 列挙型 任意 停留所の到着時間と出発時間が車両によって厳密に遵守されているか、または概算時間や補間時間であるかを示します。このフィールドにより、GTFS プロデューサーは補間された停留所時間を提供し、時間が概算であることを示すことができます。有効なオプションは次のとおりです:

0 - 時間は概算と見なされます。
1 - 時間は正確と見なされます。

到着時刻または出発時刻が定義されている stop_times.txt のすべてのレコードには、タイムポイント値が入力されている必要があります。タイムポイント値が指定されていない場合、すべての時刻は正確であるとみなされます。
pickup_booking_rule_id booking_rules.booking_rule_id を参照する外部 ID 任意 この停車時刻での乗車予約ルールを識別します。

pickup_type=2 の場合に推奨されます。
drop_off_booking_rule_id booking_rules.booking_rule_id を参照する外部 ID 任意 この停車時刻での降車予約ルールを識別します。

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 つ以上のルートでサービスが利用可能な日付のセットを識別します。
monday 列挙型 必須 start_date および end_date フィールドで指定された日付範囲のすべての月曜日にサービスが実行されるかどうかを示します。特定の日付の例外は calendar_dates.txt にリストされていることに注意してください。有効なオプションは次のとおりです:

1 - 日付範囲のすべての月曜日にサービスが利用可能です。
0 - 日付範囲の月曜日にはサービスが利用できません。
tuesday 列挙型 必須 火曜日に適用される点を除いて monday と同じように機能します
wednesday 列挙型 必須 水曜日に適用される点を除いて monday と同じように機能します
thursday 列挙型 必須 木曜日に適用される点を除いて monday と同じように機能します
friday 列挙型 必須 金曜日に適用される点を除いて monday と同じように機能します
saturday 列挙型 必須 土曜日に適用される点を除いて monday と同じように機能します。
sunday 列挙型 必須 日曜日に適用される点を除いて monday と同じように機能します。
start_date 日付 必須 サービス間隔の開始サービス日。
end_date 日付 必須 サービス間隔の終了サービス日。このサービス日は間隔に含まれます。

calendar_dates.txt

ファイル: 条件付きで必須

主キー(service_id、 date)

calendar_dates.txt テーブルは、dateによってサービスを明示的に有効または無効にします。2 つの方法で使用してもよい。

  • 推奨: calendar.txt を calendar.txt と組み合わせて使用​​します。サービスが一般的に定期的で、明示的な日付にいくつかの変更がある場合 (たとえば、特別なイベント サービスや学校のスケジュールに対応するため)、これは適切なアプローチです。この場合、 calendar_dates.service_idはcalendar.service_id部` IDです。
  • 代替: calendar.txt を省略し、calendar_dates.txt で各サービスのdateを指定します。これにより、かなりのサービスバリエーションが可能になり、通常の週次スケジュールのないサービスに対応できます。この場合、 service_idはIDです。
フィールド名 タイプ 存在 説明
service_id calendar.service_id または ID を参照する外部 ID 必須 1 つ以上のルートでサービス例外が発生する日付のセットを識別します。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 列挙型 必須 日付フィールドで指定された日付にサービスが利用可能かどうかを示します。有効なオプションは次のとおりです:

1 - 指定された日付にサービスが追加されました。
2 - 指定された日付にサービスが削除されました。
例: ルートに休日に利用可能な便セットと、他のすべての日に利用可能な便セットがあるとします。 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
- fare_leg_rules.txt
- fare_transfer_rules.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 の運賃が旅程にどのように適用されるかを指定します。ほとんどの運賃体系では、次のルールの組み合わせが使用されます。

  • 運賃は出発駅または到着駅によって異なります。
  • 運賃は、旅程が通過するゾーンによって異なります。
  • 運賃は、旅程が使用するルートによって異なります。

fare_rules.txt および fare_attributes.txt を使用して運賃体系を指定する方法を示す例については、GoogleTransitDataFeed オープンソース プロジェクト wiki の FareExamples をご覧ください。

フィールド名 タイプ 存在 説明
fare_id fare_attributes.fare_id を参照する外部 ID 必須 運賃クラスを識別します。
route_id routes.route_id を参照する外部 ID 任意 運賃クラスに関連付けられたルートを識別します。同じ運賃属性を持つ複数のルートが存在する場合は、各ルートの fare_rules.txt にレコードを作成します。
例: 運賃クラス「b」がルート「TSW」および「TSE」で有効な場合、fare_rules.txt ファイルには運賃クラスに関する次のレコードが含まれます:
fare_id,route_id
b,TSW
b,TSE
origin_id stops.zone_id を参照する外部 ID 任意 出発地ゾーンを識別します。運賃クラスに複数の出発地ゾーンがある場合は、fare_rules.txt に各 origin_id のレコードを作成します。
例: 運賃クラス "b" がゾーン "2" またはゾーン "8" のいずれかから出発するすべての旅行に有効な場合、fare_rules.txt ファイルには運賃クラスの次のレコードが含まれます:
fare_id,...,origin_id
b,...,2
b,...,8
destination_id stops.zone_id を参照する外部 ID 任意 目的地ゾーンを識別します。運賃クラスに複数の目的地ゾーンがある場合は、fare_rules.txt に各 destination_id のレコードを作成します。
例: origin_id フィールドと destination_id フィールドを一緒に使用して、運賃クラス "b" がゾーン 3 と 4 の間の移動に有効であることを指定できます。ゾーン 3 と 5 の間の移動の場合、fare_rules.txt ファイルには運賃クラスの次のレコードが含まれます:
fare_id,...,origin_id,destination_id
b,...,3,4
b,...,3,5
contains_id stops.zone_id を参照する外部 ID 任意 特定の運賃クラスを使用しているときに乗客が進入するゾーンを識別します。一部のシステムで正しい運賃クラスを計算するために使用されます。
例: 運賃クラス「c」がゾーン 5、6、7 を通過する GRT ルートのすべての旅行に関連付けられている場合、fare_rules.txt には次のレコードが含まれます:
fare_id,route_id,...,contains_id
c,GRT,...,5
c,GRT,...,6
c,GRT,...,7
運賃を適用するにはすべての contains_id ゾーンが一致している必要があるため、ゾーン 5 と 6 を通過し、ゾーン 7 を通過しない旅程には運賃クラス「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 時間 条件付きで必須 時間枠の開始を定義します。間隔には開始時刻が含まれます。
24:00:00 より大きい値は禁止されています。 start_time の値が空の場合、00:00:00 とみなされます。

条件付きで必須:
- timeframes.end_time が定義されている場合は 必須 です。
- それ以外の場合は 禁止 です
end_time 時間 条件付きで必須 時間枠の終了を定義します。間隔には終了時刻は含まれません。
24:00:00 より大きい値は禁止されています。end_time の値が空の場合、24:00:00 とみなされます。

条件付きで必須:
- timeframes.start_time が定義されている場合は 必須 です。
- それ以外の場合は 禁止 です
service_id calendar.service_id または calendar_dates.service_id を参照する外部 ID 必須 期間が有効な日付のセットを識別します。

タイムフレームのローカル時間セマンティクス

  • 運賃イベントの時間を timeframes.txt に対して評価する場合、イベント時間は、運賃イベントの停車駅または親駅の stop_timezone (指定されている場合) によって決定されるローカル タイムゾーンを使用してローカル時間で計算されます。指定されていない場合は、フィードの事業者のタイムゾーンを代わりに使用するするべきである。
  • 現在の日は、ローカル タイムゾーンを基準に計算された運賃イベントの時間の現在のdateです。現在の日は、特に深夜を過ぎる便の場合、運賃区間の便のサービス日とは異なるしてもよい。
  • 運賃イベントの時刻は、GTFS 時間フィールドタイプのセマンティクスを使用して、現在の日を基準にして計算されます。

fare_media.txt

ファイル: 任意

主キー(fare_media_id )

チケット商品の使用に使用できるさまざまな運賃メディアを記述します。運賃メディアは、チケット商品の表示や検証に使用される物理的または仮想的なホルダーです。

フィールド名 タイプ 存在 説明
fare_media_id ユニーク ID 必須 運賃メディアを識別します。
fare_media_name Text 任意 運賃メディアの名前。

交通カード (fare_media_type =2) またはモバイル アプリ (fare_media_type =4) などの運賃メディアの場合、 fare_media_nameを含めるするべきである、それを配信する組織が使用する乗客向けの名前と一致するべきである。
fare_media_type Enum 必須 運賃メディアのタイプ。有効なオプションは次のとおりです。

0 - なし。物理的なチケットが提供されずに運転手または車掌に現金で支払うなど、チケット商品の購入または検証に運賃メディアが関与しない場合に使用されます。
1 - 乗客が一定期間内に、事前に購入した一定数の便、または無制限の便のいずれかを利用できる物理的な紙のチケット。
2 - チケット、パス、または金銭的価値が保存されている物理的な交通カード。
3 - アカウントベースのチケット発行用のオープンループ トークン コンテナとしての cEMV (非接触型 Europay、Mastercard、Visa)。
4 - 仮想交通カード、チケット、パス、または金銭的価値を保存したモバイル アプリ。

fare_products.txt

ファイル: 任意

主キー(fare_product_id、 fare_media_id)

乗客が購入可能な運賃の範囲を記述したり、乗り換えコストなど、複数の区間を含む旅程の合計運賃を計算するときに考慮したりするために使用されます。

フィールド名 タイプ 存在 説明
fare_product_id ID 必須 チケット商品またはチケット商品のセットを識別します。

fare_products.txt 内の複数のレコードが同じfare_product_idを共有するしてもよい。その場合、別のファイルから参照されたときに、そのIDを持つすべてのレコードが取得されます。

複数のレコードが同じfare_product_id を共有してしてもよいても、異なるfare_media_idを持つ場合があります。これは、チケット商品を使用するために利用できるさまざまな方法 (潜在的に異なる価格) を示します。
fare_product_name Text 任意 乗客に表示されるチケット商品の名前。
fare_media_id fare_media.fare_media_id部ID |任意| 便中にチケット商品を使用するために使用できる運賃メディアを識別します。fare_media_id` が空の場合、運賃メディアは不明であると見なされます。
amount 通貨金額 必須 チケット商品のコスト。乗り継ぎ割引を表す場合は負の値になる場合がしてもよい。無料のチケット商品を表す場合はゼロになる場合がしてもよい。
currency 通貨コード 必須 チケット商品のコストの通貨。

fare_leg_rules.txt

ファイル: 任意

主キー(network_id, from_area_id, to_area_id, from_timeframe_group_id, to_timeframe_group_id, fare_product_id)

旅行の各区間の運賃規則。

fare_leg_rules.txt の運賃は、乗客が移動する区間に一致する規則を見つけるために、ファイル内のすべてのレコードをフィルタリングして照会するしなければならない。

区間のコストを処理するには:

  1. ファイル fare_leg_rules.txt は、旅行の特性を定義するフィールドでフィルタリングするしなければならない。これらのフィールドは次のとおりです:

    • fare_leg_rules.network_id
    • fare_leg_rules.from_area_id
    • fare_leg_rules.to_area_id
    • fare_leg_rules.from_timeframe_group_id
    • fare_leg_rules.to_timeframe_group_id

  2. 旅行の特性に基づいて、区間が fare_leg_rules.txt のレコードと完全に一致する場合、そのレコードを処理して区間のコストを決定するしなければならない。このファイルは、空のエントリを 2 つの方法で処理します: 空のセマンティクスまたはルールの優先順位。

  3. 完全一致が見つからず、rule_priority フィールドが存在しない場合は、 fare_leg_rules.network_id、 fare_leg_rules.from_area_id、およびfare_leg_rules.to_area_idの空のエントリをチェックして、区間のコストを処理するしなければならない。

    • fare_leg_rules.network_idの空のエントリは、routes.txt または networks.txt で定義されているすべてのネットワークに対応しますが、 fare_leg_rules.network_idの下にリストされているネットワークは除きます。

    • fare_leg_rules.from_area_idの空のエントリは、areas.area_idで定義されているすべてのエリアに対応しますが、 fare_leg_rules.from_area_idの下にリストされているエリアは除きます。

    • 空のfare_leg_rules.to_area_idのエントリは、 fare_leg_rules.to_area_idの下にリストされているものを除いて、areas.area_id`で定義されているすべてのエリアに対応します

  4. rule_priority フィールドが存在する場合、

    • fare_leg_rules.network_idのエントリが空の場合、区間のネットワークはこのルールのマッチングには影響しません。
    • fare_leg_rules.from_area_id のエントリが空の場合、区間の出発エリアはこのルールのマッチングには影響しません。
    • fare_leg_rules.to_area_idのエントリが空の場合、区間の到着エリアはこのルールのマッチングには影響しません。

  5. 区間が上記の規則のいずれにも一致しない場合は、運賃は不明です。


フィールド名 タイプ 存在 説明
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 の空のエントリは、routes.txt または networks.txt で定義されているすべてのネットワークに対応しますが、fare_leg_rules.network_id の下にリストされているものは除きます。

ファイルに rule_priority フィールドが存在する場合、空の fare_leg_rules.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 は、区間の出発エリアがこのルールの一致に影響しないことを示します。
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 は、区間の到着エリアがこのルールの一致に影響しないことを示します。
from_timeframe_group_id timeframes.timeframe_group_id を参照する外部 ID 任意 運賃区間の開始時に運賃検証イベントのタイムフレームを定義します。

運賃区間の「開始時刻」は、イベントが発生するようにスケジュールされている時刻です。たとえば、乗客が乗車して運賃を検証する運賃区間の開始時のバスの予定出発時刻が時刻になります。以下のルール マッチング セマンティクスでは、開始時刻は timeframes.txt の ローカル時間セマンティクス によって決定されるローカル時間で計算されます。適切な場合、運賃区間の出発イベントの停車駅または駅がタイムゾーン解決に使用されます。

from_timeframe_group_id を指定する運賃区間ルールの場合、timeframes.txt に次の条件がすべて当てはまるレコードが少なくとも 1 つ存在する場合、そのルールは特定の区間に一致します。
- timeframe_group_id の値は from_timeframe_group_id の値と同じです。
- レコードの service_id によって識別される日のセットには、運賃区間の開始時刻の「現在の日」が含まれます。
- 運賃区間の開始時刻の「時刻」は、レコードの timeframes.start_time 値以上であり、timeframes.end_time 値未満です。

空の fare_leg_rules.from_timeframe_group_id は、レグの開始時間は、このルールのマッチングには影響しません。
to_timeframe_group_id timeframes.timeframe_group_id を参照する外部 ID 任意 運賃区間の終了時に運賃検証イベントのタイムフレームを定義します。

運賃区間の「終了時刻」は、イベントが発生するようにスケジュールされている時刻です。たとえば、乗客が降車して運賃を検証する運賃区間の終了時にバスが到着する予定時刻などです。以下のルール マッチング セマンティクスでは、終了時刻は timeframes.txt の ローカル時間セマンティクス によって決定されるローカル時間で計算されます。適切な場合、運賃区間の到着イベントの停車駅または駅がタイムゾーン解決に使用されます。

to_timeframe_group_id を指定する運賃区間ルールの場合、timeframes.txt に次の条件がすべて当てはまるレコードが少なくとも 1 つ存在すると、そのルールは特定の区間に一致します。
- timeframe_group_id の値は to_timeframe_group_id の値と等しい。
- レコードの service_id によって識別される日のセットには、運賃区間の終了時刻の「現在の日」が含まれます。
- 運賃区間の終了時刻の「時刻」は、レコードの timeframes.start_time 値以上であり、timeframes.end_time 値未満です。

空の fare_leg_rules.to_timeframe_group_id は、区間の終了時間は、このルールのマッチングには影響しません。
fare_product_id fare_products.fare_product_id を参照する外部 ID 必須 区間を移動するために必要なチケット商品。
rule_priority 負でない整数 任意 マッチング ルールが区間に適用される優先順位を定義し、特定のルールを他のルールよりも優先できるようにします。fare_leg_rules.txt 内の複数のエントリが一致する場合、rule_priority の値が最も高いルールまたはルール セットが選択されます。

rule_priority の値が空の場合、ゼロとして扱われます。

fare_transfer_rules.txt

ファイル: 任意

主キー(from_leg_group_id, to_leg_group_id, fare_product_id, transfer_count, duration_limit)

fare_leg_rules.txt で定義された旅行区間間の乗り換えの運賃規則。

複数区間の旅程の費用を処理するには:

  1. fare_leg_rules.txtで定義された適用可能な運賃区間グループは、乗客の旅程に基づいて、すべての個々の旅行区間に対して決定するするべきである。
  2. ファイル fare_transfer_rules.txt は、乗り換えの特性を定義するフィールドでフィルタリングするしなければならない。これらのフィールドは次のとおりです:
  3. fare_transfer_rules.from_leg_group_id
  4. fare_transfer_rules.to_leg_group_id

  5. 乗り換えの特性に基づいて、乗り換えが fare_transfer_rules.txt のレコードと完全に一致する場合、そのレコードを処理して乗り換えコストを決定する必要があります。
  6. 完全に一致するものが見つからない場合、乗り換えコストを処理するために、from_leg_group_id または to_leg_group_id の空のエントリを確認する必要があります:
  7. fare_transfer_rules.from_leg_group_id の空のエントリは、fare_leg_rules.leg_group_id で定義されているすべての区間グループに対応しますが、fare_transfer_rules.from_leg_group_id にリストされているものを除きます
  8. fare_transfer_rules.to_leg_group_id の空のエントリは、fare_leg_rules.leg_group_id で定義されているすべての区間グループに対応しますが、fare_transfer_rules.to_leg_group_id にリストされているものを除きます

  9. 乗り換えが上記のルールのいずれにも一致しない場合は、乗り換え手配は存在せず、区間は別々であると見なされます。


フィールド名 タイプ 存在 説明
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_leg_rules.leg_group_idにリストされているものを除く、 fare_transfer_rules.to_leg_group_idで定義されているすべての区間グループに対応します
transfer_count ゼロ以外の整数 条件付きで禁止 乗り換えルールを適用してもよい連続乗り換えの数を定義します。

有効なオプションは次のとおりです。
-1 - 制限なし。
1以上 - 転送ルールが適用さしてもよい乗り換えの数を定義します。

サブジャーニーが異なるtransfer_countを持つ複数のレコードと一致する場合、サブジャーニーの現在の転送カウント以上の最小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 - 現在の区間の出発運賃の検証と次の区間の到着運賃の検証の間。
1 - 現在の区間の出発運賃の検証と次の区間の出発運賃の検証の間。
2 - 現在の区間の到着運賃の検証と次の区間の出発運賃の検証の間。
3 - 現在の区間の到着運賃の検証と次の区間の到着運賃の検証の間。

条件付きで必須:
- fare_transfer_rules.duration_limitが定義されている場合は必須。
- fare_transfer_rules.duration_limitが空の場合は禁止**です。
fare_transfer_type 列挙型 必須 旅程中の区間間の乗り換えのコスト処理方法を示します。

有効なオプションは次のとおりです。
0 - 出発区間fare_leg_rules.fare_product_idとfare_transfer_rules.fare_product_idを加算したもの。A + AB。
1 - 出発区間のfare_leg_rules.fare_product_idとfare_transfer_rules.fare_product_idと到着区間のfare_leg_rules.fare_product_id を加算します。A + AB + B。
2 - fare_transfer_rules.fare_product_id; AB.

旅程中の複数の乗り換え間のコスト処理のやり取り:

fare_transfer_type処理A > B処理B > C
0 A + A +B プラスS + BC
1 A + AB + B S + BC + C
2 AB S + BC
ここで、S は、前の区間と乗り換えの合計処理コストを示します。
fare_product_id fare_products.fare_product_id部` ID 任意 2 つの運賃区間間の乗り換えに必須チケット商品。空の場合、乗り換えルールのコストは 0 です。

areas.txt

ファイル: 任意

主キー(area_id)

エリア識別子を定義します。

フィールド名 タイプ 存在 説明
area_id ユニーク ID 必須 エリアを識別します。areas.txt 内で一意である必要がしなければならない。
area_name Text 任意 乗客に表示されるエリアの名前。

stop_areas.txt

ファイル: 任意

主キー(*)

stops.txt からエリアに停留所等を割り当てます。

フィールド名 タイプ 存在 説明
area_id areas.area_id を参照する外部 ID 必須 1 つまたは複数の stop_id が属するエリアを識別します。同じ stop_id が複数の area_id で定義される場合があります。
stop_id stops.stop_id を参照する外部 ID 必須 停留所を識別します。このフィールドで駅 (つまり、stops.location_type=1 の停留所) が定義されている場合、そのすべてのプラットフォーム (つまり、この駅が stops.parent_station として定義されている stops.location_type=0 のすべての停留所) が同じエリアの一部であると想定されます。この動作は、プラットフォームを他のエリアに割り当てることで上書きできます。

networks.txt

ファイル: 条件付きで禁止

主キー(network_id)

運賃区間ルールに適用されるネットワーク識別子を定義します。

フィールド名 タイプ 存在 説明
network_id ユニーク ID 必須 ネットワークを識別します。networks.txt 内で一意であるしなければならない。
network_name Text 任意 運賃区間のルールに適用されるネットワークの名前。これは、地方事業者とその乗客によって使用されます。

route_networks.txt

ファイル: 条件付きで禁止

主キー(route_id )

routes.txt からのルート・路線系統をネットワークに割り当てます。

フィールド名 タイプ 存在 説明
network_id networks.network_id を参照する外部 ID 必須 1 つまたは複数の route_id が属するネットワークを識別します。route_id は 1 つの network_id でのみ定義できます。
route_id routes.route_id を参照する外部 ID 必須 ルートを識別します。

shapes.txt

ファイル: 任意

主キー(shape_id、 shape_pt_sequence)

ルート形状は、車両がルート線形に沿って移動するパスを説明し、ファイルshapes.txtで定義されます。ルート形状は便に関連付けられ、車両が順番に通過する一連のポイントで構成されます。ルート形状は停留所等の位置を正確にインターセプトする必要はありませんが、トリップのすべての停留所等は、そのトリップの形状からわずかな距離内、つまり形状ポイントを接続する直線セグメントの近くに配置するするべきであるがあります。 shapes.txtファイルは、すべてのルートベースのサービス (ゾーンベースのデマンドレスポンシブサービスではありません) に含めるするべきである。

フィールド名 タイプ 存在 説明
shape_id ID 必須 形状を識別します。
shape_pt_lat 緯度 必須 形状 ポイントの緯度。shapes.txt 内の各レコードは、形状を定義するために使用される形状 ポイントを表します。
shape_pt_lon 経度 必須 形状 ポイントの経度。
shape_pt_sequence 負でない整数 必須 形状 ポイントが接続して形状を形成するシーケンス。値は移動に沿って増加する必要がありますが、連続している必要はありません。
例: 形状 "A_shp" の定義に 3 つのポイントがある場合、shapes.txt ファイルには形状を定義する次のレコードが含まれる可能性があります:
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_pt_sequence とともに増加する必要があり、ルートに沿った逆方向の移動を示すために使用してはなりません。距離の単位は、stop_times.txt で使用されている単位と一致している必要があります。

ループまたはインライン (車両が 1 回の移動で同じ部分の線形を横切ったり通過したりする) があるルートに推奨されます。

車両が移動中にポイントでルート線形をたどったり横断したりする場合、shapes.txt のポイントの一部が stop_times.txt のレコードとどのように対応しているかを明確にするために、shape_dist_traveled が重要です。
例: バスが上記で A_shp に定義した 3 つのポイントに沿って移動する場合、追加の shape_dist_traveled 値 (ここではキロメートル単位で表示) は次のようになります。
shape_id,shape_pt_lat,shape_pt_lon,shape_pt_sequence,shape_dist_traveled
A_shp,37.61956,-122.48161,0,0
A_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 つの異なるタイプのサービスを表すために使用してもよい。

  • 頻度ベースのサービス (exact_times=0) では、サービスは 1 日を通して固定スケジュールに従いません。代わりに、オペレーターは便に対して事前に決定されたヘッドウェイを厳密に維持しようとします。
  • スケジュールベースのサービス (exact_times= 1) の圧縮表現では、指定された期間の便に対してまったく同じヘッドウェイが設定されます。スケジュールベースのサービスでは、オペレーターはスケジュールに厳密に従おうとします。
フィールド名 タイプ 存在 説明
trip_id trips.trip_id部` ID 必須 指定されたサービス間隔が適用される便を識別します。
start_time 時間 必須 最初の車両が指定された間隔で便の最初の停留所から出発する時刻。
end_time 時間 必須 便の最初の停留所でサービスが別の間隔に変更される (または停止する) 時刻。
headway_secs 正の整数 必須 start_timeとend_timeで指定された時間間隔中に、便の同じ停留所 (間隔) から出発する間隔 (秒単位)。同じ便に複数の間隔を定義してもよいが、重複するしてはいけない。新しい運行間隔は、前の運行間隔が終了した正確な時間に開始されるしてもよい。
exact_times 列挙型 任意 便のサービスの種類を示します。詳細については、ファイルの説明を参照してください。有効なオプションは次のとおりです。

0 または空 - 頻度ベースの便。
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 を使用するアプリケーションは、許容される時間と停留所の近接性に基づいて乗り換えを補間します。 Transfers.txt は、選択した乗り換えに対する追加のルールとオーバーライドを指定します。

From_trip_id、 to_trip_id、 from_route_id 、およびto_route_idと、乗り換えルールの詳細度をさらに高めることができます。 from_stop_idとto_stop_idに加えて、詳細度の順位付けは次のようになります:

  1. 両方のtrip_idが定義されています: from_trip_idとto_trip_id。
  2. 1つのtrip_idとroute_idセットが定義されています: (from_trip_idとto_route_id) または (from_route_idとto_trip_id) 。
  3. 1つのtrip_idが定義されています: from_trip_id from_trip_idまたはto_trip_id`。
  4. 両方の route_idが定義されています:from_route_idとto_route_id`。
  5. 1つのroute_idが定義されています: from_route_idまたはto_route_id。
  6. from_stop_idおよびto_stop_id が定義されています: ルートまたは便関連のフィールドは設定されていません。

到着便と出発便の順序付けられたペアが指定されている場合、これら 2 つの便間に適用される最も詳細度の高い乗り換えが選択されます。どの便のペアにも、適用可能な最大詳細度が同等の 2 つの乗り換えが存在することはするべきではない

フィールド名 タイプ 存在 説明
from_stop_id stops.stop_id を参照する外部 ID 条件付きで必須 ルート・路線系統間の接続が開始される停留所または駅を識別します。このフィールドが駅を参照する場合、乗り換えルールはそのすべての子の停留所等に適用されます。transfer_types 4 および5.では駅の参照は禁止されています。
transfer_types to_stop_id stops.stop_id 部 ID 条件付きで必須 ルート・路線系統間の接続が終了する停留所または駅を識別します。このフィールドが駅を参照する場合、転送ルールはすべての子停留所等に適用されます。transfer_types 4 および5.では、駅の参照は禁止されています。
from_route_id routes.route_id 部 ID 任意 接続が始まるルートを識別します。

from_route_idが定義されている場合、乗り換えは指定されたfrom_stop_idのルート上の到着便に適用されます。

from_trip_idとfrom_route_id の両方が定義されている場合、 trip_idはroute_idに属しているしなければならない、 from_trip_id が優先されます。
to_route_id routes.route_id を参照する外部 ID 任意 接続が終了するルートを識別します。

to_route_idが定義されている場合、乗り換えは指定されたto_stop_idのルートの出発便に適用されます。

to_trip_idとto_route_id の両方が定義されている場合、 trip_idはroute_idに属しているしなければならない、 to_trip_id が優先されます。
from_trip_id trips.trip_id 部 ID 条件付きで必須 ルート・路線系統間の接続が始まる便を識別します。

from_trip_idが定義されている場合、乗り換えは指定されたfrom_stop_idの到着便に適用されます。

from_trip_idとfrom_route_id の両方が定義されている場合、 trip_idはroute_idに属しているしなければならない、 from_trip_id が優先されます。 transfer_typeが 4 または 5 の場合は必須。
to_trip_id trips.trip_id 部 ID 条件付きで必須 ルート・路線系統間の接続が終了する便を識別します。

to_trip_idが定義されている場合、乗り換えは指定されたto_stop_idの出発便に適用されます。

to_trip_idとto_route_id の両方が定義されている場合、 trip_idはroute_idに属しているしなければならない、 to_trip_id が優先されます。 transfer_typeが 4 または 5 の場合は必須。
transfer_type Enum 必須 指定された (from_stop_id、 to_stop_id ) ペアの接続タイプを示します。有効なオプションは次のとおりです。

0 または空 -ルート・路線系統間の推奨乗換ポイント。
1 - 2 つのルート・路線系統間の時間指定の乗り換えポイント。出発車両は到着車両を待機し、乗客がルート・路線系統間を乗り換えるのに十分な時間を残すことが求められます。
2 - 乗り継ぎを確実に行うには、到着から出発までの間に最低限の時間が必要です。乗り継ぎに必須時間はmin_transfer_timeで指定します。
3 - その場所ではルート・路線系統間の乗り換えはできません。
4 - 乗客は同じ車両に乗車したまま、ある便から別の便へ乗り換えることができます (座席内乗り換え)。このタイプの乗り換えの詳細については、以下 を参照してください。
5 - 連続する便間での座席内乗り換えは許可されません。乗客は車両から降りて再び乗車しなければならない。このタイプの乗り換えの詳細については、下記を参照してください。
min_transfer_time 負でない整数 任意 指定された停留所等でルート・路線系統間の乗り換えを許可するためにしなければならない時間 (秒単位)。min_transfer_time は、各ルートのスケジュール変更を可能にするバッファ時間を含め、一般的な乗客が 2 つの停留所等間を移動するのに十分な時間であるするべきである。

リンクされた便

以下は、座席内乗り換えの有無にかかわらず、便をリンクするために使用される transfer_type=4 および =5 に適用されます。

リンクされた便は、同じ車両で運行されるしなければならない。車両は、他の車両と連結することも、from_trip_idを解除することしてもよい。

リンクされた便転送と block_id の両方が提供され、矛盾する結果が生成される場合は、リンクされた便転送を使用する必要がありしなければならない。

from_trip_id の最後の停留所は、 to_trip_idの最初の停留所に地理的に近い必要がするべきである、 from_trip_idのfrom_trip_id to_trip_idの最後の到着時刻は、 to_trip_id to_trip_idの最初の出発時刻より後になる場合がしてもよい。

通常の場合、便は1 対 1 でリンクできしてもよいが、より複雑なトリップの継続を表すために、1 対 n、n 対 1、または n 対 n でリンクすることもしてもよい。たとえば、2 つの列車の便(下の図の旅程 A と旅程 B) は、共通の駅で車両連結操作を行った後、1 つの列車の旅程 (旅程 C) に統合できます。

  • 1 対 n の継続では、各 to_trip_id の trips.service_id は同一である必要があります。
  • n 対 1 の継続では、各 from_trip_id の trips.service_id は同一である必要があります。
  • n 対 n の継続では、両方の制約を尊重する必要があります。
  • trip.service_id がどのサービス日でも重複してはならないという条件で、複数の異なる継続の一部として便をリンクできます。
Trip A
───────────────────\
                    \    Trip C
                     ─────────────
Trip B              /
───────────────────/

pathways.txt

ファイル: 任意

主キー(pathway_id)

ファイル pathways.txt と levels.txt は、グラフ表現を使用して地下鉄や電車の駅を記述し、ノードが場所を、エッジが構内通路を表します。

駅の出入口 (場所としてlocation_type=2で表されるノード) からプラットフォーム (場所としてlocation_type=0または空で表されるノード) に移動するには、乗客は通路、改札口、階段、および構内通路として表されるその他のエッジを通過します。汎用ノード (場所としてlocation_type=3で表されるノード) は、駅全体の構内通路を接続するために使用できます。

構内通路は、駅内で網羅的に定義するしなければならない。構内通路が定義されている場合は、駅全体のすべての構内通路が表されているものとみなされます。したがって、次のガイドラインが適用されます。

  • ぶら下がっている場所は禁止: 駅内のいずれかの場所に経路がある場合は、乗車エリア ( location_type=4 、以下のガイドラインを参照) があるプラットフォームを除き、その駅内のすべての場所に構内通路がするべきである。
  • 乗車エリアのあるプラットフォームには構内通路がありません: 乗車エリア ( location_type=4) があるプラットフォーム (location_type=0`または空) は、ポイントではなく親オブジェクトとして扱われます。このような場合、プラットフォームに構内通路を割り当ててはしてはいけない。すべての構内通路は、プラットフォームの各乗車エリアに割り当てるするべきである。
  • ロックされたプラットフォームは禁止: 各プラットフォーム (location_type=0または空) または乗車エリア (location_type=4 ) は、構内通路のチェーンを介して少なくとも 1 つの出入口 ( location_type=2 ) に接続されているしなければならない。特定のプラットフォームから駅の外への経路を許可しない駅はまれです。
フィールド名 タイプ 存在 説明
pathway_id 一意の ID 必須 経路を識別します。システムによってレコードの内部識別子として使用されます。データセット内で一意である必要があります。

異なる経路で、from_stop_id と to_stop_id の値が同じになる場合があります。
例: 2 つのエスカレーターが反対方向に並んでいる場合、または階段セットとエレベーターが同じ場所から同じ場所に行く場合、異なる pathway_id で from_stop_id と to_stop_id の値が同じになる場合があります。
from_stop_id stops.stop_id を参照する外部 ID 必須 経路が始まる場所です。

プラットフォーム (location_type=0 または空)、入口/出口 (location_type=2)、汎用ノード (location_type=3)、または乗車エリア (location_type=4) を識別する stop_id を含める必要があります。

駅 (location_type=1) を識別する stop_id の値は使用できません。
to_stop_id stops.stop_id を参照する外部 ID 必須 経路が終了する場所です。

プラットフォーム (location_type=0 または空)、入口/出口 (location_type=2)、汎用ノード (location_type=3)、または乗車エリア (location_type=4) を識別する stop_id を含める必要があります。

駅 (location_type=1) を識別する stop_id の値は使用できません。
pathway_mode Enum 必須 指定された (from_stop_id、to_stop_id) ペア間の経路の種類。有効なオプションは次のとおりです:

1 - 歩道。
2 - 階段。
3 - 動く歩道/移動式歩行者。
4 - エスカレーター。
5 - エレベーター。
6 - 改札口 (または支払いゲート): 駅のエリアに渡る通路で、通過するには支払いの証明が必要です。改札口は、駅の有料エリアと無料エリアを分けたり、同じ駅内の異なる支払いエリアを互いに分けたりします。この情報を使用すると、乗客に不要な支払いを要求する近道を使用して駅を経由するルートを回避できます (たとえば、乗客に地下鉄のプラットフォームを歩いてバスウェイに行くように指示するなど)。
7- 出口ゲート: 有料エリアから、通過するのに支払いの証明が不要な無料エリアに出る通路。
is_bidirectional Enum 必須 経路を進むことができる方向を示します:

0 - from_stop_id から to_stop_id までのみ使用できる一方向経路。
1 - 両方向に使用できる双方向経路。

出口ゲート (pathway_mode=7) は双方向にすることはできません。
length 負でない浮動小数点数 任意 出発地 (from_stop_id で定義) から目的地 (to_stop_id で定義) までの経路の水平方向の長さ (メートル単位)。

このフィールドは、歩道 (pathway_mode=1)、料金ゲート (pathway_mode=6)、出口ゲート (pathway_mode=7) に推奨されます。
traversal_time 正の整数 任意 出発地 (from_stop_id で定義) から目的地 (to_stop_id で定義) までの経路を歩くのにかかる平均時間 (秒単位)。

このフィールドは、動く歩道 (pathway_mode=3)、エスカレーター (pathway_mode=4)、エレベーター (pathway_mode=5) に推奨されます。
stair_count null 以外の整数 任意 経路の階段の数。

正の stair_count は、乗客が from_stop_id から to_stop_id まで上ることを意味します。負の stair_count は、乗客が from_stop_id から to_stop_id まで下ることを意味します。

このフィールドは、階段 (pathway_mode=2) に推奨されます。

推定の階段数しか提供できない場合は、1 フロアあたり 15 段と概算することをお勧めします。
max_slope 浮動小数点数 任意 通路の最大傾斜率。有効なオプションは次のとおりです:

0 または空 - 傾斜なし。
浮動小数点数 - 通路の傾斜率。上向きの場合は正、下向きの場合は負。

このフィールドは、歩道 (pathway_mode=1) および動く歩道 (pathway_mode=3) でのみ使用してください。
例: 米国では、0.083 (8.3% とも表記) が手押し式車椅子の最大傾斜率で、1 メートルごとに 0.083 メートル (つまり 8.3 センチメートル) 増加することを意味します。
min_width 正の浮動小数点数 任意 通路の最小幅 (メートル単位)。

最小幅が 1 メートル未満の場合は、このフィールドを使用することをお勧めします。
signposted_as テキスト 任意 乗客に見える物理的な標識からの一般向けのテキスト。

「標識に従ってください」など、乗客にテキストの指示を提供するために使用できます。singposted_as 内のテキストは、標識に印刷されているとおりに表示される必要があります。

物理的な標識が多言語の場合、このフィールドは、feed_info.feed_lang のフィールド定義の stops.stop_name の例に従って入力および翻訳できます。
reversed_signposted_as テキスト 任意 signposted_as と同じですが、経路が to_stop_id から from_stop_id まで使用される場合です。

levels.txt

ファイル: 条件付きで必須

主キー(level_id)

駅の階・フロアを説明します。pathways.txt と併用すると便利です。

フィールド名 タイプ 存在 説明
level_id 一意の ID 必須 駅内の階を識別します。
level_index 浮動小数点 必須 階の相対位置を示す数値インデックス。

地上階のインデックスは 0 で、地上階は正のインデックスで、地下階は負のインデックスで示されます。
level_name テキスト 任意 建物または駅内の乗客から見た階の名前。
例: エレベーターで「中二階」または「プラットフォーム」または「-1」まで行きます。

location_groups.txt

ファイル: 任意

主キー(location_group_id )

乗客が乗車または降車をリクエストしてもよい停留所等のグループである場所グループを定義します。

フィールド名 タイプ 存在 説明
location_group_id ユニーク ID 必須 場所グループを識別します。IDは、すべての stops.stop_id、 locations.geojson id、および location_groups.location_group_id 値で一意である必要がしなければならない。

ロケーション グループとは、乗客が乗車または降車をリクエストしてもよいロケーションをまとめて示す停留所等のグループです。
location_group_name Text 任意 乗客に表示されるロケーショングループの名前。

location_group_stops.txt

ファイル: 任意

主キー(*)

場所グループにstops.txtからの停留所を割り当てます。

フィールド名 タイプ 存在 説明
location_group_id location_groups.location_group_id を参照する外部 ID 必須 1 つまたは複数の stop_id が属する場所グループを識別します。同じ stop_id が複数の location_group_id で定義される場合があります。
stop_id stops.stop_id を参照する外部 ID 必須 場所グループに属する停留所を識別します。

locations.geojson

ファイル: 任意

乗客がオンデマンド サービスによる乗車または降車をリクエストできるゾーンを定義します。これらのゾーンは、GeoJSON ポリゴンとして表されます。

  • このファイルは、RFC 7946で説明されている GeoJSON 形式のサブセットを使用します。
  • locations.geojsonファイルには、 FeatureCollectionが含まれているしなければならない。
  • FeatureCollectionは、乗客が乗車または降車をリクエストしてもよいさまざまな停留所の場所を定義します。
  • すべての GeoJSON Featureにはidがしなければならない。 idは、すべてのstops.stop_id、 locations.geojson id、およびlocation_group_id値で一意であるしなければならない。
  • すべての GeoJSON Featureには、次の表に従ってオブジェクトと関連キーがするべきである:
フィールド名 タイプ 存在 説明
- type 文字列 必須 場所の "FeatureCollection"。
- features 配列 必須 場所を説明する "Feature" オブジェクトのコレクション。
    - type 文字列 必須 "Feature"
    - id 文字列 必須 場所を識別します。 ID は、stops.stop_id、locations.geojson id、および location_groups.location_group_id のすべての値で一意である必要があります。
    - properties オブジェクト 必須 場所のプロパティ キー。
        - stop_name 文字列 任意 乗客に表示される場所の名前を示します。
       - stop_desc 文字列 任意 乗客の方向を示すための場所のわかりやすい説明。
    - geometry オブジェクト 必須 場所のジオメトリ。
        - type 文字列 必須 次のタイプである必要があります:
- "Polygon"
- "MultiPolygon"
       - coordinates 配列 必須 場所のジオメトリを定義する地理座標 (緯度と経度)。

booking_rules.txt

ファイル: 任意

主キー(booking_rule_id)

乗客が要求するサービスの予約ルールを定義します

フィールド名 タイプ 存在 説明
booking_rule_id 一意の ID 必須 ルールを識別します。
booking_type 列挙型 必須 どのくらい前に予約できるかを示します。有効なオプションは次のとおりです:

0 - リアルタイム予約。
1 - 事前通知による当日予約まで。
2 - 前日予約まで。
prior_notice_duration_min 整数 条件付きで必須 リクエストを行う便前の最小分数。

条件付きで必須:
- booking_type=1 の場合は 必須。
- それ以外の場合は 禁止。
prior_notice_duration_max 整数 条件付きで禁止 予約リクエストを行う便前の最大分数。

条件付きで禁止:
- booking_type=0 および booking_type=2 の場合は 禁止。
- booking_type=1 の場合は任意。
prior_notice_last_day 整数 条件付きで必須 予約リクエストを行う便前の最終日。

例: 「乗車は 1 日前の午後 5 時前に予約する必要があります」は prior_notice_last_day=1 としてエンコードされます。

条件付きで必須:
- booking_type=2 の場合は 必須。
- それ以外の場合は 禁止。
prior_notice_last_time 時間 条件付きで必須 便前日の予約リクエストを行う最終時間。

例: 「乗車は 1 日前の午後 5 時までに予約する必要があります」は、prior_notice_last_time=17:00:00 としてエンコードされます。

条件付きで必須:
- prior_notice_last_day が定義されている場合は必須。
- それ以外の場合は禁止。
prior_notice_start_day 整数 条件付きで禁止 予約リクエストを行う便前の最も早い日。

例: 「乗車は最短で 1 週間前の深夜に予約できます」は、prior_notice_start_day=7 としてエンコードされます。

条件付きで禁止:
- booking_type=0 の場合は 禁止。
- prior_notice_duration_max が定義されている場合は booking_type=1 の場合は 禁止。
- それ以外の場合は任意。
prior_notice_start_time 時間 条件付きで必須 予約リクエストを行う便の最も早い日の最も早い時間。

例: 「乗車は最短で 1 週間前の深夜に予約できます」は、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 がカウントされるサービス日を示します。

例: 空の場合、prior_notice_start_day=2 は 2 暦日前になります。営業日 (休日のない平日) のみを含む service_id として定義されている場合、prior_notice_start_day=2 は 2 営業日前になります。

条件付きで禁止:
- booking_type=2 の場合は任意。
- それ以外の場合は 禁止。
message テキスト 任意 オンデマンドのピックアップとドロップオフを予約するときに、stop_time でサービスを利用する乗客へのメッセージ。ユーザー インターフェイス内で送信される、サービスを利用するために乗客が実行する必要があるアクションに関する最小限の情報を提供することを目的としています。
pickup_message テキスト 任意 message と同じように機能しますが、乗客がオンデマンドのピックアップのみを利用する場合に使用されます。
drop_off_message テキスト 任意 message と同じように機能しますが、乗客がオンデマンドのドロップオフのみを利用する場合に使用されます。
phone_number 電話番号 任意 予約リクエストを行うために電話する電話番号。
info_url URL 任意 予約ルールに関する情報を提供する URL。
booking_url URL 任意 予約リクエストを行うことができるオンライン インターフェイスまたはアプリへの URL。

translations.txt

ファイル: 任意

主キー(table_name、field_name、language、record_id、record_sub_id、field_value)

複数の公用語がある地域では、交通事業者/運営者は通常、言語固有の名前とウェブページを持っています。それらの地域の乗客に最適なサービスを提供するために、データセットにこれらの言語に依存する値を含めることは有用です。

2 つの異なる行で同じ値を翻訳するために (record_id、record_sub_id) と field_value の両方の参照方法が使用されている場合、(record_id、record_sub_id) で提供される翻訳が優先されます。

フィールド名 タイプ 存在 説明
table_name 列挙型 必須 翻訳するフィールドを含むテーブルを定義します。 許可される値は次のとおりです:

- agency
- stops
- routes
- trips
- stop_times
- pathways
- levels
- feed_info
- attributions

GTFS に追加されるファイルには、上記のファイル名 (つまり、.txt ファイル拡張子を含まない) と同等の table_name 値が含まれます。
field_name テキスト 必須 翻訳するフィールドの名前。 Text タイプのフィールドは翻訳できます。URL、Email、Phone number タイプのフィールドも、正しい言語でリソースを提供するために「翻訳」できます。他のタイプのフィールドは翻訳しないでください。
language 言語コード 必須 翻訳の言語。

言語が feed_info.feed_lang と同じ場合、フィールドの元の値は、特定の翻訳のない言語で使用するデフォルト値とみなされます (default_lang で特に指定されていない場合)。
例: スイスでは、公式にバイリンガルの州にある都市は正式には「Biel/Bienne」と呼ばれますが、フランス語では単に「Bienne」、ドイツ語では「Biel」と呼ばれます。
translation テキスト、URL、Email、または電話番号 必須 翻訳された値。
record_id 外国人 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。<br><br>条件付きで必須:<br>-table_nameが次の場合は**禁止**。feed_info。<br>-field_valueが定義されている場合は**禁止**です。<br>-field_value` が空の場合は必須です。
record_sub_id 外部 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。<br><br>条件付きで必須:<br>-table_nameがfeed_infoの場合は**禁止**。<br>-field_valueが定義されている場合は**禁止**です。<br>-table_name=stop_timesおよびrecord_id` が定義されている場合は必須です。
field_value テキスト、URL、メール、または電話番号 条件付きで必須 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 Text 必須 データセットを公開する組織のフルネーム。これは、 agency.agency_name値のいずれかと同じであるしてもよい。
feed_publisher_url URL 必須 データセットを公開する組織の Web サイトの URL。これは、 agency.agency_url値のいずれかと同じであるしてもよいがあります。
feed_lang 言語コード 必須 このデータセットのテキストに使用されるデフォルトの言語。この設定は、GTFS の利用者がデータセットの大文字化ルールやその他の言語固有の設定を選択するのに役立ちます。テキストをデフォルト以外の言語に翻訳する必要がある場合は、ファイル translations.txt を使用できます。

元のテキストが複数の言語であるデータセットの場合、デフォルトの言語は多言語になることがあります。このような場合、feed_lang フィールドに ISO 639-2 規格で定義されている言語コード mul を含め、データセットで使用されている各言語の翻訳を translations.txt で提供する必要があります。データセットの元のテキストがすべて同じ言語である場合は、mul を使用しないでください。
_例: スイスなどの多言語国のデータセットで、元の stops.stop_name フィールドにさまざまな言語の停留所名が入力されているとします。各停留所名は、その停留所の地理的位置で主に使用されている言語に従って表記されます。たとえば、フランス語圏の都市ジュネーブの場合は「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 date 推奨 データセットは、feed_start_date 日の開始からfeed_end_date``feed_start_dateの終了までの期間のサービスの完全で信頼性の高いスケジュール情報を提供します。両方の日付が利用できない場合は空白のままにするしてもよい。両方が指定されている場合、 feed_end_datedateはfeed_start_datedateより前にしてはしてはいけない。データセットプロバイダーは、今後のサービスの可能性を通知するためにこの期間外のスケジュールデータを提供することが推奨が、データセット利用者はそれが正式なものではないことに留意して扱うするべきである。 feed_start_dateまたはfeed_end_dateが calendar.txt および calendar_dates.txt で定義されている有効なカレンダーの日付を超える場合、データセットは、 feed_start_dateまたはfeed_end_date の範囲内で、有効なカレンダーの日付に含まれない日付にはサービスがないことを明示的に主張しています。
feed_end_date date 推奨 (上記を参照)
feed_version Text 推奨 GTFS データセットの現在のバージョンを示すstring。GTFS を使用するアプリケーションはこの値を表示して、データセットの公開者が最新のデータセットが組み込まれているかどうかを判断できるようにします。
feed_contact_email メール 任意 GTFS データセットとデータ公開方法に関する連絡用のメール アドレス。feed_contact_email は、 GTFS を使用するアプリケーションの技術担当者の連絡先です。 agency.txt を通じてカスタマー サービスの連絡先情報を提供します。feed_contact_email またはfeed_contact_urlも1つを指定することを推奨。
feed_contact_url URL 任意 GTFS データセットとデータ公開方法に関する連絡用の連絡先情報、ウェブフォーム、サポート デスク、またはその他のツールのfeed_contact_urlは、GTFS を利用するアプリケーションの技術担当者の連絡先です。 agency.txt を通じてカスタマー サービスの連絡先情報を提供します feed_contact_url または feed_contact_email も1つを指定することを推奨。

attributions.txt

ファイル: 任意

主キー(attribution_id)

このファイルは、データセットに適用される帰属組織を定義します。

フィールド名 タイプ 存在 説明
attribution_id 一意の ID 任意 データセットまたはそのサブセットの属性を識別します。これは主に翻訳に役立ちます。
agency_id agency.agency_id を参照する外部 ID 任意 属性が適用される事業者。

agency_id、route_id、または trip_id 属性のいずれかが定義されている場合、他の属性は空である必要があります。いずれも指定されていない場合、属性はデータセット全体に適用されます。
route_id routes.route_id を参照する外部 ID 任意 属性がルートに適用される点を除き、agency_id と同じように機能します。同じルートに複数の属性を適用できます。
trip_id trips.trip_id を参照する外部 ID 任意 agency_id と同じように機能しますが、帰属が便に適用されます。同じ便に複数の帰属が適用される場合があります。
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 電話番号 任意 組織の電話番号。