自動車経路候補一覧取得

API名: 
route3/drive_list
概要: 
緯度経度から自動車の経路候補を取得します

※一部パラメータを利用するには別途契約が必要です。
※一部開発中の機能があります。

URI: 

http://core.its-mo.com/zmaps/api/apicore/core/v1_0/route3/drive_list

<API使用例>
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/route3/drive_list?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&from=35.792099167,139.763894444&to=35.772690278,139.753888889

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
from - 出発地点
検索するルートの出発地点を緯度経度で指定します。
本項目は必須項目であるため、未指定の場合はエラーとなります。
to - 到着地点
検索するルートの到着地点を緯度経度で指定します。
本項目は必須項目であるため、未指定の場合はエラーとなります。
datum   TOKYO 測地系
入出力緯度経度の測地系を指定します。
mpoints   - 経由地点
検索するルートの経由地点を緯度経度で指定します。
最大20点まで複数値指定できます。
tolltype   normal 料金車種
通行料金算出時に使用される車種を指定します。
指定値 説明
light 軽自動車
normal 普通車
middle 中型車
large 大型車
big 特大車
height   - 車高
車高を0~65534の整数で指定します。単位は(cm)です。
本パラメータを指定すると道路情報を考慮し、車高による車両制限を加味したルート検索を行います。無指定時は車高による車両制限は加味されません。
※目的地までの通行可能な経路がない場合、通行不可な道路を含む経路を返します。
width   - 車幅
車幅を0~65534の整数で指定します。単位は(cm)です。
本パラメータを指定すると道路情報を考慮し、車幅による車両制限を加味したルート検索を行います。無指定時は車幅による車両制限は加味されません。
※目的地までの通行可能な経路がない場合、通行不可な道路を含む経路を返します。
weight   - 車重
車重を0~65534の整数で指定します。単位は(kg)です。
本パラメータを指定すると道路情報を考慮し、車重による車両制限を加味したルート検索を行います。無指定時は車重による車両制限は加味されません。
※目的地までの通行可能な経路がない場合、通行不可な道路を含む経路を返します。
smartic   F スマートIC利用指定
検索時にスマートICを利用するかどうかを真偽値で指定します。
llunit   dec 緯度経度形式
入出力緯度経度形式を指定します。
vics   F VICS指定
VICSを加味した経路検索を行うかどうかを真偽値で指定します。
statistics パラメータをT指定または departuretimeパラメータを指定している場合に本パラメータをT指定するとパラメータエラーとなります。
※本機能を利用する場合には別途契約が必要です。
departuretime   - 出発時刻指定
出発時刻を日時で指定します。
vicsパラメータをTに指定して、本パラメータを指定した場合にはパラメータエラーとなります。
statistics   F 渋滞統計情報
渋滞統計情報を考慮した経路探索を行うかどうかを真偽値で指定します。
本パラメータを有効(T)にするとdeparturetimeパラメータが必須パラメータになり、この指定時刻を元に渋滞統計情報を利用して経路探索を行います。
なお、渋滞統計情報のデータが存在するのは15分後~1年後の間となります。この範囲外の時刻を departuretime パラメータで指定した場合、経路探索結果に渋滞統計情報は考慮されません。
vicsパラメータをT指定して本パラメータをT指定するとパラメータエラーとなります。
※本機能を利用する場合には別途契約が必要です。
cardetailinfo   D 詳細車種
規制考慮(regulation)、二段階Uターン回避(twouturn)に使用する車種を指定します。
※本機能を利用する場合には別途契約が必要です。
※本機能は開発中の機能です。
指定値 説明
0 中型乗用自動車
1 マイクロバス
2 特定中型乗用自動車
3 大型乗用自動車
4 普通貨物自動車1t
5 普通貨物自動車2t
6 普通貨物自動車2.5t
7 中型貨物自動車3t
8 中型貨物自動車3.5t
9 中型貨物自動車4t
A 特定中型貨物自動車
B 大型貨物自動車
C 大型特殊自動車
D 普通乗用自動車
regulation   - 規制考慮
cardetailinfoで指定された車種と指定された規制情報を考慮して経路検索を行います。
下記のパラメータを指定します。複数値指定できます。

