配車結果に応じた経路を求める

オンデマンド交通は、事前に定められた時刻表に従って運行されるのではなく、需要や車の状態に応じてルートが決定されます。そのため、配車システムを通じて実際の予約をおこなったときの所要時間は、mixway APIに格納されている平均的な所要時間と異なる場合があります。また所要時間だけでなく乗車・降車時刻も刻一刻と変化します。

配車システムからこれらの最新の情報を取得し、経路検索結果の経路をアップデートすることは、ユーザーへ移動に必要な情報を提供するという観点で、特にオンデマンド交通利用者にとって有用です。

全体概要

以下のような流れで配車結果に応じた経路を求めます。

経路探索し、取得した経路の中から利用する経路を選ぶ。
1で選択した経路のうち、オンデマンド交通を利用する区間について、配車システムを利用し配車(予約)を行う。配車情報が確定したら、最新の到着時刻を取得する。
2で取得した予想される到着時刻を経路に反映する。

経路探索

ユーザーの入力した情報に応じて、経路探索(/search/course/extreme)から経路を求めます。オンデマンド交通を含む経路探索についてはオンデマンド交通を含めた経路探索を参照してください。

ここでは以下のような経路が取得でき、ユーザーが選択したものとします。2区間目にオンデマンドバス「ふるさとバス」を利用する経路です。

配車(予約)の実行

取得した経路を元に、配車システムに配車(予約)を実行します。配車システムとの通信については、それぞれのシステムに依るためここでは言及しません。また経路情報を元にどのような配車をリクエストするのか(出発時刻指定なのか到着時刻指定なのか等)は、アプリケーション実装時に検討してください。

ここでは、前項で例とした経路を元に以下のような配車(予約)をリクエストし、実際に配車が確定できたものとします。

リクエスト

出発ポート: ぐんまフラワーパーク
到着ポート: 樋越駅
出発希望時刻: 10:32

配車確定

出発予定時刻: 10:50
到着予定時刻: 11:00 (元の経路上の到着時刻は10:46だった)

経路への反映

経路の再現に serializeData sectionIndex assignType date time を指定することで、経路の途中から再探索することができます。

パラメータ	意味
serializeData	再探索したい経路の経路シリアライズデータを指定
sectionIndex	再探索時に基準とする区間の区間インデックスを指定
assignType	指定する日時を発時刻指定と扱うか、着時刻指定と扱うかを指定。ここでは`arrival`を指定します。
date	再探索日
time	再探索時刻

前項で取得した配車確定情報から「樋越駅」のポートに11:00に到着予定であることが分かります。以下のように指定することで、「ふるさとバス」に当たる2区間目が11:00に到着するように経路を再探索することができます。

https://mixway.ekispert.jp/v1/json/course/edit
?key=YOUR_API_KEY
&serializeData={{経路探索で取得した経路シリアライズデータ}}
&sectionIndex=2
&assignType=arrival
&date=20230401
&time=1100

「樋越駅」のポートに11:00に到着する経路が得られました。それ以降の区間(上毛電気鉄道)も元経路より時刻が繰り下がっていること確認してください。また先述のとおりmixway APIはオンデマンド交通のポート間の平均的な所要時間しか保持していないため、「ぐんまフラワーパーク」よりの前の区間の発着時刻も繰り下がっていることがわかります。

そのため配車システムから取得した配車情報をもとに、経路情報の一部を置き換えます。

以上の操作により、配車システムから取得した最新の発着時刻を反映したオンデマンド交通を含む経路を取得することができました。

なおmixway APIにおけるオンデマンド交通は、ファーストワンマイル・またはラストワンマイルに当たる区間で利用されます。そのため例えば [鉄道] - [オンデマンド交通] - [鉄道] のような経路は算出されないことに留意してください。

本ページで紹介した以外のパラメータやレスポンスに関する情報は、それぞれの機能のドキュメントページをご覧ください。

機能	パス
経路探索	/v1/json/search/course/extreme
経路探索（リアルタイム）	/v1/json/realtime/search/course/extreme
経路の再現	/v1/json/course/edit

関連する機能​

全体概要​

経路探索​

配車(予約)の実行​

経路への反映​

関連する機能

全体概要

経路探索

配車(予約)の実行

経路への反映