Import/Catalogue/HiroshimaWestAreaBusImport

From OpenStreetMap Wiki
Jump to navigation Jump to search

Sentences are written in English/Japanese.

Hiroshima West Area Bus Import is an import of GTFS data of the bus services in the west and north area of Hiroshima Prefecture, Japan. The import was planned on 2021-12-10 and completed on 2022-01-14.

Hiroshima West Area Bus Importは広島県西部・北部を中心としたバス事業者のGTFSデータをインポートするプロジェクトであり、2021-12-10に計画し、2022-01-14に完了しました。

Goals/目標

This project will import bus stops around the above area. The nodes to be imported are 10,183. There are already 1,868 bus stop nodes within Hiroshima Prefecture at 2021-12-10 on OSM.

このプロジェクトはバス停のインポートとし、インポートするバス停の総数は10,183あります。広島県内で2021-12-10現在OSMに登録されているバス停は1,868です。

Schedule/スケジュール

  • documentation (this wiki): done (2021-12-12)
  • announce to Talk-ja ML and OSM-Japan Slack channel/Talk-ja ML・Slackへのアナウンス: done (2021-12-12)
  • prepare for OSM file to upload./アップロード用OSMファイルの準備: done (2021-12-12)
  • announce to Import ML/Import MLへのアナウンス: done (2021-12-27)
  • perform import/インポートの実行: done (2022-01-14)

Import Data/インポートデータ

Background/概要

Data source site / データソースサイト: https://www.bus-kyo.or.jp/gtfs-open-data (in Japanese)
Data license / ライセンス条件: Discribed in the same page as above
Type of license / ライセンスタイプ: CC0 (Public Domain)
ODbL Compliance verified / ODbLの対応チェック: yes

The sources are 12 zipped gtfs files for each operator. / ソースファイルは事業者ごとの12個のGTFSファイルがあります。

OSM Data Files/OSMファイル

Sample OSM file to be imported/インポート用のファイルを作成しリンクしています: https://github.com/okadatsuneo/HiroshimaWestAreaBusImport/blob/main/1HirodenBus.osm

Other OSM files are also on the github server/他のファイルも下記にあります: https://github.com/okadatsuneo/HiroshimaWestAreaBusImport

Import Type/インポートタイプ

This is a one-time import but will be reviewed periodically to keep the information up-to-date. JOSM is the editor being used for this import. Josm will be used for checking, validation, uploading, and reverting of changesets if needed.

今回のインポートは1回限りですが、定期的にサイトをチェックし、GTFSファイルが更新されればOSMを更新する可能性があります。 このインポートの各手順(チェック、合成、検証など)にはJOSMを使用します。

Data Preparation/データ作成手順

Data Reduction & Simplification/データ簡易化

Just import bus stops from stops.txt and translation.txt of GTFS data. Tagging plan is as below.

stops.txtとtranslations.txtのファイルからバス停の情報を生成しインポートします。タグ付けは下記の通りです。

Tagging Plans/タグ付け

Bus stops/バス停

The tags will be added or merged as below. / タグ付けは下記のように行います。

Table 1:Bus stop tags/表1:バス停のタグ
GTFS file GTFS field OSM Tag OSM value (example)
bus=yes
highway=bus_stop
public_transport=platform
operator=* Table 2 / 表2の値
operator:en=* Table 2 / 表2の値
stops.txt stop_id gtfs:stop_id=* 50060 4
stops.txt platform_code local_ref=* 4
stops.txt stop_name name=*

name:ja=*

広島駅
translations.txt lang/ja-Hrkt name:ja-Hira=* ひろしまえき
translations.txt

(if available) /
(値が存在する場合)

lang/en name:en=* Hiroshima Station
lang/ko name:ko=* 히로시마 역
lang/zh-ch(zh_cn) name:zh-Hans=* 广岛站
lang/zh-tw(zh_tw) name:zh-Hant=* 廣島站
Table 2:Operator Name and Release date/
表2:事業者名とデータリリース日
No. operator=* [1] operator:en=* gtfs:release_date=* [1] #changeset
1 広電バス[2] Hiroden Bus 2021-03-25 116130558(north), 116147888(middle), 116131551(south)
2 広島バス Hiroshima Bus 2021-07-16 116087957
3 広島交通 Hiroko 2021-04-27 116105461
4 芸陽バス Geiyo Bus 2021-07-16 116068116
5 備北交通 Bihoku 2021-05-06 116055668
6 中国ジェイアールバス Chugoku JR Bus 2021-04-27 116054198
7 エイチ・ディー西広島 HD Nishi-Hiroshima 2021-04-21 116049245
8 フォーブル Forble 2021-03-25 116049669
9 ささき観光[3] Sasaki Kanko 2021-05-06 116046879
10 呉市 Kure City 2021-03-25 116049923
11 廿日市市[4] Hatsukaichi City 2021-03-25 116046531
12 江田島バス Etajima Bus 2021 (no date info.) 116045832

