ルートマッチング(自動車)

API名:

road_path_drive

概要:

リクエストパラメータの緯度経度の点列から移動した経路を推定し、マッチした自動車用道路リンクデータを返却します。
いつもNAVI API3.0 で使用している株式会社ゼンリンの地図データについて

※この機能を利用するには別途契約が必要です。

URI:

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

<API使用例>
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/road_path_drive?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.666039167,139.755790556,35.666779167,139.753732222,35.667718056,139.7529475

リクエストパラメータ

パラメータ

必須

デフォルト値

説明

latlon

○

緯度経度の指定
最大100点まで複数点指定できます。
本項目は必須項目であるため、未指定の場合はエラーとなります。
点指定の適切な間隔の目安は40～50mです。点列間が離れすぎてしまうと誤マッチの原因となります。

GPSのエラー等により点がずれると、正しくマッチングされない可能性があります。

priority

no_priority

経路候補の優先度
経路候補が複数ある場合、道路種別による優先度を指定します。

指定値	説明
highway	高速道路及び都市高速道路を優先する
general	一般道路を優先する
no_priority	どの道路種別にも優先度を指定しない

initial_road_type

道路種別限定
最初にマッチさせるリンクを指定の道路種別に限定します。
複数値指定できます。
指定なしの場合は全ての道路種別が対象になります。
クエリパラメータlatlonの初点付近に指定した道路種別がない場合、結果無しとなります。

adasinfo

ADAS情報
ADAS情報を取得するかどうかを真偽値で指定します。
※本パラメータを利用するには別途契約が必要です。

指定値	説明
T	adasを出力する
F	adasを出力しない

road_elevation_info

道路標高情報
道路標高情報を取得するかどうかを真偽値で指定します。
ADAS情報が無い場合、標高情報は出力されません。
本パラメータをT指定した場合、ADAS情報オブジェクト内に道路標高情報オブジェクトを出力します。
adasinfoがF指定の場合、本パラメータは無効となります。
※本パラメータを利用するには別途契約が必要です。 　　　　　　　　　　　　　　　　　　

指定値	説明
T	adas->elevationinfoを出力する ※出力結果のデータ量が増加します。ご留意ください。
F	adas->elevationinfoを出力しない

datum

TOKYO

測地系
入出力緯度経度の測地系を指定します。

llunit

dec

緯度経度形式
緯度経度形式を指定します。

出力データ

出力フォーマット

