配送計画(バイク)

/auto_dispatch_motorcycle [POST] [GET]

基本情報

概要

移動手段をバイクとして、グループ化の条件によって分割された最適順に巡回するルートを検索します。
※当APIをご利用の場合は、オプション契約が別途必要となります

リクエスト回数について

本APIはルート検索に時間を要する場合があるため、1回のルート検索につき2回のリクエストが必要になります。
1回目はPOST形式で検索リクエストを受け付け、2回目はGET形式で検索結果を返却します。

URL

https://{HOST}/{CID}/v1/auto_dispatch_motorcycle

※APIマーケットでは提供しておりません

出力形式

JSON

対応言語

ja, en, ko, zh-CN, zh-TW, th

パラメータ [POST]

Content-Typeヘッダーにapplication/x-www-form-urlencodedを指定し、リクエストボディにパラメータを指定して送信してください。

signature及びrequest_codeはリクエストボディではなく、クエリパラメータに指定してください。

パラメータ名	必須	概要	型名	デフォルト値	上下限/選択値	備考
num	(✔)	経路の分割数	数値		上限：経由地数	duration、capacityとの併用は不可（いずれかを必ず指定）詳細はこちらをご覧ください
duration	(✔)	各経路の所要時間(単位：分)	数値		最小値：1 最大値：9999	num、capacityとの併用は不可（いずれかを必ず指定）詳細はこちらをご覧ください
capacity	(✔)	各経路の積載上限量	数値		最小値：1 最大値：9999	num、durationとの併用は不可（いずれかを必ず指定）詳細はこちらをご覧ください
start	✔	出発地点/到着地点	・地点のJSON表現・文字列（ノードID）・カンマ区切りの数値（緯度,経度）			緯度経度の指定例：35.689457,139.691935（東京都庁）
via	✔	経由地	地点のJSON表現（配列）			詳細はこちらをご覧ください
start_time		出発時刻	文字列（日付時刻） YYYY-MM-DDThh:mm:ss			時刻の指定例　2019-10-01T08:00:00 詳細はこちらをご覧ください
goal_time		到着時刻	文字列（日付時刻） YYYY-MM-DDThh:mm:ss			時刻の指定例　2019-10-01T08:00:00 詳細はこちらをご覧ください
condition		経路検索条件	文字列	recommend	recommend：推奨 toll_time：有料道路優先、時間優先 toll_distance：有料道路優先、距離優先 toll_gas：有料道路優先、ガソリン節約優先 free_time：無料道路優先、時間優先 free_distance：無料道路優先、距離優先 free_gas：無料道路優先、ガソリン節約優先 free_only：無料道路利用
order		出力順	文字列	time	total_distance: 総移動距離 time: 所要時間
use_road		利用したい道路ID	文字列			ピリオド区切りで複数指定可能です詳細はこちらをご覧ください
unuse_road		利用したくない道路ID	文字列			ピリオド区切りで複数指定可能です詳細はこちらをご覧ください
use_traffic		渋滞情報の考慮	文字列		vics：VICS提供の道路交通情報 probe：プローブから生成された道路交通情報	ピリオド区切りで複数指定が可能ですパラメータ「start_time」または「goal_time」を指定時のみ有効です検索対象が過去日時の場合は考慮されません ※VICS / プローブのご利用は、オプション機能のため、別途契約が必要となります ※vicsを指定した場合は、リクエストヘッダー「x-ntj-uid」、または、パラメータ「uid」を必ず設定してください
uid	(✔)	VICS使用時のユーザー識別子	文字列		1文字以上50文字以内	※VICS / プローブのご利用は、オプション機能のため、別途契約が必要となります ※パラメータ「use_traffic」で「vics」を指定した場合は、リクエストヘッダー「x-ntj-uid」、または、パラメータ「uid」を必ず設定してください
options		追加出力情報	文字列		turn_by_turn：ターンバイターン情報	交差点等、進行情報を案内するための地点情報を取得します
smart_ic		スマートIC考慮	文字列	unuse	unuse : スマートICを考慮しない use : スマートICを考慮する
ferry		フェリー優先検索	文字列	use	unuse : フェリーを使わない use : フェリーを使う more_use : フェリーを優先して使う
wide		道幅の考慮	文字列	unuse	unuse：道幅を考慮しない use：道幅を考慮する more_use : 積極的に道幅を考慮する
etc		ETC料金計算	文字列	unuse	use：時刻を考慮したETC料金計算を行う unuse : 時刻を考慮したETC料金計算を行わない	use指定時にfareに出力される料金はETC料金のみとなります
avoid_etc_only		ETC専用料金所の回避	真偽値	false	true : ETC専用料金所を回避する false : ETC専用料金所を回避しない	対応しているICの詳細はこちらをご覧ください
shape		形状出力	真偽値	false	- true - false	trueを指定時にはshapes(ルート形状)が出力されます
displacement		排気量(単位：cc)	数値		最小値 : 1 最大値 : 3000	バイクの排気量を指定します 125未満の場合は地点JSONでicを指定することができません
fuel		燃費	数値		最小値: 1 最大値: 200	1ℓ当たりの走行可能距離を示します
datum		緯度経度の測地系	文字列	wgs84	wgs84：世界測地系 tokyo：旧日本測地系
coord_unit		出力データに含まれる緯度経度の単位	文字列	degree	degree：度表記の10進法 millisec：ミリ秒表記
lang		言語	文字列		ja: 日本語 en: 英語 ko: 韓国語 zh-CN: 中国語(簡体字) zh-TW: 中国語(繁体字) th: タイ語	出力する言語を指定します ※多言語オプション申込時のみ利用可能

