Skip to content

Commit

Permalink
Translate Getting started section into JP
Browse files Browse the repository at this point in the history
  • Loading branch information
@Sergiodero
Sergiodero committed Aug 29, 2024
1 parent 0b30cf2 commit 0691ee0
Show file tree
Hide file tree
Showing 13 changed files with 2,149 additions and 0 deletions.
44 changes: 44 additions & 0 deletions docs/ja/getting_started/create.md
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# GTFS データセットの作成

## GTFS フィードの概要
すべての GTFS フィードは、GTFS リファレンス形式のデータセットから始まります。これは、 .txtファイル拡張子で保存された一連の CSV ファイルです[^1]。最も基本的な実装では、GTFS データセットは通常、7 つの基本ファイルから始まり、安定したパブリック URL でホストされる .zip ファイルにまとめられます。これが GTFS フィードです。

<img class="center" width="560" height="100%" src="../../../assets/create_001.png">

各ファイルは、複数の情報フィールドを持つ複数のレコード（データ行）のリストで構成されています。たとえば、[routes.txt](../../documentation/schedule/reference/#routestxt) にリストされている各行は公共交通機関のルートを表し、そのフィールドはルートの名前、説明、運行機関など、ルートの複数の要素を記述します。

<img class="center" width="560" height="100%" src="../../../assets/create_002.png">

GTFS データセットの基本ファイルは、次のように記述できます。GTFSGTFS scheduleデータセットには 1 つ以上のルート ([routes.txt](../../documentation/schedule/reference/#routestxt)) が含まれ、各ルートには 1 つ以上の旅行 ([trips.txt](../../documentation/schedule/reference/#tripstxt)) が含まれ、各旅行は指定された時間 ([stop_times.txt](../../documentation/schedule/reference/#stop_timestxt)) に一連の停車地 ([stops.txt](../../documentation/schedule/reference/#stopstxt)) を訪問します。便と停車時刻には時刻情報のみが含まれます。カレンダーは、特定の旅行が実行される日を決定するために使用されます ([calendar.txt](../../documentation/schedule/reference/#calendartxt) および [calendar_dates.txt](../../documentation/schedule/reference/#calendar_datestxt))。さらに、複数の機関 ([agency.txt](../../documentation/schedule/reference/#agencytxt)) が複数のルートを運行できます。これらのファイルは、相互参照されるフィールドを使用して互いにリンクされています。

<img class="center" width="560" height="100%" src="../../../assets/create_003.png">

これらのファイルを設定し、基本的な GTFS データセットを作成したら、その他の機能や交通機関とベンダー間の特定のニーズに対応するために、追加の（オプションの）ファイルを追加できます。これらのファイルの例としては、

- [shapes.txt](../../documentation/schedule/reference/#shapestxt) があります。これにより、旅行の経路をグラフィカルに表現できます。
- [pathways.txt](../../documentation/schedule/reference/#pathwaystxt) は、ユーザーが駅をナビゲートするのに役立つ道順を生成するための情報を提供します。
- [frequencies.txt](../../documentation/schedule/reference/#frequenciestxt) は、停車時刻を指定するための別の方法を提供します。

有効にできるすべての GTFS 機能の詳細については、[“GTFS で何ができるのか?”](../機能/overview/) セクションを参照してください。

GTFSGTFS Scheduleデータセットは、車両の位置やサービス更新などのリアルタイム情報で補完できます。そのためには、既存のGTFS Scheduleデータセットとは別にGTFS Realtimeフィードを作成する必要があります。

GTFSGTFS Realtimeフィードは、HTTP 経由で提供され、頻繁に更新される通常のバイナリ ファイルで構成されており、どのタイプのウェブサーバーでもファイルをホストして提供できます。GTFSGTFS Realtimeデータ交換形式は、[プロトコル バッファ](https:) に基づいています。これは、構造化データをシリアル化する言語およびプラットフォームに依存しないメカニズムです。GTFSGTFS Realtimeは、ルート更新、サービス アラート、車両位置の 3 種類の情報を提供できます。これらは、通信する必要があるサービス情報に応じて組み合わせることができますGTFS Realtimeでは車両の実際の状態を表示できるため、フィードは定期的に更新する必要があります。サービスの自動車両位置システムから新しいデータが届くたびに更新するのが理想的です。 GTFS ScheduleデータセットとGTFS Realtimeフィードを組み合わせることで、アプリケーションは正確で最新の情報を乗客に提供できるようになります。詳細については、技術ドキュメントを参照してください。

## 最初の GTFS フィードを作成しますか?

最初の GTFS フィードを作成しようとしている交通機関の場合、まず既存のドキュメントを読む必要があります。

まず、["GTFS で何ができますか?"](../機能/overview) セクションで GTFS の機能を調べ、GTFS 形式を使用して表現する交通サービスのさまざまな機能を決定します。さらに詳しく調べるには、[GTFS Schedule](../../documentation/schedule/reference) と [GTFS Realtime](../../documentation/realtime/reference) の公式リファレンス ドキュメントに、これらの機能をモデル化してコンプライアンスを確保するための詳細なガイダンスが記載されています。

次に、システムから必要なデータをすべて収集します。これには、すべての停留所、ルート、時刻表、運賃などの情報が含まれます。これらの詳細の多くは、GTFS データセットに入力される情報です。

システムの規模と複雑さに応じて、社内でデータを作成するか、外部の GTFS ベンダーに依頼してデータを GTFS 形式に変換するかを選択できます。

場合によっては、ルートが少数の小規模な機関が、スプレッドシートやテキスト エディターなどの一般に入手可能なソフトウェアを使用して自分でデータを作成します。

より大規模なシステム範囲を扱う場合、ほとんどの機関は専門のベンダーから専用の GTFS 管理ソフトウェアを購入しますが、独自の社内ツールを開発することを選択する機関もあります。最後に、システムの特性上、機関が独自にデータセットを作成することが難しいことが判明した場合は、GTFS データの作成を専門とする企業に完全に外注することができます<a href="https://www.flaticon.com/authors/freepik" title="アイコンはFreepikによるものです">。

Icons created by Freepik- Flaticon</a>

[^1]: テキスト ファイルに加えて、デマンド レスポンシブ サービスの特定の要素を表すために、[GeoJSON](https:) 形式も GTFS でサポートされるようになりました。
198 changes: 198 additions & 0 deletions docs/ja/getting_started/example_feed.md
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,198 @@
# GTFS フィードの例

この GTFS フィードの例には、交通フィード内の各ファイルのデータ サンプルがカンマ区切りで表示されています。ここで表示されるサンプル データ ファイルは、すべて相互に関連しているわけではありません。また、作業用に最終形式の完全な GTFS フィードをダウンロード](https://github.com/google/transit/blob/master/gtfs/spec/en/examples/sample-feed-1.zip?raw=true) したり、同じフィードの個々のファイルをオンラインで [こちら](https://github.com/google/transit/tree/master/gtfs/spec/en/examples/sample-feed-1) から参照したりすることもできますagency.txt

```
agency_id、agency_name、agency_url、agency_timezone、agency_phone、agency_lang
FunBus、The Fun Bus、https://www.thefunbus.org、America/Los_Angeles、(310) 555-0222、en
```

```
agency_id、agency_name、agency_url、agency_timezone、agency_lang
agency001、交通事業者、https://www.transitcommuterbus.com/、PST、en
[...]
```

## stops.txt

```
stop_id、level_id、stop_name、stop_lat、stop_lon、location_type、parent_station
F12、、5 Av/53 St、40.760167、-73.975224、1、
E1、L0、5 Av/53 St SW、40.760474、-73.976099、2、F12
E2、L0、5 Av/53 St NE、40.76035、-73.97546、2、F12
E3、L0、5 Av/53 ストリート SE、40.760212、-73.975512、2、F12
E4、L0、マディソン/53 ストリート NE、40.759612、-73.973731、2、F12
E5、L0、マディソン/53 ストリートSE,40.759491,-73.973820,2,F12
N1,L1,,,40.760457,-73.975912,3,F12
N2,L1,,40.760531,-73.976111,3,F12
N3,L1,,40.759746,-73.974 203,3,F12
N4,L1,,40.759679,-73.974064,3,F12
F12S,,5 Av/53 St,40.760167,-73.975224,0,F12
B1,L2,,40.759746,-73.974203,4,F12S
B3,L2,,40.759828,-73.974442,4,F12S
F12N,,5 Av/53 St,40.760167,-73.975224,0,F12
B2,L3,,40.760457,-73.975912,4,F12N
B4,L3,,40.760375,-73.975729,4,F12N
```
`location_type=` 0: プラットフォーム; 1: 駅; 2: 入口/出口; 3: 汎用ノード; 4: 乗車エリア。

## routes.txt

```
route_id、route_short_name、route_long_name、route_desc、route_type
A、17、Mission、`"A"" ルートは、Lower Mission から Downtown まで運行します。`,3
```

## trips.txt

```
route_id、 service_id、 trip_id、trip_headsign、block_id
A、WE、 AWE1、Downtown、1
A、WE、 AWE2、Downtown、2
```

## stop_times.txt

```
trip_id、arrival_time、departure_time、stop_id、 stop_sequence、 pickup_type、 drop_off_type
AWE1、0:06:10、0:06:10、S1、1、0、0
AWE1,,,S2,2,1,3
AWE1,0:06:20,0:06:30,S3,3,0,0
AWE1,,,S5,4,0,0
AWE1,0:06:45,0:06:45,S6,5,0,0
AWD1,0:06:10,0:06:10,S1,1,0,0
AWD1,,,S2,2,0,0
AWD1,0:06:20,0:06:20,S3,3,0,0
AWD1,,,S4,4,0,0
AWD1,,,S5,5,0,0
AWD1,0:06:45,0:06:45,S6,6,0,0
```

## calendar.txt

```
service_id、monday、tuesday、wednesday、thursday、friday、saturday、sunday、start_date、end_date
WE、0、0、0、0、0、1、1、20060701、20060731
WD、1、1、1、1、1、0、0、20060701、20060731
```

## calendar_dates.txt

この例は、2006 年の独立記念日の休日のサービス例外を示しています。2006 年 7 月 3 日月曜日、通常の平日サービス (`service_id=WD`) が中断されます (`exception_type=2`)。代わりに、週末サービス (`service_id=WE`) がそのdateに実行されます (`exception_type=1`)。 7 月 4 日火曜日にも同じ変更が適用されます。

```
service_id、 date、exception_type
WD、20060703、2
WE、20060703、1
WD、20060704、2
WE、20060704、1
```

## fare_attributes.txt

```
fare_id、price、currency_type、payment_method、transfers、transfer_duration
1、0.00、USD、0、0、0
2、0.50、USD、0、0、0
3、1.50、USD、0、0、0
4、2.00、USD、0、0、0
5、2.50、USD、0、0、0
```

## fare_rules.txt

```
fare_id、 route_id、origin_id、destination_id、contains_id
a、TSW、1,1、
a、TSE、1,1、
a、GRT、1,1、
a、GRJ、1,1、
a、SVJ、1,1、
a、JSV、1,1、
a、GRT、2,4、
a、GRJ、4,2、
b、GRT、3,3、
c、GRT、、、6
```

## shapes.txt

```
shape_id、shape_pt_lat、shape_pt_lon、shape_pt_sequence、shape_dist_traveled
A_shp、37.61956、-122.48161、1、0
A_shp、37.64430、-122.41070、2、6.8310
A_shp、37.65863、-122.30839、3、15.8765
```

## frequencies.txt

```
trip_id、start_time、end_time、headway_secs
AWE1:30:00、06:30:00、300
AWE1:30:00、20:30:00、180
AWE1,20:30:00,28:00:00,420
```

## transfers.txt

```
from_stop_id,to_stop_id,transfer_type,min_transfer_time
S6,S7,2,300
S7,S6,3,
S23,S7,1,
```

## pathways.txt

```
pathway_id、from_stop_id、to_stop_id、pathway_mode、is_bidirectional
E1N1、E1、N1、2、1
E2N1、E2、N1、2、1
E3N1、E3、N1、2、1
N1-N2、N1、N2、6、1
N2-N1、N2、N1、7、1
N2N3、N2、N3、2、1
N2-B1、N2、B1、4、0
B1-N2、B 1,N2,4,0
B1B2,B1,B2,2,1
B1B3,B1,B3,1,1
B2B4,B2,B4,1,1
E4N3,E4,N3,2,1
E5N3,E5,N3,2,1
N3-N4,N3,N4,6,1
N4-N3,N4,N3,7,1
N4B 3,N4,B3,2,1
N4-B3,N4,B3,4,0
B3-N4,B3,N4,4,0
B3B4,B3,B4,2,1
```

## levels.txt

```
level_id、level_index、level_name、elevation
L0、0、Street、0
L1、-1、Mezzanine、-6
L2、-2、Southbound、-18
L3、-3、Northbound、-24
```

## translations.txt

```
table_name、field_name、language、translation、record_id
stops、stop_name、en、Tokyo Station、stopid000001
stops、stop_name、fr、Gare de Tokyo、stopid000001
stops、stop_name、zh、東京站、stopid000001
```

## attributions.txt

```
attribution_id、is_producer、is_operator、organization_name、agency_id
attribution001、1、0、Transit Feed Solutions米国、agency001
attribution002、0、1、Transit Bus Operations USA、agency001
[...]
```
84 changes: 84 additions & 0 deletions docs/ja/getting_started/features/accessibility.md
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
# :material-wheelchair:アクセシビリティ
アクセシビリティ機能は、障害を持つ人々がサービスにアクセスするために必要な情報を提供することを目的としています。

##停留所等の車椅子アクセシビリティ

停留所等の車椅子アクセシビリティを使用すると、指定された場所から車椅子で乗車できるかどうかを示すことができます。車椅子を使用する乗客にサービスを提供するには、車椅子で乗車できることを指定することは、不可能であることを指定することと同じくらい重要です。

| 含まれるファイル | 含まれるフィールド |
|----------------------------------|-----------------------------------|
|[stops.txt](../../../documentation/schedule/reference/#stopstxt)| `wheelchair_boarding` |

**前提条件**:

- [ベース機能](../base)
- [停留所等の種別](../base_add-ons/#location-types) 出入口や乗車エリアなどの駅の場所のアクセシビリティ情報を定義する場合。

??? `サンプルデータ`

<p style="font-size:16px">
次のサンプルは、`wheelchair_boarding=1` を使用して停留所 `TAS001` で車椅子での乗車が可能であることを示しています。
</p>
!!! 注記 ""
<p style="font-size:16px">
<a href="../../../documentation/schedule/reference/#stopstxt"><b>stops.txt</b></a><br>
</p>

| stop_id | stop_name | stop_lat | stop_lon | location_type | wheels_boarding |
|---------|------------|------------|------------|---------------|----------------------|
| TAS001 | 5 Av/53 St | 40.760167 |-73.975224 | | 1 |


##便車椅子でのアクセシビリティ

トリップ 車椅子での便では、車両が車椅子を使用する乗客に対応できるかどうかを示すことができます。車椅子を使用する乗客のサービスを提供するためには、車両が車椅子を使用する乗客に対応できることを指定することは、車両が対応できないことを指定するのと同じくらい重要です。乗客が特定の停留所で旅行にアクセスできるようにするには、停留所と旅行の両方が車椅子でアクセス可能である必要があります。

| 含まれるファイル | 含まれるフィールド |
|----------------------------------|-----------------------------------|
|[trips.txt](../../../documentation/schedule/reference/#tripstxt)| `wheelchair_accessible`|

**前提条件**:

- [ベース機能](../base)

??? 注`ル` データ`

<p style="font-size:16px">
次のサンプルは、旅行 `AWE1` で使用される車両には少なくとも 1 台の車椅子を収容できる装備があり、旅行 `AWE2` で使用される車両にはそれがないことを示しています。
</p>
!!! 注記 ""
<p style="font-size:16px">
<a href="../../../documentation/schedule/reference/#tripstxt"><b>trips.txt</b></a><br>
</p>

| route_id | service_id | trip_id | wheels_accessible |
|----------|-----------|----------|------------------------|
| RA | WE | AWE1 | 1 |
| RA | WE | AWE2 | 2 |


##テキスト読み上げ

テキスト読み上げにより、テキストを音声に変換するために必要な入力を提供できます。これにより、支援技術を使用してテキストを読み上げる乗客が、交通サービスを利用するときに正しい停留所名を取得できるようになります。

| 含まれるファイル |含まれるフィールド |
|----------------------------------|-------------------|
|[stops.txt](../../../documentation/schedule/reference/#stopstxt)| `tts_stop_name` |

**前提条件**:

- [ベース機能](../base)

???`サンプルデータ`の注記

<p style="font-size:16px">
次のサンプルは、停留所名の読み取り可能なバージョンを提供し、テキスト読み上げツールで名前を読み上げることができます。
</p>
!!! 注記 ""
<p style="font-size:16px">
<a href="../../../documentation/schedule/reference/#stopstxt"><b>stops.txt</b></a><br>
</p>

| stop_id | stop_name | stop_lat | stop_lon | tts_stop_name |
|---------|-------------|-------------|-------------|---------------------------|
| TAS001 | 5 Av/53 St | 45.5035680 |-73.587079 | 5番街と53番街 |
Loading

0 comments on commit 0691ee0

Please sign in to comment.