Import/Catalogue/GBFS HelloCycling Import

From OpenStreetMap Wiki
Jump to navigation Jump to search

Sentences are written in English/Japanese.

GBFS HelloCycling Import is an import of GBFS (General Bikeshare Feed Specification) data of the share cycle service distributed by OpenStreet Corp. in Japan. The import started on 2023-06-28 and finished first import on 2023-07-12.

GBFS HelloCycling ImportはOpenStreet社がGBFS(General Bikeshare Feed Specification)形式で提供するシェアサイクルの情報をインポートするプロジェクトであり、2023-06-28にインポートに着手し、初回のインポートを2023-07-12に完了しました。

Goals/目標

This project will import share cycle ports of 'Hello Cycling'. There are 196 nodes and 3 areas in Japan at 2023-05-24 on OSM.

日本全国にあるHelloCyclingのシェアサイクルのポートの情報をインポートします。2023-05-24時点でHelloCyclingがタグ付けされたノードは196ヶ所、エリアは3ヶ所あります。

Schedule/スケジュール

  • documentation (this wiki): done (2023-05-24)
  • announce to OSM Japan Slack channel/OSM Japan Slackへのアナウンス: done (2023-05-24)
  • announce to Talk-ja ML/Talk-ja MLへのアナウンス: done (2023-05-30)
  • prepare for OSM file to upload./アップロード用OSMファイルの準備: 2023-05-25
  • announce to Import ML/Import MLへのアナウンス: 2023-06-14
  • perform import/インポートの実行: after 2023-06-28

Import Data/インポートデータ

Background/概要