グループ化の条件について

グループ化の条件は、目的に合わせてnum、duration、capacityのいずれかを指定することが可能です。
・num : 経路を分割する数を指定
　利用例) 配送先(via)が100件に対して、配達担当4人(num=4)で運ぶ場合に誰がどこを回るのが効率的か
・duration : 各経路の所要時間を指定
　利用例) 配送先(via)が100件に対して、各配達員の勤務時間を5時間(duration=300)とした時、何人で分割すれば良いか
・capacity : 各経路の積載量上限を指定
　利用例) 各訪問先(via)に配送する量(cargo)が決まっている時、各配達員のトラックの積載量の上限を20とした場合に何台必要か

※capacityを利用する場合は、合わせて各経由地にcargo(配送貨物量)を指定してください。
　また、capacityとcargoで指定する値は同じ単位を指定してください(例: kg, 個)。
※duration, capacityを指定した場合、指定した条件を満たさない場合があります。

ルート検索時の日付（時刻）指定について

出発時刻(start_time)と到着時刻(goal_time)を指定する場合は、どちらか片方を指定してください(同時指定はできません)。
・start_time（日付時刻指定）：出発地からの出発時刻の指定
・goal_time（日付時刻指定）：目的地への到着時刻の指定

両方未指定の場合は、POST通信の検索実行日時が出発時刻となります。

経路検索条件の無料道路利用の注意点について

無料道路利用は無料道路優先より高い優先度で検索する経路検索条件です。
パラメータの組み合わせによって、一部経路結果に有料道路が含まれる場合がありますのでご了承ください。

利用したい道路ID(use_road)について

利用したい道路の道路IDを指定することで、その道路を利用するルートを優先して検索します。
出発地・目的地の位置関係や道路データ収録状況の影響により、指定した道路が考慮されない場合があります。
利用したくない道路ID(unuse_road)と同一の道路IDを指定した場合はエラーとなります。

利用したくない道路ID(unuse_road)について

利用したくない道路の道路IDを指定することで、その道路を利用しないルートを優先して検索します。
指定した道路が考慮されない場合があります(例えば指定した道路が出発地と重なった場合)。
利用したい道路ID(use_road)と同一の道路IDを指定した場合はエラーとなります。