Note:

  • [1] The operator is based on the agency_id data within the agency.txt. The release_date is based on the feed_version data within the feed_info.txt. /
    事業者名はagencytxtのagency_idから、リリース日はfeed_info.txtのfeed_versionの値としています。
  • [2]事業者名としては「広島電鉄」ですが、地元で「広電バス」の呼び方で定着している、OSMに既登録のoperator名称のほとんどが「広電バス」になっていることから、「広電バス」にしようと思います。
  • [3]既登録のoperator名は「おおのハートバス」となっていますが、GTFSのagency名称は「ささき観光」ですのでそのように変更し、networkに「おおのハートバス」を入れます。
  • [4]既登録のoperator名は「さくらバス」となっていますが、GTFSのagency名称は「広電バス」または「廿日市市」ですのでそのように変更し、networkに正式名称である「廿日市さくらバス」として入れます。

The policy for importing nodes is as follows. / ノードの処理は下記のように行います。

  • There are both data for each pole and representative points. To avoid duplication, only the data for the pole will be imported. (The data with the attribute location_type = 0 indicates the data for the pole.) /
    データは標柱ごとと代表点の両方存在しており、重複しないように標柱のデータのみ登録します。(location_type=0 の属性を持つデータが標柱のバス停を示しています。)
  • There are bus stops in prefectures around Hiroshima (Yamaguchi, Shimane, Tottori), all will be imported. /
    広島県周辺の県(山口県、島根県、鳥取県)のバス停もありますが、すべて登録します。
  • If the nodes already exist, use these coordinates normally. The bus stops on OSM may have been added by the survey basically. /
    もしノードが存在している場合は、基本的には座標はOSMに既登録のものを使用します。バス停は多くの場合調査により追加されていると思いますので。
  • There may be nodes that are the same or close to each other for each operator, but they will not be merged in this import. /
    事業者ごとに同一点または近接したノードが存在する場合がありますが、それらは今回のインポートでは統合しません。
  • If the English name has an abbreviation, change it to the full spelling. /
    英字名に短縮形が含まれる場合は、短縮しない形にします。

Changeset Tags/チェンジセットのタグ

The following tags are added to the changeset. / 変更セットのタグに以下のタグを付与します。

The Operator Name (ja) and release_date are set as Table 2. / コメントの Operator Name と release_date は表2の値とします。

Data Transformation/変換ツール

Use JOSM with OpenData plugin to import reference file, and conflate the data with Conflation plugin.

JOSMのOpenDataプラグインを使用してインポート用データをJOSMに取り込み、Conflationプラグインを使用して既存データに合成するためのデータを作成します。

Memo on import/インポート時の作業メモ

  • There were some bus stops that differed only in stop_id with the same operator, the same bus stop, and the same coordinates. For these, there is only one node, and all gtfs: stop_ids are written with semicolon(;). /
    同一事業者・同一バス停・同一座標でstop_idのみ異なるものがありました。これらについてはノードは1つのみとし、gtfs:stop_idをセミコロン(;)で併記しました。
  • Some of the registered bus stops with multiple operators listed together may have been integrated at the time of import. (If the stop_id is different for each operator, list them in the same order as the operator. If the different operators have the same stop_id, list only one.) /
    既登録のバス停でoperatorが複数併記になっているものは、インポート時に統合したものもあります。(事業者ごとにstop_idが異なる場合はoperatorと同じ順に併記する。異なる事業者でstop_idが同じ場合には1つのみ記載する。)
  • If the registered bus stop name is 1-byte alphanumeric characters and the GTFS bus stop name is 2-byte alphanumeric characters, the registered 1-byte alphanumeric characters are kept. /
    既登録のバス停名が半角英数字でGTFSのバス停名が全角英数字の場合、既登録の半角英数字を残しています。
  • Added the changeset of import to Table 2. / 登録時のチェンジセットを表2に追記しました。

Data Merge Workflow/データ作成手順

Team Approach/作業者

Solo project of User:tokada. Import account:okadatsuneo_import

User:tokadaが実施します。インポート用アカウントokadatsuneo_importを使用します。

Workflow/手順

  • Download the zipped GTFS file from the data source. / GTFSファイルをダウンロードします。
  • Create a table in MS Excel that will be tagged as above from the stops.txt and translations.txt files. / エクセルで上記のタグ付けとなる表を作成します。
  • Import .csv file to JOSM with OpenData plugin. / csvファイルをJOSMのOpenDataプラグインでインポートします。
  • Download the existing data from the OSM server with JOSM, and merge them with the reference data using the conflation plugin. If no data exists, simply add new nodes. / OSMの該当エリアのバス停ノードをダウンロードし、ConflationのプラグインでJOSM上でマージします。既存ノードがなければ新規追加します。
  • Make merged OSM file and upload it from JOSM. / アップロード用ファイルを作成し、JOSMでアップロードします。
  • Repeat the above steps for each operator. / 事業者ごとに上記の手順を繰り返します。

Revert plan: user:tokada will revert if any problems happen. / 問題が発生した場合はuser:tokadaが対応します。

