自動車ルート候補一覧取得

API名: 
route3/drive_list
概要: 

緯度経度から自動車の経路候補を取得します

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

URI: 

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

<APIサービス利用例>
いつもNAVI ラボ 大型車ルート検索

<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 - 到着地点
検索するルートの到着地点を緯度経度で指定します。
本項目は必須項目であるため、未指定の場合はエラーとなります。
mpoints   - 経由地点
検索するルートの経由地点を緯度経度で指定します。
最大20点まで複数値指定できます。
fromtype   general 出発・到着地点引き込みタイプ
出発・到着地点の引き込みタイプを指定します。
指定値 説明
general 一般道路に引き込みます
highway 高速道路に引き込みます
all 全ての道路に引き込みます
totype   general
mpointstype   全て
general
経由地点引き込みタイプ
経由地点の引き込みタイプを複数値で指定します。
本パラメータを指定した場合は、その指定個数とクエリパラメータmpointsの経由地点数が一致する必要があります。
指定値 説明
general 一般道路に引き込みます
highway 高速道路に引き込みます
all 全ての道路に引き込みます
datum   TOKYO 測地系
入出力緯度経度の測地系を指定します。
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   - 出発時刻指定
出発時刻を日時で指定します。
渋滞統計情報(statistics)または規制考慮(regulation)に対して、時刻を考慮した経路探索を行うために使用します。
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ターンを行うルートを回避します。
※本機能を利用する場合には別途契約が必要です。
※本機能は開発中の機能です。
ferry   T フェリー考慮指定
フェリーを利用するかどうかを真偽値で指定します。
なお、F指定にした場合でもフェリーを利用しないと到達不可能な場合はフェリー航路を含む結果が返却されます。
指定値 説明
T フェリーを利用する
F フェリーを利用しない
useline   T 道路形状点列データ出力指定
出力データに含まれる道路形状の点列の出力を真偽値で制御します。
指定値 説明
T 出力パラメータlineを出力します。
F 出力パラメータlineの出力を省略(nullを出力)し、データ量を削減します。
出力データ
出力フォーマット
{"status":{"code": "0000",
            "text": ""},
 "item":[{"routeID":"THB_51cd3ca8ec05772732c40d7ada9c4da1",
          "type":"0",
          "distance":552,
          "toll":0,
          "invalidFee":false,
          "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 正常終了
  text string ステータス内容に関するテキスト情報が入ります。
item   array ルート検索結果一覧が入ります。
  routeID string ルートIDが入ります。 ルートの詳細情報を取得するのに使用します。
なお、この値は取得後24時間まで有効となります。
  type string 検索タイプが入ります。
0 推奨ルート
1 一般道優先
2 道幅優先
3 距離優先
4 別ルート優先
  distance number 経路の大まかな距離(メートル)が入ります。
  toll number トータルの料金(円)が入ります。
経路結果に新規開通などで料金が反映されていない区間が含まれており、一部料金が取得できない場合はトータル料金として0が入ります。
  invalidFee boolean 料金が無効値であったかどうかを示すフラグが入ります。
料金無効値は、経路結果に新規開通などで料金が反映されていない区間が含まれている場合に発生します。
T 料金無効値である
F 料金無効値でない
  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,
          "invalidFee":false,
          "time":8,
          "line":[{"lat":35.7920694,"lon":139.7638769},
                  {"lat":35.7921092,"lon":139.7638092},
                  {"lat":35.7919922,"lon":139.7636947},
                  {"lat":35.7916869,"lon":139.7634278},
                  ...省略,
                  {"lat":35.7726461,"lon":139.7538617},
                  {"lat":35.7726461,"lon":139.7538617}]},
         {"routeID":"THB_2fa9f38dc6f625ef3d21e834be5313c0",
          "type":"1",
          "distance":2981,
          "toll":0,
          "invalidFee":false,
          "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.7726461,"lon":139.7538617},
                  {"lat":35.7726461,"lon":139.7538617}]},
         {"routeID":"THB_3c8b55d6a40b0623a85564a605941fbb",
          "type":"2",
          "distance":2978,
          "toll":930,
          "invalidFee":false,
          "time":7,
          "line":[{"lat":35.7920694,"lon":139.7638769},
                  ...省略
                  {"lat":35.7726461,"lon":139.7538617}]},
         {"routeID":"THB_1917a82d62b1193af960248981e439c1",
          "type":"3",
          "distance":2981,
          "toll":0,
          "invalidFee":false,
          "time":8,
          "line":[{"lat":35.7920694,"lon":139.7638769},
                  ...省略
                  {"lat":35.7726461,"lon":139.7538617}]},
         {"routeID":"THB_5b12913c0f41879a617e559ab33641b6",
          "type":"4",
          "distance":2951,
          "toll":0,
          "invalidFee":false,
          "time":9,
          "line":[{"lat":35.7920694,"lon":139.7638769},
                  ...省略
                  {"lat":35.7726461,"lon":139.7538617}]}]}

[道路形状データを省略した場合]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/route3/drive_list? if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip
&
from=35.6778128%2C139.7703875&to=35.62560028%2C139.74103528 &mpoints=&tolltype=normal&smartic=F&departuretime=&vics=F&useline=F

{"status":{"code":"0000",
            "text":""},
 "item":[{"routeID":"THB_a0ba0143f62769ac89fbbae280b54da1",
          "type":"0",
          "distance":8240,
          "toll":0,
          "invalidFee":false,
          "time":23,
          "line":null},
         {"routeID":"THB_65632025b8bd86e5b0242a21db4f9a6f",
          "type":"1",
          "distance":8240,
          "toll":0,
          "invalidFee":false,
          "time":23,
          "line":null},
         {"routeID":"THB_8ac0b2ed8c173dd71362ac7001191940",
          "type":"2",
          "distance":7864,
          "toll":0,
          "invalidFee":false,
          "time":25,
          "line":null},
         {"routeID":"THB_9355ea309c1348b6c378ed846e2837bb",
          "type":"3",
          "distance":7864,
          "toll":0,
          "invalidFee":false,
          "time":25,
          "line":null},
         {"routeID":"THB_55d39be0e7b025e54aa7af447b000858",
          "type":"4",
          "distance":8102,
          "toll":0,
          "invalidFee":false,
          "time":25,
          "line":null}]}

[ルート検索に失敗した例] ルート検索に失敗した場合には、itemの中身がnullとなります。
from,toの直線距離が50m以下の時はルート検索に失敗します。

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