対応しているICについて(avoid_etc_only)

首都高(ICは入口のみETC専用化)
霞ヶ関(内外)、代官町(内)、空港西(上)、新宿(上)、初台(下)、幡ヶ谷(上)、一ツ橋(下)、護国寺(上)、中環大井南(外)、富ヶ谷(外)、初台南(内)、滝野川(内)、高松(外)、王子北(外)、四つ木(内外)、清新町(内)、さいたま見沼(上)、浦和南(上)、浜町(上下)、加平(南)(上下)、加平(北)(上下)、晴海(下)、加賀(上)、安行(上)、新木場(東西)、大井(東)、磯子(東)、木場(上)、横浜駅東口(下)、新山下(上下)、馬場
東日本高速道路(ICは入口のみETC専用化)
戸田西(内)、戸田東(外)
中日本高速道路
稲城(入口)、八王子西(出入口)

車両区分について

独自の基準に基づき、排気量によって車両区分が決定されます。
1 ~ 49 : 原付二輪自動車
50 ~ 124 : 小型二輪自動車
125 ~ 249 : 普通二輪自動車
250 ~ : 大型二輪自動車

地点の JSON 表現

プロパティ名	必須	概要	型名	デフォルト値	備考
lat	(✔)	緯度	数値
lon	(✔)	経度	数値
node	(✔)	駅/連絡バス停ID	文字列		経由地の場合は駅/連絡バス停IDは指定できません緯度経度で指定してください
cargo		配送貨物量	数値	0	パラメータ「capacity」指定時に有効指定されたcargoの値を元に積載量上限(capacity)を超えない様に経路を分割
name		地点名称	文字列
road-type		地点の道路種別	文字列	free	free：無料道路 toll：有料道路 any：有料無料全ての道路が対象
angle		方位	数値		0～360度出発地を指定する場合のみ使用可能です
park-side		横付け	数値		always_along：常に同一車線側に横付け along：狭い道路以外は同一車線側に横付け
stay-time		経由地の滞在時間(単位：分)	数値		最小値：0 最大値：300 経由地を指定する場合のみ使用可能です

出発地点と到着地点、経由地点のJSON表現における必須項目の指定方法について

lat/lon、node の内どちらか一つの指定が必須となります(複数指定はエラー)。
latを指定した場合は、lonも必ず指定してください。
lonを指定した場合は、latも必ず指定してください。

経由地の指定方法について

経由地の数だけ地点のJSON表現を配列にして記述します。経由地が1点の場合でも配列表現が必要です。
経由地が1点の場合の記述例は以下の通りです。
via=[{"lat":35.706822,"lon":139.813956}]

最適順ルート、経由地間最適順ルートを求める場合、経由地は2地点以上登録する必要があります。

経由地指定の上限数は、250地点です。上限数を超える経由地を指定するとエラーとなります。

レスポンス [POST]

名称	レスポンス名	型名	配列	説明
ルート検索ID	processing_id	文字列		リクエストを受け付けたルート検索ごとに発行されるID

レスポンス例

{"processing_id": "8405511d33ebba6e122436b74cb6a215460609b6725b41a9d0ee0bf0b3f85ee9"}

パラメータ [GET]

パラメータ名	必須	概要	型名	デフォルト値	上下限/選択値	備考
processing_id	✔	ルート検索ID	文字列			POSTリクエストで取得したIDを指定してください

パラメータ構成例

/auto_dispatch_motorcycle?processing_id=8405511d33ebba6e122436b74cb6a215460609b6725b41a9d0ee0bf0b3f85ee9

レスポンス [GET]

ルート検索が正常に完了している場合、レスポンスは/route_motorcycleと同様です。

ルート検索が完了していない場合、POSTリクエストと同様のレスポンス「processing_id」を返却します。
5分程度時間をおいてから再度リクエストを実行してください。

検索結果はリクエスト実行後、24時間で削除されます。