Import/Catalogue/GBFS Docomo Bike Share Import

From OpenStreetMap Wiki
Jump to navigation Jump to search

Sentences are written in English/Japanese.

GBFS Docomo Bike Share Import is an import of GBFS (General Bikeshare Feed Specification) data of the share cycle service distributed by DOCOMO BIKESHARE, INC. in Japan. The import started on 2023-12-20 and finished first import on 2023-12-21.

GBFS Docomo Bike Share Importは株式会社ドコモ・バイクシェアがGBFS(General Bikeshare Feed Specification)形式で提供するシェアサイクルの情報をインポートするプロジェクトであり、2023-12-20にインポートに着手し、初回のインポートを2023-12-21に完了しました。

Goals/目標

This project will import the share cycle ports of 'Docomo Bikeshare' brand. There are about 200 nodes/areas in Japan at 2023-11-21 on OSM.

日本全国にあるドコモ・バイクシェアのシェアサイクルのポートの情報をインポートします。2023-11-20時点でドコモ・バイクシェアがタグ付けされたノード/エリアは約200箇所程度あります。

Schedule/スケジュール

  • documentation (this wiki): done (2023-11-21)
  • announce to Talk-ja ML / Talk-ja MLへのアナウンス: done (2023-11-21)
  • prepare for OSM file to upload. / アップロード用OSMファイルの準備: 2023-11-21
  • announce to Import ML and Community Forum / Import ML、Community Forumへのアナウンス: done (2023-12-05)
  • perform import/インポートの実行: done the first import (2023-12-21)

Import Data/インポートデータ

Background/概要

Data source site: https://ckan.odpt.org/dataset/c_bikeshare_gbfs-d-nationwide-bikeshare (in Japanese)
Data license: Discribed in the same page as above
Type of license: CC BY 4.0
OSMFJ member (user:nyampire) contacted the Association for Open Data of Public Transportation and obtained permission from them to use the data under the ODbL license on OSM on 2023-11-20. Below is the content of the email (in Japanese):

OSMFJ member (user:nyampire) が公共交通オープンデータ協議会事務局に連絡を取り、2023-11-20に同事務局からOSMでの使用許諾を得ました。以下、メールの内容： 

ドコモバイクシェア様との調整の結果、OpenStreetMapさまに、
ODbLでのデータの提供について許諾をいただくことができました。

またこの交渉過程で、ドコモバイクシェアのデータ提供エリアが
東京以外にも拡大できることになりました。

このためご利用いただく際は、新たに全国版として公開する
ことになった以下のURLにあるデータをご利用いただけませんでしょうか。
https://ckan.odpt.org/organization/d-bikeshare

ODbL Compliance verified: yes

The source is 4 json files. The cycle ports to be imported are 3,035 on 2023-11-21.

OSM Data Files/OSMファイル

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

Import Type/インポートタイプ

This import is conducted periodically. Check the GBFS data at least twice a year and update it if there are any changes. JOSM will be used as the editor for each step of this import process, including checking, merging, validation, and any necessary reverting of changesets.

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

Data Preparation/データ作成手順

Data Reduction & Simplification/データ簡易化

Extract the port name and capacity from the station_information.json file. The tagging plan is as follows.

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

Tagging Plans/タグ付け

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

If the nodes exist, the coordinates of existing data and GBFS data that seem to be more accurate will be adopted. / もしノードが存在している場合は、既存データとGBFSデータの座標で確度が高そうな方を採用します。

Docomo Bike Share is essentially limited to use within the same area and cannot be used across areas. Although GBFS does not provide area information, existing data on OSM such as name/brand/network/operator may contain information about the area. In such cases, put it in network:*=*." /

ドコモ・バイクシェアは基本的に同一エリア内のみの利用に限られており、エリアをまたがる利用はできません。GBFSにエリア情報はありませんが、既存データのname/brand/network/operatorなどにエリアに関する情報が存在することがあります。その場合は、network:*=*に入れます。

