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

API名: 
route3/drive_list
概要: 

緯度経度から自動車の経路候補を取得します。取得した各ルートは、そのルートIDを自動車ルート検索にて指定することで更に詳細情報を取得できます。

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

URI: 

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

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

<API使用例>
https://test.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

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
searchparam   0 検索挙動変更
ルート検索の挙動を変更します。
自動車ルート検索を使用する場合は、指定値を一致させてください。
searchparam=1とsearchparam=0を違えた場合はエラーまたは誤った値が返却される場合があります。
指定値 説明
0 横付け考慮無し
ルート所要時間計算: 旧来からの値
1 ※推奨
横付け考慮あり
ルート所要時間計算: 最適化した値
旧来値:0 に比べ同じ経路でのルート所要時間は平均的に短時間に計算されます。
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 普通乗用自動車
E 準中型乗用自動車
F 中型貨物自動車
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を出力)し、データ量を削減します。
tollTBD   F 通行料金未提供区間制御フラグ
料金情報が反映されていない道路を通るかどうかを指定します。
T指定した場合、料金情報が提供されていない道路を回避します。
※目的地までの通行可能なルートがない場合、通行料金未提供の道路を含むルートを返却します。
avoidarea   - 矩形エリア回避
ルート検索時に迂回するエリアを緯度経度矩形範囲で指定します。
10件まで複数指定可能です。
10kmを超える矩形が指定された場合、エラーとなります。
国外の緯度経度を含む矩形が指定された場合、回避対象から除外してルート検索を行います。
※該当エリアを通過しないとルートが作成できない場合、該当エリアを迂回せず通過するルートが作成されます。
緯度経度形式で指定した値と異なる形式の緯度経度を指定した場合、動作保証対象外です。
出力データ
出力フォーマット
{"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}],
          "vicsTimeStamp":"202005151735"}, ....]}
キー名 データ型 説明
status   object ステータス情報が入ります。
  code string ステータスコードが入ります。
0000 正常終了
※出発地点・経由地点・到着地点のいずれかに国外の緯度経度を指定してルート検索に失敗した場合にも同じ値が入ります。
1404 出発地点の検索に失敗した場合
1405 経由地点・到着地点の検索に失敗した場合
1406/1407 出発地点・経由地点・到着地点間をつなぐルートの作成に失敗した場合
1501 出発地点・到着地点間の距離が近すぎる場合(※50m以内)
  text string 常に空が入ります。
item   array ルート検索結果一覧が入ります。
  routeID string ルートIDが入ります。 ルートの詳細情報を取得するのに使用します。
なお、この値は取得後24時間まで有効となります。
  type string 検索タイプが入ります。
0 推奨ルート
1 一般道優先
2 道幅優先
3 距離優先
4 別ルート優先
  distance number 経路の大まかな距離(メートル)が入ります。
  toll number トータルの料金(円)が入ります。
経路結果に新規開通などで料金が反映されていない区間が含まれており、
一部料金が取得できない場合はトータル料金として0が入ります。
  invalidFee boolean 料金が無効値であったかどうかを示すフラグが入ります。
料金無効値は、経路結果に新規開通などで料金が反映されていない
区間が含まれている場合に発生します。
true 料金無効値である
false 料金無効値でない
  time int トータルの時間(分)が入ります。
  line array 経路の大まかな形状が入ります。
  vicsTimeStamp string VICS情報のタイムスタンプ(YYYYMMDDhhmm)が入ります。
以下に当てはまる場合、nullが入ります。
・VICS情報を加味した検索を行わない場合
・VICS情報がない区間で検索した場合
・VICS情報の取得に失敗した場合
出力例

[通常出力例]
https://test.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&smartic=T

{"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}],
          "vicsTimeStamp":"202005151735"},
         {"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}],
          "vicsTimeStamp":"202005151735"},
         {"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}],
          "vicsTimeStamp":"202005151735"},
         {"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}],
          "vicsTimeStamp":"202005151735"},
         {"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}],
          "vicsTimeStamp":"202005151735"}]}

[道路形状データを省略した場合]
https://test.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&useline=F

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

[ルート検索に失敗した例]
ルート検索に失敗した場合には、返却値itemがnullとなります。
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/route3/drive_list?
if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
from=35.473918913,139.152131508&to=35.480325169,139.216727924

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