QA/品質保証

Check the result after uploading by using overpass-turbo. アップロード結果に問題ないかを確認します。

Bus routes/バス路線

After importing bus stops, added this section to make bus route relations. / バス停のインポート後に、バス路線をOSMに登録するためにこの章を追加しました。

I will create and upload that manually from the GTFS file. / GTFSファイルのデータから、バス路線のリレーションに必要な情報を抜き出して、手動でOSMに登録します。

Schedule/スケジュール

  • announce to Talk-ja/import ML / Talk-ja/import MLへのアナウンス: ~2022-02-04
  • perform import / インポートの実行: ~2022-02-11

Tagging Plans/タグ付け

Make each bus route relation and add the bus stop nodes and routes. If the relation already exists in OSM, update it. / バス路線を作成し、バス停と運行経路の道路を追加します。もしリレーションが存在する場合はそれを更新します。

To add the routes, change the file extension of the shapefile ( shapes.txt ) to 'csv' and open it in JOSM. Add the ways that the shapefile nodes are located, to the relation. / リレーションのウェイを登録するために、shapes.txtの拡張子を'csv'に変換してJOSMで開きます。シェイプファイルのノードが乗っているウェイを選択して、リレーションに追加します。

The tags of the relation will be added or merged as below. / 下記のようにタグ付けします。

Table 3:Bus route tags/表3:バスルートのタグ
GTFS file GTFS field OSM Tag OSM value (example)
routes.txt route_id gtfs:route_id=* 3178734657
routes.txt
(if available/値がある場合)
route_long_name official_name=* 高速:三次・庄原線
route_short_name ref=* 321

Use the value of 'shape_id' as gtfs:shape_id=* , if it is need to distinguish routes with same 'route_id' and 'name'. / 'route_id' と 'name' が同じルートを区別する必要がある場合は、'shape_id' の値を gtfs:shape_id=* で使用します。

Use the other tags defined in the Buses wiki page based on the PTv2 schema. Other data preparation and workflow are the same as the above section. /

その他、JA:バスで定義されているタグを使用します。これ以外の手順などは上記と同じです。


Here is the OSM data sample. (It contains the bus stop nodes only. I will also add the ways when uploading.) / 作成するリレーションのサンプルデータを下記に置いています。(サンプルにはバス停のノードのみが入っていますが、実際には運行経路をwayとして追加します。):

https://github.com/okadatsuneo/HiroshimaWestAreaBusImport/blob/main/HiroshimaBusRoute_sample.osm

Table 4:Working results/表4:インポート作業状況
No. operator=* [1] operator:en=* gtfs:release_date=* OSM import status
1 広電バス Hiroden Bus 2022-04-05 done(一部、共同運行路線はリレーション統合検討のため保留)
2 広島バス Hiroshima Bus 2022-04-04 done
3 広島交通 Hiroko 2022-04-04 done
4 芸陽バス Geiyo Bus 2022-07-06 done
5 備北交通 Bihoku 2022-04-05 done
6 中国ジェイアールバス Chugoku JR Bus 2022-07-06 done(一部、共同運行路線はリレーション統合検討のため保留)
7 エイチ・ディー西広島 HD Nishi-Hiroshima 2021-04-21 done
8 フォーブル Forble 2021-03-25 done
9 ささき観光 Sasaki Kanko 2021-05-06 done
10 呉市 Kure City 2021-03-25 done
11 廿日市市 Hatsukaichi City 2021-03-25 done
12 江田島バス Etajima Bus 2021 (no date info.) done

Update/更新

This section shows the updated information based on the GTFS file update. /

GTFSファイルが更新された時のOSMの変更情報をここに記載します。

作業方法

  • バス停:変更前後のgtfsファイルのstops.txtの差分(diff)を確認し、変更箇所を反映します。
Table 5:Update info./表5:更新内容
No. operator=* [1] operator:en=* gtfs:release_date=* OSM updated date
1 広電バス Hiroden Bus 2022-04-05 追加・変更のみdone, 削除はルート追加後対応予定
2 広島バス Hiroshima Bus 2022-04-04 done
3 広島交通 Hiroko 2022-04-04 done
4 芸陽バス Geiyo Bus 2022-07-06 done
5 備北交通 Bihoku 2022-04-05 done
6 中国ジェイアールバス Chugoku JR Bus 2022-07-06 追加・変更のみdone, 削除はルート追加後対応予定
7 エイチ・ディー西広島 HD Nishi-Hiroshima
8 フォーブル Forble
9 ささき観光 Sasaki Kanko
10 呉市 Kure City
11 廿日市市 Hatsukaichi City
12 江田島バス Etajima Bus

See also/関連項目

The email to the Imports mailing list was sent on 2021-12-27 and can be found in the archives of the mailing list at [1].

Import-MLへは2021-12-27に送信済みです[2]

The email about the additional import to the Imports mailing list can be found in the archives of the mailing list at [3]. /

追加のバスルートのインポートについてのImport-MLへのメールはこちらから参照できます[4]