GBFS file GBFS field OSM Tag (fixed value) OSM value (example) description/説明
amenity=bicycle_rental
system_information.json name brand=Docomo Bike Share Match value to Wikidata / Wikidataに値を合わせる
brand:ja=ドコモ・バイクシェア Match value to Wikidata / Wikidataに値を合わせる
brand:wikidata=Q55533296
network:*=* Date Bike Area name from OSM data if exists./ OSMのname/brand/operator/networkにエリアに相当する名称がある場合はこちらに格納する
system_information.json url brand:website=https://docomo-cycle.jp/
website=* https://docomo-cycle.jp/sendai/ Remain the URL for the area if that exists on the OSM. / エリアのURLがOSMにある場合はその値を保持する
system_information.json system_id gbfs:system_id=docomo-cycle
station_information.json station_id gbfs:station_id=* 1 Convert to integer value without zero padding. / ゼロパディングしない整数値に変換する
station_information.json name gbfs:name=* 04.ドコモ東北ビル Use the name value in GBFS as is. / GBFSの名称そのままとする
station_information.json name ref=* 4 Use 'ref' value in GBFS's name if exists. When a value is only numeric, use it without zero padding. / GBFSの名称に'ref'がある場合にその値を入れる。数値のみの場合はゼロパディングしない。
station_information.json name name=* ドコモ東北ビル Use the original name from the GBFS name value / GBFSの名称から'ref'を除いた名称を入れる
station_information.json name description=* 他ポートへの返却不可 Use when there is a parenthetical note before 'ref' / 'ref'の前に【】でつけられた注記を入れる。他に【休止】がある。
station_information.json capacity capacity=* 18 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 a Python script runs on Google Colaboratory. /
station_information.jsonのファイルをGoogle Colaboratory上で動作するpythonプログラムでcsv形式に変換します。

JSON to CSV conversion script: / jsonからcsvの変換スクリプト: https://github.com/okadatsuneo/GBFS_Import/blob/main/gbfstocsv_docomo.ipynb

To import the reference file, use JOSM with the OpenData plugin, and conflate the data using the 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 a CSV file using a Python script. / pythonスクリプトでcsvファイルに変換する。
  • Open the CSV file in JOSM with the OpenData plugin. / csvファイルをJOSMのOpenDataプラグインで開く。
  • Download the existing data from the Overpass API with JOSM. The overpass query is shown below. / OSMで以前にインポートしたHelloCycling以外のamenity=bicycle_rentalのノード/ウェイ/リレーションをダウンロードします。overpassクエリを以下に示します。
[out:json][timeout:500];
{{geocodeArea:日本}}->.searchArea;
(
  nwr[amenity="bicycle_rental"]["brand"!="HELLO CYCLING"](area.searchArea);
);
out body;
>;
out skel qt;
  • Merge them with the reference data using the Conflation plugin. / ConflationのプラグインでJOSM上でマージする。
    • If some existing data are a way(area) or relation, use the existing way or relation. / もし既存データがウェイ(エリア)やリレーションの場合にはそのまま利用します。
    • If no data exists, add new nodes. / (既存ノードがなければすべて新規追加)
  • Create a merged OSM file and upload it from JOSM. / アップロード用ファイルを作成し、JOSMでアップロードします。


Update/更新

For the second and subsequent imports, after creating a CSV file, check the differences between the current CSV file and the one from the previous import. Update if there are any changes. /
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 uses the following copyrighted material with modifications. / このインポートデータは、以下の著作物を改変して利用しています。

DOCOMO BIKESHARE, INC. / Association for Open Data of Public Transportation, Bikeshare information of DOCOMO BIKESHARE, INC., Creative Commons License Attribution 4.0 International (https://creativecommons.org/licenses/by/4.0/deed.en)

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

See also/関連項目

The email to the Imports mailing list was sent on 2023-12-05 and can be found in the archives of the mailing list at [1]. The announcement also posted to OSM Community Forum[2]. /

Import-MLへは2023-12-05に送信済みです[3]。フォーラムにも投稿済みです[4]。

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