オンデマンド交通を含めた経路探索

オンデマンド交通を含めた経路探索を行います。特にオンデマンド交通を積極的に案内したいサービスを実装する際に、有効なリクエスト方法を紹介します。

関連する機能

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

機能の特徴

経路探索機能では mode パラメータを使って、経路に利用する交通機関をコントロールすることができます。オンデマンド交通を含む経路探索には2種類あります。

modeパラメータ	求める経路
mode=public または未指定	かならず公共交通機関(鉄道・バス・空路・海路)を利用する経路を求めます。ファーストワンマイル・ラストワンマイルにオンデマンド交通が利用されることがあります。
mode=demand	徒歩とオンデマンド交通だけを利用する経路を求めます。

ヒント

出発地点から最寄り駅までをファーストワンマイル、最寄り駅から到着地点までをラストワンマイルと呼ぶことがあります。mixway APIは、これらの区間に徒歩・シェアサイクル・オンデマンド交通のいずれかを利用する経路を算出します。 maxWalkDistanceなどのパラメータを使うことで、利用する種別や距離を制限することができます。詳細は各機能ドキュメントを参照してください。

それぞれを指定したときの経路例は以下の通りです。

mode=public指定時

ぐんまフラワーパークから前橋市役所の経路探索例

サンプルリクエスト

https://mixway.ekispert.jp/v1/json/search/course/extreme
?key=YOUR_API_KEY
&mode=public
&viaList=36.45585597880268,139.17589036432977:36.3893695869827,139.06347035533273
&fromName=ぐんまフラワーパーク
&toName=前橋市役所

結果経路

オンデマンド交通である「ふるさとバス」で樋越駅へ移動したのち、鉄道を利用して到着地点へ向かう経路が取得できます。

mode=demand指定時

菰野町役場から菰野駅の経路探索例

サンプルリクエスト

https://mixway.ekispert.jp/v1/json/search/course/extreme
?key=YOUR_API_KEY
&mode=demand
&viaList=35.02015499384594,136.50708141468047:35.0088246513852,136.51739785119253
&fromName=菰野町役場
&toName=菰野駅

結果経路

オンデマンド交通である「のりあいタクシー」と徒歩だけを利用する経路が取得できます。

手順

上記の通り、オンデマンド交通を利用する経路を取得する方法は2種類あります。特にオンデマンド交通を積極的に案内したいサービスでは、両方の方法から経路を取得し表示することで、ユーザーへより多様な経路を案内することができます。

図のように、ユーザーが指定した二地点間についてmode=public mode=demandをそれぞれ付与して経路探索を実行することで、より多様な経路を取得することができます。 mode=demandから取得した経路を目立たせることで、オンデマンド交通で快適に移動する経路を、より強くユーザーへ案内することが可能です。

なおいずれのリクエストにおいても、二地点間を移動することができず、1つも経路が返却されないこともある点には留意してください。 またこれ以外のパラメータやレスポンスに関する情報はそれぞれの機能のドキュメントページをご覧ください。

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