※目的地までの通行可能な経路がない場合、通行不可な道路を含む経路を返します。
※本機能を利用する場合には別途契約が必要です。
※本機能は開発中の機能です。

指定値 説明
season 季節規制考慮
departuretimeパラメータで指定した日時で季節規制を考慮します。
vicsがT指定されている場合、またはdeparturetimeの指定が無い場合は現在時での動作となります。
time 時間帯規制考慮
departuretimeパラメータで指定した日時で時間帯規制を考慮します。
vicsがT指定されている場合、またはdeparturetimeの指定が無い場合は現在時での動作となります。
twouturn   F 2段階Uターン回避
cardetailinfoで指定された車種で2段階Uターンを行うルートを回避します。
※本機能を利用する場合には別途契約が必要です。
※本機能は開発中の機能です。
出力データ
出力フォーマット
{"status": {"code": "0000",
                  "text": ""},
 "item":[{"routeID":"THB_51cd3ca8ec05772732c40d7ada9c4da1",
          "type":"0",
          "distance":552,
          "toll":0,
          "time":2,
          "line":[{"lat":35.6256806,
                   "lon":139.7452033},
                  {"lat":35.6256764,
                   "lon":139.7452619},
                  {"lat":35.6256764,
                   "lon":139.7452619},
                  {"lat":35.6256561,
                   "lon":139.74543},
                  {"lat":35.6256561,
                   "lon":139.74543},
                  {"lat":35.6256206,
                   "lon":139.7460022},
                  {"lat":35.6256206,
                   "lon":139.7460022},
                  {"lat":35.6250253,
                   "lon":139.7459411},
                  {"lat":35.6250253,
                   "lon":139.7459411},
                  {"lat":35.6250356,
                   "lon":139.7456358},
                  {"lat":35.6250356,
                   "lon":139.7456358},
                  {"lat":35.6216583,
                   "lon":139.7461167},
                  {"lat":35.6216583,
                   "lon":139.7461167},
                  {"lat":35.621645,
                   "lon":139.7460611},
                  {"lat":35.621645,
                   "lon":139.7460611},
                  {"lat":35.621645,
                   "lon":139.7460611}]}, ....]}
キー名 データ型 説明
status     object ステータス情報が入ります。
  code   string ステータスコードが入ります。
返却値 説明
0000 正常終了
0001 タイムアウトが発生またはデータサイズが
制限値を超えたため処理が中断された
8001 各始点・経由点・終点の距離が近すぎる
8101 各始点・経由点・終点の距離が遠すぎる
0112 経路探索失敗
0114 経路誘導失敗
  text   string ステータス内容に関するテキスト情報が入ります。
item     array ルート検索結果一覧が入ります。
  routeID   string ルートIDが入ります。 ルートの詳細情報を取得するのに使用します。
なお、この値は取得後24時間まで有効となります。
  type   string 検索タイプが入ります。
返却値 説明
0 推奨ルート
1 一般道優先
2 道幅優先
3 距離優先
4 別ルート優先
  distance   number 経路の大まかな距離(メートル)が入ります。
  toll   number トータルの料金(円)が入ります。
  time   int トータルの時間(分)が入ります。
  line   array 経路の大まかな形状が入ります。
出力例

[通常出力例] http://core.its-mo.com/zmaps/api/apicore/core/v1_0/route3/drive_list?
if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
from=35.792099167,139.763894444&to=35.772690278,139.753888889
&mpoints&cartype=normal&smartic=T&departuretime=&vics=F

