Skip to content

Commit

Permalink
Translate Technical Documentation section
Browse files Browse the repository at this point in the history
  • Loading branch information
Sergiodero committed Aug 30, 2024
1 parent 568ce18 commit 49ec0b6
Show file tree
Hide file tree
Showing 39 changed files with 7,313 additions and 0 deletions.
30 changes: 30 additions & 0 deletions docs/ja/documentation/overview.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
#General Transit Feed Specification(GTFS)

General Transit Feed Specification(GTFS) は、交通システムに関する関連情報を乗客に配信するために使用される [オープン スタンダード](https:) です。これにより、公共交通事業者は、さまざまなソフトウェア アプリケーションで使用できる形式で交通データを公開できます。

GTFS は、[GTFS Schedule](../schedule/reference)[GTFS Realtime](../realtime/reference) という 2 つの主要な部分で構成されています。

## [GTFS Schedule](../schedule/reference)

GTFS Scheduleは、静的な公共交通機関情報の共通形式を定義するフィード仕様です。これは、単一の ZIP ファイルに含まれる、ほとんどがテキスト ファイル (.txt) である単純なファイルのコレクションで構成されています。

各ファイルは、停留所、ルート、旅行などの交通情報の特定の側面を記述します。最も基本的な形式では、 GTFS Scheduleデータセットは 7 つのファイルで構成されます: `agency.txt``routes.txt``trips.txt``stops.txt``stop_times.txt``calendar.txt` 、および`calendar_dates.txt`ル` セットに加えて、追加の (オプションの) ファイルをグループ化して、運賃、翻訳、乗り換え、駅構内経路などの他のサービス要素の情報を提供することもできます。現在、GTFS の基本要素を拡張する 15 を超えるオプション ファイルがあり、その中には、地理的領域を表すために使用できるテキスト ファイル ( .txt ) 以外の新しい形式を導入したlocations.geojsonも含まれます。

すべてのGTFS Scheduleファイルの信頼できる情報源は、公式の [GTFS Scheduleリファレンス](../schedule/reference) です。このリファレンスには、 GTFS Scheduleデータセットを構成する各ファイルのすべての情報要素の要件に関する詳細情報が記載されています。


## [GTFS Realtime](../realtime/reference)

GTFS Realtimeは、公共交通機関が現在の到着時刻と出発時刻、サービス アラート、車両の位置に関する最新情報を提供できるようにするフィード仕様であり、ユーザーはスムーズに旅行を計画できます。

この仕様では現在、次の種類の情報がサポートされています。

- 旅行の更新 - 遅延、キャンセル、ルート変更
- サービス アラート - 停留所の移動、駅、ルート、またはネットワーク全体に影響を及ぼす予期しないイベント
- 車両の位置 - 場所や混雑レベルなどの車両に関する情報

詳細については、[フィード エンティティ](../realtime/feed_entities/overview) セクションをご覧ください。

GTFS Realtimeは、実装の容易さ、優れたGTFS の相互運用性と乗客情報への重点。これは、[初期の Live Transit Updates](https://developers.google.com/transit/google-transit#LiveTransitUpdates) パートナー機関、多数の交通機関開発者、および Google のパートナーシップを通じて実現しました。仕様は [Apache 2.0 ライセンス](http://www.apache.org/licenses/LICENSE-2.0.html) に基づいて公開されています。

GTFSGTFS Realtimeデータ交換形式は [Protocol Buffers](https://developers.google.com/protocol-buffers/) に基づいています。これは、構造化データをシリアル化するための言語およびプラットフォームに依存しないメカニズムです (XML のようなものですが、より小さく、より高速で、よりシンプルです)。 GTFS Scheduleと同様に、[GTFS Realtimeリファレンス](../realtime/reference) は、あらゆるGTFS Realtimeフィードのルールと要件を確立する信頼できる情報源であり、[gtfs-realtime.proto](../realtime/proto) ファイルは、使用される要素の階層とそのタイプ定義を定義します。
103 changes: 103 additions & 0 deletions docs/ja/documentation/realtime/change_history/recent_additions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
# GTFS Realtimeの変更

GTFSGTFS Realtimeリファレンスは固定されたものではありません。 GTFS Realtimeを使用する交通機関、開発者、その他の関係者のコミュニティによって開発および保守されているオープン仕様です。 GTFS Realtimeデータのプロデューサーとコンシューマーのこのコミュニティは、新しい機能を有効にするために仕様を拡張するための提案をすることが期待されていますGTFS Realtimeに貢献するには、[GTFS Realtime修正プロセス](../../../../community/governance/gtfs_realtime_amendment_process)を読み、GTFS Github リポジトリ ( <a href="https://github.com/google/transit" target="_blank">google/transit</a> ) の未解決の<a href="https://github.com/google/transit/issues" target="_blank">問題</a>と<a href="https://github.com/google/transit/pulls" target="_blank">プル リクエスト</a>での議論に従ってください。 ![](../../../assets/mark-github.svg)

<!-- <div class="row">
<div class="active-container">
<h3 class="title"><a class="no-icon" href="https://github.com/google/transit/pull/332" target="_blank">Add cause_detail and effect_detail to Alerts</a></h3>
<p class="maintainer">#332 opened on May 31, 2022 by <a class="no-icon" href="https://github.com/mckenzie-maidl-ibigroup" target="_blank">mckenzie-maidl-ibigroup</a></p>
</div>
</div>
<div class="row"></div> -->

<!-- <div class="row no-active">
<div class="no-active-container">
<h3 class="title">There are currently no active proposals for GTFS Realtime.</h3>
<p class="prompt">Have a proposal? &ensp;➜&ensp; Open a <a href="https://github.com/google/transit/pulls" target="_blank">pull request</a>.</p>
</div>
</div>
<div class="row"></div> -->

## 最近採択された提案<img src="../../../../assets/pr-merged.svg" style="height:1em;"/>

最近統合された提案は、[公式GTFS Realtimeリファレンス](../../reference) の機能になりました。詳細については、完全な [改訂履歴](../revision_history) を参照してください。


<div class="row">
<div class="leftcontainer">
<h3 class="title"><a href="https://github.com/google/transit/pull/403" class="no-icon" target="_blank">旅行の変更を追加する</a></h3>
<p class="maintainer"> <a href="https://github.com/gcamp" class="no-icon" target="_blank">gcamp</a>による#332 は 2024 年 3 月 11 日にマージされました</p>
</div>
<div class="featurelist">
<ul>
<li>一連の旅行に影響する迂回路を説明するために使用される旅行変更を実験的な機能として追加します。</li>
<li>旅行の変更により、特定の停車地をキャンセルしたり、旅行のタイミングを調整したり、旅行の新しい形を提供したり、途中の一時的な停車地の場所を提供したりすることができます。</li>
</ul>
</div>
</div>

<div class="row">
<div class="leftcontainer">
<h3 class="title"> <a href="https://github.com/google/transit/pull/352" class="no-icon" target="_blank">schedule_relationship に DELETED 列挙型を追加します。</a></h3>
<p class="maintainer"> <a href="https://github.com/mads14" class="no-icon" target="_blank">mads14</a>による#332 は 2022 年 11 月 30 日に統合されました</p>
</div>
<div class="featurelist">
<ul>
<li>新しい実験的な<code>DELETED</code>旅行スケジュール関係列挙型を追加します</li>
<li>これは、交通機関のプロバイダーが、公共向けアプリケーションから旅行を完全に消すことを意図していることを伝えるために使用できます。</li>
</ul>
</div>
</div>

<div class="row">
<div class="leftcontainer">
<h3 class="title"><a href="https://github.com/google/transit/pull/332" class="no-icon" target="_blank">アラートに cause_detail と effect_detail を追加する</a></h3>
<p class="maintainer"> <a href="https://github.com/mckenzie-maidl-ibigroup" class="no-icon" target="_blank">mckenzie-maidl-ibigroup</a>による#332 は 2022 年 6 月 26 日にマージされました</p>
</div>
<div class="featurelist">
<ul>
<li>アラートの原因と影響の説明を追加します</li>
</ul>
</div>
</div>

<div class="row">
<div class="leftcontainer">
<h3 class="title"> <a href="https://github.com/google/transit/pull/340" class="no-icon" target="_blank">GTFS-rt: 車椅子アクセスのアップデート</a></h3>
<p class="maintainer">#340 by <a href="https://github.com/flaktack" class="no-icon" target="_blank">flaktack</a>は 2022 年 7 月 25 日に統合されました</p>
</div>
<div class="featurelist">
<ul>
<li>旅行のアクセシビリティに関するリアルタイム情報を追加</li>
<li>指定されている場合、 GTFS Scheduleデータセットの<code>trips.wheelchair_accessible</code>を上書きします。</li>
</ul>
</div>
</div>

<div class="row">
<div class="leftcontainer">
<h3 class="title"><a href="https://github.com/google/transit/pull/283" class="no-icon" target="_blank">アラート内の機能/画像</a></h3>
<p class="maintainer"> <a href="https://github.com/gcamp" class="no-icon" target="_blank">gcamp</a>による#283 は 2021 年 11 月 26 日にマージされました</p>
</div>
<div class="featurelist">
<ul>
<li>アプリのサービスアラートに表示される画像(写真や地図など)へのURLリンクのフィールドを追加し、アラートの理解度を高めます。</li>
<li>変更内容: 画像のサイズ制限の強制、アラートごとに 1 つの画像、画像の内容や言語が変更された場合の URL の変更の保証</li>
</ul>
</div>
</div>

<div class="row">
<div class="leftcontainer">
<h3 class="title"> <a href="https://github.com/google/transit/pull/272" class="no-icon" target="_blank">GTFS-NewShapes を実験的に追加</a></h3>
<p class="maintainer">#272 by <a href="https://github.com/ericouyang" class="no-icon" target="_blank">ericouyang</a>は2021年8月30日に統合されました</p>
</div>
<div class="featurelist">
<ul>
<li>迂回ルートを反映するためにルート形状をリアルタイムで更新する機能</li>
<li>ルートの更新は、既存の<code>shape_id</code>参照するか、エンコードされたポリラインとして新しいシェイプをリアルタイムで定義することによって反映されます。</li>
</ul>
</div>
</div>

<div class="row"></div>
118 changes: 118 additions & 0 deletions docs/ja/documentation/realtime/change_history/revision_history.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,118 @@
# GTFS Realtime### 改訂履歴

#### 2024 年 3 月

* 旅程変更を採用しました。[ディスカッション](https://github.com/google/transit/pull/403) を参照してください。

#### 2022 年 11 月

* 削除された旅程のサポートを追加しました。[ディスカッション](https://github.com/google/transit/pull/352) を参照してください。

#### 2022 年 7 月

* cause_detail と effect_detail を追加しました。[ディスカッション](https://github.com/google/transit/pull/332) を参照してください。
* TripUpdate. VehicleDescriptorで wheels_accessible 値を指定できるようになりました。 [ディスカッション](https://github.com/google/transit/pull/340) を参照してください。

#### 2021 年 9 月

* アラートの機能/画像。[ディスカッション](https://github.com/google/transit/pull/283) を参照してください。

#### 2021 年 8 月

* GTFS-NewShapes を試験的に追加。[ディスカッション](https://github.com/google/transit/pull/272) を参照してください。

#### 2021 年 4 月

* TripUpdateに department_occupancy_status を追加します。[ディスカッション](https://github.com/google/transit/pull/260) を参照してください。

#### 2021 年 2 月

* GTFS Realtimeの乗車率の説明を明確化。 [ディスカッション](https:](https://github.com/google/transit/pull/237) を参照してください。

#### 2020 年 4 月

* 停留所の割り当てに対応しました。[ディスカッション](https://github.com/google/transit/pull/219) を参照してください。

#### 2020 年 7 月

* 重複した旅行に対応しました。[ディスカッション](https://github.com/google/transit/pull/221) を参照してください。
* アラート tts_header_text、tts_description_text は試験運用ではなくなりました。 [ディスカッション](https://github.com/google/transit/pull/229) を参照してください。
* GTFS-RT ADDED の旅行を、完全に指定されていないものとしてラベル付けします。[ディスカッション](https://github.com/google/transit/pull/230) を参照してください。

#### 2020 年 4 月

* SeverityLevel をfinal としてマークします。[ディスカッション](https://github.com/google/transit/pull/214) を参照してください。
* occupancy_percentage を追加します。[ディスカッション](https://github.com/google/transit/pull/213) を参照してください。

#### 2020 年 3 月 12 日

* ブロック内の次の旅行についてTripUpdate予測を提供することを推奨します。 [ディスカッション](https://github.com/google/transit/pull/206) を参照してください。

#### 2019 年 8 月

* trip_updates はフィード内でブロック順に発生する必要がないことを文書化しました。[ディスカッション](https://github.com/google/transit/pull/176) を参照してください。
* StopTimeUpdate. ScheduleRelationship UNSCHEDULED 値を追加します。[ディスカッション](https://github.com/google/transit/pull/173) を参照してください。

#### 2019 年 5 月

* アクセシビリティの問題アラート効果を追加します。[ディスカッション](https://github.com/google/transit/pull/164) を参照してください。

#### 2019 年 2 月

* GTFS リアルタイム サービス アラートに NO_EFFECT 効果オプションを追加します。 [ディスカッション](https://github.com/google/transit/pull/137) を参照してください。
* Service Alerts フィードに新しいオプション フィールドSeverityLevelを追加します。[ディスカッション](https://github.com/google/transit/pull/136) を参照してください。
* Service Alerts フィードにテキスト読み上げ機能用の新しいオプション フィールドを追加します。[ディスカッション](https://github.com/google/transit/pull/135) を参照してください。

#### 2018 年 4 月

* SCHEDULED ルートの stop_time_update 到着と出発の要件を削除します。[ディスカッション](https://github.com/google/transit/pull/165) を参照してください。

#### 2017 年 8 月

* GTFS リアルタイム フィールドのセマンティック カーディナリティを定義します。 [ディスカッション](https://github.com/google/transit/pull/64) を参照してください。

#### 2015 年 1 月 30 日

* 残りのすべての GTFS リアルタイム メッセージに Protocol Buffer 拡張名前空間を追加しました ( `FeedMessage``FeedEntity`など)。

#### 2015 年 1 月 28 日

* `TripUpdate`に試験的なフィールド`delay`を追加しました ([ディスカッション](https://groups.google.com/forum/#!topic/gtfs-realtime/NsTIRQdMNN8))。

#### 2015 年 1 月 16 日

* `TripDescriptor.start_time`の説明を更新しました。

#### 2015 年 1 月 8 日

* 試験的な列挙型`OccupancyStatus`を定義しました。
* 試験的なフィールドを追加しました`occupancy_status``VehiclePosition`に変更しました ([ディスカッション](https://groups.google.com/forum/#!topic/gtfs-realtime/_HtNTGp5LxM))。

#### 2014 年 5 月 22 日

* `StopTimeUpdate`messageの`ScheduleRelationship`列挙型の説明を更新しました ([ディスカッション](https://groups.google.com/forum/#!topic/gtfs-realtime/77c3WZrGBnI))。
* `TripDescriptor`messageの`ScheduleRelationship`ら` REPLACEMENT を削除しました ([ディスカッション](https://groups.google.com/forum/#!topic/gtfs-realtime/77c3WZrGBnI))。

#### 2014 年 10 月 12 日2012

* `TripUpdate`プ` フィールドを追加しました。

#### 2012 年 5 月 30 日

* 仕様に拡張機能に関する具体的な詳細を追加しました。

#### 2011 年 11 月 30 日

* 仕様の拡張機能の記述を容易にするため、主要な GTFS リアルタイム メッセージに Protocol Buffer 拡張名前空間を追加しました。

#### 2011 年 10 月 25 日

* `alert``header_text``description_text`ン` テキスト値であることを明確化するためにドキュメントを更新しました。

#### 2011 年 8 月 20 日

* `TimeRange`messageのセマンティクスを明確にするためにドキュメントを更新しました。

#### 2011 年 8 月 22 日

* 初期バージョン。
Loading

0 comments on commit 49ec0b6

Please sign in to comment.