{"status":"OK",
"result":{"path":[{"inputPoint":[{"lat":35.6656758,
"lon":139.7539458}],
"matchLink":{"code":"2xSAP9PRTwDLApg/8wKEPw==",
"distance":48,
"line":[35.6658528,139.7538528,...,35.6654456,139.7536617],
"order":"OE",
"roadType":{"code":"6",
"text":"一般道路(その他)"},
"linkType":{"code":"2",
"text":"本線(上下線分離)リンク"},
"limitedHighway":false,
"numberOfLanes":2,
"roadWidth":2,
"linkSeparation":true,
"structure":"TUNNEL",
"zlinkCode":"7998755",
"generalRoadName1":null,
"generalRoadName2":null,
"officialRoadName":null,
"popularRoadName1":null,
"adas":{"stopInfo":[{"type":0,
"distance":4800}, ...],
"maxspeed":[{"limit":30,
"start":0,
"end" :100}, ...],
"accidentPoint":{"type":point,
"position":{35.6654456,139.7536617}},
"limitinfo":{"height":null,
"width":null,
"weight":14000},
"directionSign":"8194",
"roadelevation": [{"lat": 35.419725833333,
"lon": 139.38639944444,
"elevation": 21315},...]},
"highwayInfo":{"pointType":{"JCT":true,
"SAPA":false,
"IC":false,
"smartIC":false},
"pointName":"海老名"},
"meshCode2":"502903":,
"tollRoad":false},
"connection":false,
"matchPoint":[{"lat":35.419528,
"lon":139.3855571}]}
"edgeDistance":[{"start":3.1,
"end":2.3}]}}

キー名

データ型

説明

status

string

検索結果ステータスが入ります。

OK	正常に検索が行われたことを示します。

result

object

マッチング結果が入ります。
マッチするリンクが存在しない場合はnullとなります。

path

array

マッチしたリンク情報の配列が入ります。
配列の順序は接続順となります。

inputPoint

array

当該リンクにマッチした入力緯度経度を配列で返却します。
マッチした点がない場合は空の配列となります。
※内部的に変換され、誤差が生じるため、入力緯度経度と完全一致はしません。

matchLink

object

マッチした道路リンク情報のオブジェクトが入ります。

code

string

リンクIDが入ります。

distance

number

リンク距離(単位:m)が入ります。

line

array

リンク形状座標が入ります。

order

string

リンク形状座標の格納順序(進行方向)をあらわすコードが入ります。

OE	順方向
EO	逆方向

roadType

object

道路種別のオブジェクトが入ります。

code

string

種別コードが入ります。

text

string

種別名称が入ります。

linkType

object

ゼンリン道路ネットワークデータと合わせて使用する値です。本APIではサポート対象外の項目になります。

code

string

ゼンリン道路ネットワークデータと合わせて使用する値です。本APIではサポート対象外の項目になります。

text

string

ゼンリン道路ネットワークデータと合わせて使用する値です。本APIではサポート対象外の項目になります。

limitedHighway

boolean

自動車専用道路フラグが入ります。
不明の場合はnullが入ります。

true	自動車専用道路
false	自動車専用道路ではない

numberOfLanes

number

そのリンクに含まれる車線数が入ります。
上下線分離したリンクの場合、片側だけの車線が入ります。
分離していないリンクの場合、両側合計の車線が入ります。
不明の場合はnullが入ります。

1	1車線
2	2車線または3車線
4	4車線以上

roadWidth

number

道路幅員が入ります。
不明の場合はnullが入ります。

0	幅員3.0m未満
1	幅員3.0m以上5.5m未満
2	幅員5.5m以上13.0m未満
3	幅員13.0m以上

linkSeparation

boolean

上下線分離フラグが入ります。

true	上下線分離して上り/下りが別々のリンク列である
false	上下線分離せず上り/下りが一つのリンク列である

structure

string

リンクの構造情報が入ります。
データなしの場合はnullが入ります。

TUNNEL

トンネルである

zlinkCode

string

ZリンクIDが入ります。

generalRoadName1

string

道路一般名称1が入ります。
不明の場合はnullとなります。

generalRoadName2

string

道路一般名称2が入ります。
不明の場合はnullとなります。

officialRoadName

string

道路正式名称が入ります。
不明の場合はnullとなります。

popularRoadName

string

道路通称名称が入ります。
不明の場合はnullとなります。

adas

object

ADAS情報オブジェクトが入ります。
情報がない場合はnullとなります。

stopInfo

array

当該地点の一時停止情報が入ります。

type

number

当該地点の一時停止線の種別が入ります。

0	一時停止線有り（現実世界にあり）
1	仮想一時停止線（現実世界になし）

distance

number

一時停止位置までの距離が入ります。(単位:cm)
図説もあわせてご確認ください。

maxspeed

array

最高速度情報が入ります。

limit

number

区間開始位置～区間終了位置に適用する最高速度が入ります。(単位:Km/h)

start

number

区間割合相対開始位置が入ります。(単位:%)
区間割合相対開始位置とはリンクの全長を100%とした時のlimitの開始位置です。

end

number

区間割合相対終了位置が入ります。(単位:%)
区間割合相対終了位置とはリンクの全長を100%とした時のlimitの終了位置です。

accidentPoint

object

事故地点情報が入ります。

type

string

事故地点情報の種別が入ります。

point	地点型
linestring	区間型

position

object

typeがpointの場合は緯度経度が入ります。
linestringの場合はnullが入ります。

limitinfo

object

各制限情報が入ります。

height

number

高さ制限情報が入ります。(単位:cm)

width

number

幅制限情報が入ります。(単位:cm)

weight

number

重量制限情報が入ります。(単位:kg)

directionSign

string

大型車の指定方向外進行禁止標識情報が入ります。
進行禁止は、当該リンクから退出する時の標識コードです。
通行止めは、当該リンク自体が通行止めかどうかを認識するためのコードです。

8193	指定方向外進行禁止その他
8194	指定方向外進行禁止直進
8195	指定方向外進行禁止左折
8196	指定方向外進行禁止直進+左折
8197	指定方向外進行禁止直線+右折
8198	指定方向外進行禁止右折
8199	指定方向外進行禁止右左折
12288	車両通行止め
12289	大型乗用自動車等通行止め
12290	大型貨物自動車等通行止め
12291	車両(組み合わせ)通行止め

roadelevation

object

道路標高情報オブジェクトが配列で入ります。

lat

number

道路標高情報の地点緯度が入ります。

lon

number

道路標高情報の地点経度が入ります。

elevation

number

道路標高が入ります。(単位:mm)

highwayInfo

object

高速道路情報オブジェクトが入ります。
情報がない場合(高速以外の道路、高速でIC/JCT/SAPAでないリンク)
はnullとなります。

pointType

object

当該地点の施設種別情報が入ります。

JCT

boolean

当該地点がJCTであるかを
真偽値で表します。

SAPA

boolean

当該地点がSA/PAであるかを
真偽値で表します。

boolean

当該地点がICであるかを
真偽値で表します。

smartIC

boolean

当該地点がsmartICであるかを
真偽値で表します。

pointName

string

地点の名称が入ります。

meshCode2

string

リンク位置の２次メッシュコードが入ります。

tollRoad

boolean

当該リンクが有料道路かを真偽値で表します。

connection

boolean

前のリンクと接続しているかを真偽値で表します。

true	前のリンクと接続している
false	接続したリンクが取得できない falseの場合、新たなリンクが開始されます。

matchPoint

array

当該リンクのinputPointに対応したリンク上の最寄り点の緯度経度を配列で返却します。

edgeDistance

array

マッチングした経路の開始、終了位置からマッチした点までの距離が入ります。
経路が複数となった(path途中にconnection:falseがある)場合、対応する複数結果になります。

start

number

経路の開始位置から、最初のmatchPointの位置までの距離(単位:m)が入ります。

end

number

最後のmatchPointの位置から、経路の終了位置までの距離(単位:m)が入ります。

出力例

[一般道路上]

https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/road_path_drive?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
latlon=35.665831366,139.755645956,35.666039167,139.755790556,35.666779167,139.753732222

{"status":"OK",
"result":{"path":[{"inputPoint":[{"lat":35.6658314,"lon":139.7556458},
{"lat":35.6660392,"lon":139.7557906}],
"matchLink":{"code":"2xSAP9PRTwDLApg/8wKEPw==",
"distance":29,
"line":[35.6660358,139.75576,35.6661375,139.755455],
"order":"OE",
"roadType":{"code":"4",
"text":"都道府県道"},
"linkType":{"code":"2",
"text":"本線(上下線分離)リンク"},
"limitedHighway":false,
"numberOfLanes":2,
"roadWidth":2,
"linkSeparation":false,
"structure":null,
"zlinkCode":"788572",
"generalRoadName1":null,
"generalRoadName2":null,
"officialRoadName":null,
"popularRoadName1":null,
"adas":null,
"highwayInfo":null,
"meshCode2":"533936",
"tollRoad":false},
"connection":false,
"matchPoint"[{"lat":35.6660497,
"lon":139.7557186},
{"lat":35.6660358,
"lon":139.75576}]},
{"inputPoint":[],
"matchLink":{"code":"2xSAP3fOTwBwAsY/ywKYPw==",
"distance":68,
"line":[35.6661375,139.755455,35.6663714,139.7547606],
"order":"OE",
"roadType":{"code":"4",
"text":"都道府県道"},
"linkType":{"code":"2",
"text":"本線(上下線分離)リンク"},
"limitedHighway":false,
"numberOfLanes":2,
"roadWidth":2,
"linkSeparation":true,
"structure":null,
"zlinkCode":"788573",
"generalRoadName1":null,
"generalRoadName2":null,
"officialRoadName":null,
"popularRoadName1":null,
"adas":null,
"highwayInfo":null,
"meshCode2":"533936",
"tollRoad":false},
"connection":true,
"matchPoint"[]},
{"inputPoint":[],
"matchLink":{"code":"2xSAP0jOTwAAAgBAcALGPw==",
"distance":83,
"line":[35.6663714,139.7547606,35.6666667,139.7539061],
"order":"OE",
"roadType":{"code":"4",
"text":"都道府県道"},
"linkType":{"code":"2",
"text":"本線(上下線分離)リンク"},
"limitedHighway":false,
"numberOfLanes":2,
"roadWidth":2,
"linkSeparation":true,
"structure":null,
"zlinkCode":"786807",
"generalRoadName1":null,
"generalRoadName2":null,
"officialRoadName":null,
"popularRoadName1":null,
"adas":null,
"highwayInfo":null,
"meshCode2":"533936",
"tollRoad":false},
"connection":true,
"matchPoint"[]},
{"inputPoint":[{"lat":35.6667792,
"lon":139.7537322}],
"matchLink":{"code":"2xQATkDOTwDIARsAAAIAAA==",
"distance":41,
"line":[35.6666667,139.7539061,35.6668039,139.7534789],
"order":"OE",
"roadType":{"code":"4",
"text":"都道府県道"},
"linkType":{"code":"2",
"text":"本線(上下線分離)リンク"},
"limitedHighway":false,
"numberOfLanes":2,
"roadWidth":2,
"linkSeparation":true,
"structure":null,
"zlinkCode":"786808",
"generalRoadName1":null,
"generalRoadName2":null,
"officialRoadName":null,
"popularRoadName1":null,
"adas":null,
"highwayInfo":null,
"meshCode2":"533936",
"tollRoad":false},
"connection":true,
"matchPoint"[{"lat":35.6667278,
"lon":139.7537158}]},
{"inputPoint":[],
"matchLink":{"code":"2xQAThHOTwBMAVcAyAEbAA==",
"distance":92,
"line":[35.6668039,139.7534789,...,35.6671092,139.7525328],
"order":"OE",
"roadType":{"code":"4",
"text":"都道府県道"},
"linkType":{"code":"2",
"text":"本線(上下線分離)リンク"},
"limitedHighway":false,
"numberOfLanes":2,
"roadWidth":2,
"linkSeparation":true,
"structure":null,
"zlinkCode":"786809",
"generalRoadName1":null,
"generalRoadName2":null,
"officialRoadName":null,
"popularRoadName1":null,
"adas":null,
"highwayInfo":null,
"meshCode2":"533936",
"tollRoad":false},
"connection":true,
"matchPoint"[{"lat":35.6660497,
"lon":139.7557186},
{"lat":35.6660358,
"edgeDistance":[{"start":69,
"end":27}]}}

[高速道路上]

https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/road_path_drive?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
latlon=35.419600691,139.385651112,35.4190531,139.3814558

{"status":"OK",
"result":{"path":[{"inputPoint":[{"lat":35.4196006,"lon":139.3856511}],
"matchLink":{"code":"2xQAGKi/IQBXBToC1gVZAg==",
"distance":89,
"line":[35.4197233, 139.3863981,35.4195658,139.3854292],
"order":"OE",
"roadType":{"code":"0",
"text":"高速道路"},
"linkType":{"code":"2",
"text":"本線(上下線分離)リンク"},
"limitedHighway":true,
"numberOfLanes":2,
"roadWidth":2,
"linkSeparation":true,
"structure":null,
"zlinkCode":"13094",
"generalRoadName1":null,
"generalRoadName2":null,
"officialRoadName":null,
"popularRoadName1":null,
"adas":null,
"highwayInfo":{"pointType":{"JCT":true,
"SAPA":false,
"IC":false,
"smartIC":false},
"pointName":"海老名"},
"meshCode2":"533936",
"tollRoad":false},
"connection":false,
"matchPoint"[{"lat":35.6660497,
"lon":139.7557186},
{"lat":35.6660358,
"lon":139.75576}]},},
{"inputPoint":[{"lat":35.4190531,"lon":139.3814558}],
"matchLink":{"code":"2xQAGC9sVwEmA+gBVwU6Ag==",
"distance":391,
"line":[35.4195658,139.3854292,...,35.4191486,139.3811492],
"order":"OE",
"roadType":{"code":"0",
"text":"高速道路"},
"linkType":{"code":"2",
"text":"本線(上下線分離)リンク"},
"limitedHighway":true,
"numberOfLanes":2,
"roadWidth":2,
"linkSeparation":true,
"structure":null,
"zlinkCode":"13095",
"generalRoadName1":null,
"generalRoadName2":null,
"officialRoadName":null,
"popularRoadName1":null,
"adas":null,
"highwayInfo":null,
"meshCode2":"533936",
"tollRoad":false},
"connection":true,
"matchPoint"[{"lat":35.6660497,
"lon":139.7557186},
{"lat":35.6660358,
"lon":139.75576}]}],
"edgeDistance":[{"start":4,
"end":23}]}}

[ADAS情報表示例]

https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/road_path_drive?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
latlon=35.419600691,139.385651112,35.4190531,139.3814558&priority=highway&adasinfo=T&road_elevation_info=T

{"status":"OK",
"result":{"path":[{"inputPoint":[{"lat":35.4196006,
"lon":139.3856511}],
"matchLink":{"code":"2xQAGKi/IQBXBToC1gVZAg==",
"distance":89,
"line":[35.4197233,139.3863981,
35.4195658,139.3854292],
"order":"OE",
"roadType":{"code":"0",
"text":"高速道路"},
"linkType":{"code":"2",
"text":"本線（上下線分離）リンク"},
"limitedHighway":true,
"numberOfLanes":2,
"roadWidth":2,
"linkSeparation":true,
"structure":null,
"zlinkCode":"13098",
"generalRoadName1": "環二通り",
"generalRoadName2": "環二通り",
"officialRoadName": "環二通り",
"popularRoadName": "環二通り",
"adas": {"stopInfo": [{"type": 0,
"distance": 4800}, ...],
"maxspeed": [{"limit": 30,
"start": 0,
"end": 100,},...],
"accidentPoint":{"type":point,
"position": Point},
"limitinfo": {"height": null,
"width": null,
"weight":14000},
"directionSign": "8194",
"roadelevation": [{"lat": 35.419725833333,
"lon": 139.38639944444,
"elevation": 21315}, ...]},
"highwayInfo":null,
"meshCode2":"533913",
"tollRoad":true},
"connection":false,
"matchPoint":[{"lat":35.4196019,
"lon":139.3856508}]},
{"inputPoint":[{"lat":35.4190531,
"lon":139.3814558}],
"matchLink":{"code":"2xQAGC9sVwEmA+gBVwU6Ag==",
"distance":391,
"line":[35.4195658,139.3854292,
35.4194639,139.3847119,
35.4193622,139.3840025,
35.4192758,139.3830794,
35.4192197,139.3823547,
35.4191842,139.3817519,
35.4191486,139.3811492],
"order":"OE",
"roadType":{"code":"0",
"text":"高速道路"},
"linkType":{"code":"2",
"text":"本線（上下線分離）リンク"},
"limitedHighway":true,
"numberOfLanes":2,
"roadWidth":2,
"linkSeparation":true,
"structure":null,
"zlinkCode":"13099",
"generalRoadName1": "環二通り",
"generalRoadName2": "環二通り",
"officialRoadName": "環二通り",
"popularRoadName": "環二通り",
"adas":null,
"highwayInfo":null,
"meshCode2":"533913",
"tollRoad":true},
"connection":true,
"matchPoint":[{"lat":35.4191664,
"lon":139.3814492}]}],
"edgeDistance":[{"start":69,
"end":27}]}}