{"status": {"code": "0000",

                  "text": ""},

"item":[{"routeID":"THB_2aca576583926150c73bf5f999ad1ec7",
          "type":"0",
          "distance":2981,
          "toll":0,
          "time":8,
          "line":[{"lat":35.7920694,
                   "lon":139.7638769},
                  {"lat":35.7921092,
                   "lon":139.7638092},
                  {"lat":35.7921092,
                   "lon":139.7638092},
                  {"lat":35.7919922,
                   "lon":139.7636947},
                  {"lat":35.7919922,
                   "lon":139.7636947},
                  {"lat":35.7916869,
                   "lon":139.7634278},
                  {"lat":35.7916869,
                   "lon":139.7634278},
                  {"lat":35.7911378,
                   "lon":139.7629089},
                  {"lat":35.7911378,
                   "lon":139.7629089},
                  {"lat":35.7895203,
                   "lon":139.76136},
                  {"lat":35.7895203,
                   "lon":139.76136},
                  {"lat":35.7890167,
                   "lon":139.7608642},
                  {"lat":35.7890167,
                   "lon":139.7608642},
                  {"lat":35.7881672,
                   "lon":139.7600403},
                  {"lat":35.7881672,
                   "lon":139.7600403},
                  {"lat":35.7877706,
                   "lon":139.7596586},
                  {"lat":35.7877706,
                   "lon":139.7596586},
                  {"lat":35.7857258,
                   "lon":139.7576597},
                  {"lat":35.7857258,
                   "lon":139.7576597},
                  {"lat":35.7853597,
                   "lon":139.7572631},
                  {"lat":35.7853597,
                   "lon":139.7572631},
                  {"lat":35.7845256,
                   "lon":139.7564392},
                  {"lat":35.7845256,
                   "lon":139.7564392},
                  {"lat":35.7840983,
                   "lon":139.7559508},
                  {"lat":35.7840983,
                   "lon":139.7559508},
                  {"lat":35.7837117,
                   "lon":139.7553711},
                  {"lat":35.7837117,
                   "lon":139.7553711},
                  {"lat":35.7833047,
                   "lon":139.7543944},
                  {"lat":35.7833047,
                   "lon":139.7543944},
                  {"lat":35.7826333,
                   "lon":139.7515258},
                  {"lat":35.7826333,
                   "lon":139.7515258},
                  {"lat":35.7814736,
                   "lon":139.7507628},
                  {"lat":35.7814736,
                   "lon":139.7507628},
                  {"lat":35.7802122,
                   "lon":139.75},
                  {"lat":35.7802122,
                   "lon":139.75},
                  {"lat":35.7781983,
                   "lon":139.7487792},
                  {"lat":35.7781983,
                   "lon":139.7487792},
                  {"lat":35.7749633,
                   "lon":139.7499694},
                  {"lat":35.7749633,
                   "lon":139.7499694},
                  {"lat":35.7749431,
                   "lon":139.75},
                  {"lat":35.7749431,
                   "lon":139.75},
                  {"lat":35.77476,
                   "lon":139.7502442},
                  {"lat":35.77476,
                   "lon":139.7502442},
                  {"lat":35.7737581,
                   "lon":139.7519303},
                  {"lat":35.7737581,
                   "lon":139.7519303},
                  {"lat":35.7730356,
                   "lon":139.7532272},
                  {"lat":35.7730356,
                   "lon":139.7532272},
                  {"lat":35.7726461,
                   "lon":139.7538617},
                  {"lat":35.7726461,
                   "lon":139.7538617},
                  {"lat":35.7726461,
                   "lon":139.7538617}]},
         {"routeID":"THB_2fa9f38dc6f625ef3d21e834be5313c0",
          "type":"1",
          "distance":2981,
          "toll":0,
          "time":8,
          "line":[{"lat":35.7920694,
                   "lon":139.7638769},
                  {"lat":35.7921092,
                   "lon":139.7638092},
                  {"lat":35.7921092,
                   "lon":139.7638092},
                  {"lat":35.7919922,
                   "lon":139.7636947},
                  {"lat":35.7919922,
                   "lon":139.7636947},
                  {"lat":35.7916869,
                   "lon":139.7634278},
                  {"lat":35.7916869,
                   "lon":139.7634278},
                  {"lat":35.7911378,
                   "lon":139.7629089},
                  {"lat":35.7911378,
                   "lon":139.7629089},
                  {"lat":35.7895203,
                   "lon":139.76136},
                  {"lat":35.7895203,
                   "lon":139.76136},
                  {"lat":35.7890167,
                   "lon":139.7608642},
                  {"lat":35.7890167,
                   "lon":139.7608642},
                  {"lat":35.7881672,
                   "lon":139.7600403},
                  {"lat":35.7881672,
                   "lon":139.7600403},
                  {"lat":35.7877706,
                   "lon":139.7596586},
                  {"lat":35.7877706,
                   "lon":139.7596586},
                  {"lat":35.7857258,
                   "lon":139.7576597},
                  {"lat":35.7857258,
                   "lon":139.7576597},
                  {"lat":35.7853597,
                   "lon":139.7572631},
                  {"lat":35.7853597,
                   "lon":139.7572631},
                  {"lat":35.7845256,
                   "lon":139.7564392},
                  {"lat":35.7845256,
                   "lon":139.7564392},
                  {"lat":35.7840983,
                   "lon":139.7559508},
                  {"lat":35.7840983,
                   "lon":139.7559508},
                  {"lat":35.7837117,
                   "lon":139.7553711},
                  {"lat":35.7837117,
                   "lon":139.7553711},
                  {"lat":35.7833047,
                   "lon":139.7543944},
                  {"lat":35.7833047,
                   "lon":139.7543944},
                  {"lat":35.7826333,
                   "lon":139.7515258},
                  {"lat":35.7826333,
                   "lon":139.7515258},
                  {"lat":35.7814736,
                   "lon":139.7507628},
                  {"lat":35.7814736,
                   "lon":139.7507628},
                  {"lat":35.7802122,
                   "lon":139.75},
                  {"lat":35.7802122,
                   "lon":139.75},
                  {"lat":35.7781983,
                   "lon":139.7487792},
                  {"lat":35.7781983,
                   "lon":139.7487792},
                  {"lat":35.7749633,
                   "lon":139.7499694},
                  {"lat":35.7749633,
                   "lon":139.7499694},
                  {"lat":35.7749431,
                   "lon":139.75},
                  {"lat":35.7749431,
                   "lon":139.75},
                  {"lat":35.77476,
                   "lon":139.7502442},
                  {"lat":35.77476,
                   "lon":139.7502442},
                  {"lat":35.7737581,
                   "lon":139.7519303},
                  {"lat":35.7737581,
                   "lon":139.7519303},
                  {"lat":35.7730356,
                   "lon":139.7532272},
                  {"lat":35.7730356,
                   "lon":139.7532272},
                  {"lat":35.7726461,
                   "lon":139.7538617},
                  {"lat":35.7726461,
                   "lon":139.7538617},
                  {"lat":35.7726461,
                   "lon":139.7538617}]},
         {"routeID":"THB_3c8b55d6a40b0623a85564a605941fbb",
          "type":"2",
          "distance":2978,
          "toll":930,
          "time":7,
          "line":[{"lat":35.7920694,
                   "lon":139.7638769},
                  {"lat":35.7921092,
                   "lon":139.7638092},
                  {"lat":35.7921092,
                   "lon":139.7638092},
                  {"lat":35.7919922,
                   "lon":139.7636947},
                  {"lat":35.7919922,
                   "lon":139.7636947},
                  {"lat":35.7883708,
                   "lon":139.7600403},
                  {"lat":35.7883708,
                   "lon":139.7600403},
                  {"lat":35.7873536,
                   "lon":139.7590942},
                  {"lat":35.7873536,
                   "lon":139.7590942},
                  {"lat":35.7871703,
                   "lon":139.7589111},
                  {"lat":35.7871703,
                   "lon":139.7589111},
                  {"lat":35.7845256,
                   "lon":139.7564392},
                  {"lat":35.7845256,
                   "lon":139.7564392},
                  {"lat":35.7840983,
                   "lon":139.7559508},
                  {"lat":35.7840983,
                   "lon":139.7559508},
                  {"lat":35.7837117,
                   "lon":139.7553711},
                  {"lat":35.7837117,
                   "lon":139.7553711},
                  {"lat":35.7833047,
                   "lon":139.7543944},
                  {"lat":35.7833047,
                   "lon":139.7543944},
                  {"lat":35.7826333,
                   "lon":139.7515258},
                  {"lat":35.7826333,
                   "lon":139.7515258},
                  {"lat":35.7814736,
                   "lon":139.7507628},
                  {"lat":35.7814736,
                   "lon":139.7507628},
                  {"lat":35.7802122,
                   "lon":139.75},
                  {"lat":35.7802122,
                   "lon":139.75},
                  {"lat":35.7781983,
                   "lon":139.7487792},
                  {"lat":35.7781983,
                   "lon":139.7487792},
                  {"lat":35.7749633,
                   "lon":139.7499694},
                  {"lat":35.7749633,
                   "lon":139.7499694},
                  {"lat":35.7749431,
                   "lon":139.75},
                  {"lat":35.7749431,
                   "lon":139.75},
                  {"lat":35.77476,
                   "lon":139.7502442},
                  {"lat":35.77476,
                   "lon":139.7502442},
                  {"lat":35.7737581,
                   "lon":139.7519303},
                  {"lat":35.7737581,
                   "lon":139.7519303},
                  {"lat":35.7730356,
                   "lon":139.7532272},
                  {"lat":35.7730356,
                   "lon":139.7532272},
                  {"lat":35.7726461,
                   "lon":139.7538617},
                  {"lat":35.7726461,
                   "lon":139.7538617},
                  {"lat":35.7726461,
                   "lon":139.7538617}]},
         {"routeID":"THB_1917a82d62b1193af960248981e439c1",
          "type":"3",
          "distance":2981,
          "toll":0,
          "time":8,
          "line":[{"lat":35.7920694,
                   "lon":139.7638769},
                  {"lat":35.7921092,
                   "lon":139.7638092},
                  {"lat":35.7921092,
                   "lon":139.7638092},
                  {"lat":35.7919922,
                   "lon":139.7636947},
                  {"lat":35.7919922,
                   "lon":139.7636947},
                  {"lat":35.7916869,
                   "lon":139.7634278},
                  {"lat":35.7916869,
                   "lon":139.7634278},
                  {"lat":35.7911378,
                   "lon":139.7629089},
                  {"lat":35.7911378,
                   "lon":139.7629089},
                  {"lat":35.7895203,
                   "lon":139.76136},
                  {"lat":35.7895203,
                   "lon":139.76136},
                  {"lat":35.7890167,
                   "lon":139.7608642},
                  {"lat":35.7890167,
                   "lon":139.7608642},
                  {"lat":35.7881672,
                   "lon":139.7600403},
                  {"lat":35.7881672,
                   "lon":139.7600403},
                  {"lat":35.7877808,
                   "lon":139.7596742},
                  {"lat":35.7877808,
                   "lon":139.7596742},
                  {"lat":35.7857258,
                   "lon":139.7576597},
                  {"lat":35.7857258,
                   "lon":139.7576597},
                  {"lat":35.7853597,
                   "lon":139.7572631},
                  {"lat":35.7853597,
                   "lon":139.7572631},
                  {"lat":35.7845256,
                   "lon":139.7564392},
                  {"lat":35.7845256,
                   "lon":139.7564392},
                  {"lat":35.7840983,
                   "lon":139.7559508},
                  {"lat":35.7840983,
                   "lon":139.7559508},
                  {"lat":35.7837117,
                   "lon":139.7553711},
                  {"lat":35.7837117,
                   "lon":139.7553711},
                  {"lat":35.7833047,
                   "lon":139.7543944},
                  {"lat":35.7833047,
                   "lon":139.7543944},
                  {"lat":35.7826333,
                   "lon":139.7515258},
                  {"lat":35.7826333,
                   "lon":139.7515258},
                  {"lat":35.7814736,
                   "lon":139.7507628},
                  {"lat":35.7814736,
                   "lon":139.7507628},
                  {"lat":35.7802122,
                   "lon":139.75},
                  {"lat":35.7802122,
                   "lon":139.75},
                  {"lat":35.7781983,
                   "lon":139.7487792},
                  {"lat":35.7781983,
                   "lon":139.7487792},
                  {"lat":35.7749633,
                   "lon":139.7499694},
                  {"lat":35.7749633,
                   "lon":139.7499694},
                  {"lat":35.7749431,
                   "lon":139.75},
                  {"lat":35.7749431,
                   "lon":139.75},
                  {"lat":35.77476,
                   "lon":139.7502442},
                  {"lat":35.77476,
                   "lon":139.7502442},
                  {"lat":35.7737581,
                   "lon":139.7519303},
                  {"lat":35.7737581,
                   "lon":139.7519303},
                  {"lat":35.7730356,
                   "lon":139.7532272},
                  {"lat":35.7730356,
                   "lon":139.7532272},
                  {"lat":35.7726461,
                   "lon":139.7538617},
                  {"lat":35.7726461,
                   "lon":139.7538617},
                  {"lat":35.7726461,
                   "lon":139.7538617}]},
         {"routeID":"THB_5b12913c0f41879a617e559ab33641b6",
          "type":"4",
          "distance":2951,
          "toll":0,
          "time":9,
          "line":[{"lat":35.7920694,
                   "lon":139.7638769},
                  {"lat":35.7921092,
                   "lon":139.7638092},
                  {"lat":35.7921092,
                   "lon":139.7638092},
                  {"lat":35.7919922,
                   "lon":139.7636947},
                  {"lat":35.7919922,
                   "lon":139.7636947},
                  {"lat":35.7916869,
                   "lon":139.7634278},
                  {"lat":35.7916869,
                   "lon":139.7634278},
                  {"lat":35.7911378,
                   "lon":139.7629089},
                  {"lat":35.7911378,
                   "lon":139.7629089},
                  {"lat":35.7895203,
                   "lon":139.76136},
                  {"lat":35.7895203,
                   "lon":139.76136},
                  {"lat":35.7890219,
                   "lon":139.7608642},
                  {"lat":35.7890219,
                   "lon":139.7608642},
                  {"lat":35.7881672,
                   "lon":139.7600403},
                  {"lat":35.7881672,
                   "lon":139.7600403},
                  {"lat":35.7877808,
                   "lon":139.7596742},
                  {"lat":35.7877808,
                   "lon":139.7596742},
                  {"lat":35.7857258,
                   "lon":139.7576597},
                  {"lat":35.7857258,
                   "lon":139.7576597},
                  {"lat":35.7853597,
                   "lon":139.7572631},
                  {"lat":35.7853597,
                   "lon":139.7572631},
                  {"lat":35.7845256,
                   "lon":139.7564392},
                  {"lat":35.7845256,
                   "lon":139.7564392},
                  {"lat":35.7840983,
                   "lon":139.7559508},
                  {"lat":35.7840983,
                   "lon":139.7559508},
                  {"lat":35.7837117,
                   "lon":139.7553711},
                  {"lat":35.7837117,
                   "lon":139.7553711},
                  {"lat":35.7832439,
                   "lon":139.7552489},
                  {"lat":35.7832439,
                   "lon":139.7552489},
                  {"lat":35.7825114,
                   "lon":139.7550658},
                  {"lat":35.7825114,
                   "lon":139.7550658},
                  {"lat":35.7819011,
                   "lon":139.7549133},
                  {"lat":35.7819011,
                   "lon":139.7549133},
                  {"lat":35.7807414,
                   "lon":139.7546081},
                  {"lat":35.7807414,
                   "lon":139.7546081},
                  {"lat":35.7777506,
                   "lon":139.7543944},
                  {"lat":35.7777506,
                   "lon":139.7543944},
                  {"lat":35.7766317,
                   "lon":139.7543333},
                  {"lat":35.7766317,
                   "lon":139.7543333},
                  {"lat":35.7754719,
                   "lon":139.7542725},
                  {"lat":35.7754719,
                   "lon":139.7542725},
                  {"lat":35.77535,
                   "lon":139.7542725},
                  {"lat":35.77535,
                   "lon":139.7542725},
                  {"lat":35.7754314,
                   "lon":139.7519531},
                  {"lat":35.7754314,
                   "lon":139.7519531},
                  {"lat":35.77476,
                   "lon":139.7502442},
                  {"lat":35.77476,
                   "lon":139.7502442},
                  {"lat":35.7737581,
                   "lon":139.7519303},
                  {"lat":35.7737581,
                   "lon":139.7519303},
                  {"lat":35.7730356,
                   "lon":139.7532272},
                  {"lat":35.7730356,
                   "lon":139.7532272},
                  {"lat":35.7726461,
                   "lon":139.7538617},
                  {"lat":35.7726461,
                   "lon":139.7538617},
                  {"lat":35.7726461,
                   "lon":139.7538617}]}]}

[ルート検索に失敗した例] ルート検索に失敗した場合には、itemの中身がnullとなります。

 

{"status":{"code":"0000",
           "text":""},
 "item":null}