Data source site: https://ckan.odpt.org/dataset/c_bikeshare_gbfs-openstreet (in Japanese)
Data license: Discribed in the same page as above
Type of license: CC BY 4.0 or ODC BY 1.0 or ODbL 1.0 ((Multi-licensed)
ODbL Compliance verified: yes

The source is 4 json files. The cycle ports to be imported are about 6,500.

OSM Data Files/OSMファイル

The OSM file to import/インポート用のファイルを作成しリンクしています: https://github.com/okadatsuneo/GBFS_Import/blob/main/h_stations.osm

Import Type/インポートタイプ

This is a recurring import. Check the GBFS data at least twice a year and update it if there are any changes. JOSM is the editor being used for this import. Josm will be used for checking, validation, uploading, and reverting of changesets if needed.

このインポートは繰り返し行います。少なくとも1年に2回データをチェックし、内容に変更があれば更新します。 このインポートの各手順(チェック、合成、検証など)にはJOSMを使用します。

Data Preparation/データ作成手順

Data Reduction & Simplification/データ簡易化

Just import the port name and capacity from station_information.json. Tagging plan is as below.

station_information.jsonのファイルからポート名と最大キャパシティを抽出します。タグ付けは下記の通りです。

Tagging Plans/タグ付け

Share Cycle Port/シェアサイクルポート

GBFS file GBFS field OSM Tag (fixed value) OSM value (example) descriotion/説明
amenity=bicycle_rental
system_information.json short_name brand=HELLO CYCLING Match existing data on OSM/既存データに合わせる
brand:ja=ハローサイクリング
brand:wikidata=Q91231927
system_information.json short_name network=HELLO CYCLING Match existing data on OSM/既存データに合わせる
network:ja=ハローサイクリング
network:wikidata=Q91231927
system_information.json url contact:website=https://www.hellocycling.jp
system_information.json system_id ref:gbfs=* hellocycling:17 <system_id>:<station_id>
2023-12-21以降、"ref:gbfs"を"gbfs:system_id"と"gbfs:station_id"に変更する。
station_information.json station_id
system_information.json system_id gbfs:system_id=hellocycling
station_information.json station_id gbfs:station_id=* 17
station_information.json name name=* 新御徒町ステーション port name/ポート名
station_information.json address addr:province=* 東京都 Prefecture/都道府県名
station_information.json vehicle_type_capacity: num_bikes_limit capacity=* 8 capacity/総駐車可能台数
authentication:app=yes アプリでの認証
fee=yes 有料

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

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

Data Transformation/変換ツール

The original data is distributed in json format. The station_information.json file is converted to csv format using the python script run on Google Colaboratory. /
station_information.jsonのファイルをGoogle Colaboratory上で動作するpythonプログラムでcsv形式に変換します。

Json to csv convert script / jsonからcsvの変換スクリプト: https://github.com/okadatsuneo/GBFS_Import/blob/main/gbfstocsv_hc.ipynb

Use JOSM with OpenData plugin to import reference file, and conflate the data with Conflation plugin. /
JOSMのOpenDataプラグインを使用して変換したcsvファイルをJOSMに取り込み、Conflationプラグインを使用して既存データと合成します。


Data Merge Workflow/データ作成手順

Team Approach/作業者

Solo project of User:tokada. Import account:okadatsuneo_import

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

Workflow/手順

  • Download the 'station_information.json' file from the data source. / jsonファイルをダウンロードする。
  • Convert the json file to the csv file with python script. / pythonスクリプトでcsvファイルに変換する。
  • Open the csv file in the JOSM with OpenData plugin. / csvファイルをJOSMのOpenDataプラグインで開く。
  • Download the existing data from the Overpass API with JOSM. The example of overpass query is shown below. / OSMでHelloCyclingでタグ付けされたノード/ウェイ/リレーションをダウンロードします。overpassクエリの例(東京都の場合)を以下に示します。
[out:json][timeout:500];
{{geocodeArea:東京都}}->.searchArea;
(
  nwr[~"^name"~"Hello Cycling",i](area.searchArea);
  nwr[~"^name"~"ハローサイクリング"](area.searchArea);
  nwr[~"^brand"~"Hello Cycling",i](area.searchArea);
  nwr[~"^brand"~"ハローサイクリング"](area.searchArea);
  nwr[~"^network"~"Hello Cycling",i](area.searchArea);
  nwr[~"^network"~"ハローサイクリング"](area.searchArea);
  nwr[amenity="bicycle_rental"](area.searchArea);
);
out body;
>;
out skel qt;
  • Merge them with the reference data using the conflation plugin. / ConflationのプラグインでJOSM上でマージする。
    • If some existing data are way(area) or relation, use the existing way or relation. / もし既存データがウェイ(エリア)やリレーションの場合にはウェイをそのまま利用します。
    • If the existing node's coordinates are different from the reference, look at the aerial imagery and apply the coordinates that seem to be more accurate. / もし既存のノードの座標がレファレンスと異なる場合は、航空写真を見て確度が高そうな方の座標を採用します。
  • Finally, use the TODO list plugin to check all the data for problems. / 最後にTODO listプラグインを使用して、すべてのデータに問題がないかを確認します。
  • Upload it from JOSM. / JOSMでデータをアップロードします。

Repeat the above flow for each prefecture. / 都道府県ごとにわけて上記の手順を繰り返します。

Update/更新

In the second and subsequent imports, after creating a csv file, check the difference between the csv file and the previous import, and update if there is any change. /
2回目以降のインポートではcsvファイルを作成後、前回インポート時のcsvファイルとの差分(diff)を確認し、変化があれば更新します。

Revert plan/リバート方針

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

QA/品質保証

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

Copyright/著作権表示

This import data is modified from the following copyrighted work. / このインポートデータは、以下の著作物を改変して利用しています。

OpenStreet Corp. / Association for Open Data of Public Transportation, Bikeshare information of OpenStreet, CC BY 4.0, ODC BY 1.0, ODbL 1.0

OpenStreet株式会社 / 公共交通オープンデータ協議会、OpenStreet（ハローサイクリング） バイクシェア関連情報、クリエイティブ・コモンズ・ライセンス　表示4.0国際（https://creativecommons.org/licenses/by/4.0/deed.ja）, ODC BY 1.0, ODbL 1.0

See also/関連項目

The email to the Imports mailing list was sent on 2023-06-14 and can be found in the archives of the mailing list at [1]. /

Import-MLへは2023-06-14に送信済みです[2]。

Retrieved from "https://wiki.openstreetmap.org/w/index.php?title=Import/Catalogue/GBFS_HelloCycling_Import&oldid=2633175"