いちごロケLITE の設定方法

コミュニティバスや送迎バス向けのバスロケシステムを利用するための設定手順をまとめています。 GTFSデータの準備から管理画面の設定、バスロケ画面やGTFSリアルタイム配信の仕様まで確認できます。

準備

GTFS(General Transit Feed Specification)形式の静的運行データを用意し、外部から取得可能な場所に設置してください。ODPTや自社サーバーなどの利用を想定しています。

送迎バスなどの単純な運行であれば、管理画面の「単純なGTFSデータを作成する」から進められます。この場合は、次の「管理画面設定」に進んでください。

まずは、trips.txtroutes.txtstops.txtstop_times.txtcalendar.txtcalendar_dates.txt を用意してください。これらのファイルを 1つのZIPファイル にまとめて公開してください。

必須項目の詳細を見る

必須ファイル

trips.txt

  • trip_id
  • route_id
  • service_id
  • trip_headsign(※)画面表示

routes.txt

  • route_id
  • route_short_name または route_long_name画面表示

stops.txt

  • stop_id
  • stop_name画面表示
  • stop_lat
  • stop_lon

stop_times.txt

  • trip_id
  • arrival_time
  • departure_time
  • stop_id
  • stop_sequence
  • stop_headsign(※)画面表示

calendar.txt

  • service_id
  • monday ~ sunday
  • start_date
  • end_date

calendar_dates.txt

  • service_id
  • date
  • exception_type

任意ファイル

shapes.txt 画面表示

  • shape_id
  • shape_pt_lat
  • shape_pt_lon
  • shape_pt_sequence
画面表示 バスロケ画面に表示される項目です

(※) headsignについて

trip_headsign または stop_headsign のどちらかが必要です。両方存在する場合は stop_headsign が優先表示されます。 バスロケ画面では表示名の後ろに「行き」が付くため、headsign には しらたま台 のように終点名・方面名だけを入れてください。

管理画面設定

準備ができたら、管理画面で以下の順に設定を行ってください。

1

GTFS URLを登録する

ODPTや自社サーバーなど、外部から取得可能な GTFS ZIPファイルのURL を登録してください。

もしくは、登録ボタン下の「単純なGTFSデータを作成する」からGTFSを作成できます。この機能で作成したGTFSは、自動でGTFS URLに登録されます。

  • ブラウザからダウンロードできるZIPファイルのURLを指定してください。
  • ログインが必要なURLや、社内からしかアクセスできないURLは利用できません。
  • 登録後、GTFS URLを変更した場合は Step3 の trip_id の設定も見直してください。
GTFS URL登録画面のスクリーンショット
2

車載器(ICCID)を登録する

車載器ごとの ICCID を登録し、任意の車両名を設定してください。ICCID はSIMの固有番号で、車両の識別に使用します。

  • 車両名は重複できません。
  • 設定したアイコンは、バスロケ画面で車両のアイコンとして表示されます。
車載器を追加すると、まず「申請中」になります。通常3営業日以内に承認され、Step3 で車両名として選択できるようになります。申請が承認されると、完了通知メールが送信されます。
車載器登録画面のスクリーンショット
3

便(trip_id)に車両を割り当てる

GTFSデータ内に存在する trip_id を登録し、Step2 で登録した車両を割り当ててください。

  • trip_id には、GTFS の trips.txt に記載されている値を登録してください。
  • GTFSから選択 ボタンから trip_id を選択して追加できます。
  • trip_id は手入力でも登録できます。
  • 車両名は Step2 で登録したものから選択できます。
表示したくない便は、車両名を [ 割り当てなし (非表示) ] に設定してください。
trip_idへの車両割り当て画面のスクリーンショット

システム有効化

設定が完了したら、画面上部にあるバスロケシステムのスイッチを 有効 にしてください。

有効にすると、GTFSファイルの読み込み、車載器の位置情報データの取得、バスロケ画面の表示が開始されます。
設定後は、バスロケ画面を開いて次を確認してください。
  • 停留所が地図に表示される
  • 経路線を設定している場合は、経路線が地図に表示される
  • 運行中は、車両が地図に表示される
システム有効化画面のスクリーンショット

アラート管理(任意)

運休や遅延などのお知らせをアラートとして登録できます。

登録したアラートは、開始日時から終了日時までの期間中、以下の場所に表示されます。

  • バスロケ画面
  • GTFSリアルタイムデータ(Alert.pb
アラート管理画面のスクリーンショット

バスロケ画面

URL

登録したユーザーIDがバスロケ画面のURLに使用されます。ユーザーID を実際のユーザーIDに置き換えてください。

https://gtfs.live/#ユーザーID

地図表示

  • 表示対象の車両は、1つの地図にまとめて表示されます。
  • 表示したくない便は、Step3で「割り当てなし(非表示)」に設定してください。
  • 車載器の電源が入っていない車両は表示されません。
車両が表示されない場合は、Step3 の割り当て、車載器の電源、下記の車両が表示される条件を確認してください。

車両が表示される条件

車両は、次の条件を満たすと表示されます。
  • その便の表示時間帯内である
    便ごとの表示時間帯
    開始:最初の停留所の出発予定時刻の 1 分前
    終了:最後の停留所の到着予定時刻の 30 分後
  • その便の停留所付近で車両の位置情報が一度でも取得されている

運行終了

最後の停留所に到着した車両は「運行終了」となり、画面から消えます。

GTFSデータの更新

GTFSデータは毎日午前1時に再取得されます。
すぐ反映したい場合は、管理画面でバスロケシステムを一度無効にしてから再度有効にしてください。

GTFSリアルタイムデータ

このセクションは、外部システムとの連携向けの情報です。

いちごロケLITEでは GTFS Realtime Protobuf Version 2.0 を配信しています。

  • TripUpdate
  • VehiclePosition
  • Alert

配信URL

登録したユーザーIDが配信URLに使用されます。ユーザーID を実際のユーザーIDに置き換えてください。

TripUpdate

https://gtfs.live:2048/TripUpdate.pb?ユーザーID

VehiclePosition

https://gtfs.live:2048/VehiclePosition.pb?ユーザーID

Alert

https://gtfs.live:2048/Alert.pb?ユーザーID

更新頻度

リアルタイムデータは約10秒間隔で更新されます。

注意事項

表示や更新について

  • GTFSデータの内容に不備がある場合、バスロケ画面が正常に表示されないことがあります。
  • 車載器の通信状況により、位置情報の更新が遅れる場合があります。

URLについて

  • ユーザーIDはバスロケ画面URLおよびGTFSリアルタイム配信URLに使用されます。