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

API名: 
road_path_drive
概要: 
リクエストパラメータの緯度経度の点列から移動した経路を推定し、マッチした自動車用道路リンクデータを返却します。

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

URI: 

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

<API使用例>
http://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点まで複数点指定できます。
本項目は必須項目であるため、未指定の場合はエラーとなります。
priority   no_priority 路候補の優先度
同程度の可能性がある経路候補が複数ある場合、道路種別による優先度を指定します。
highway 高速道路及び都市高速道路を優先する
general 一般道路を優先する
no_priority どの道路種別にも優先度を指定しない
datum   TOKYO 測地系
返却される住所代表点の測地系を指定します。
initial_road_type   - 最初にマッチさせるリンクを指定の道路種別に限定します。
複数値指定可能。
指定なしの場合は全ての道路種別が対象になります。
クエリパラメータlatlonの初点付近に指定した道路種別がない場合は
結果無しとなります。

出力データ
出力フォーマット
{"status":"OK",
 "result":{"path":[{"inputPoint":[{"lat":35.6656758,
                                   "lon":139.7539458}],
                    "matchLink":{"code":"2xSAP9PRTwDLApg/8wKEPw==",
                                 "distance":48,
                                 "line":[35.6658528,139.7538528,35.6656189,139.7537383,35.6654714,139.75367,35.6654456,139.7536617],
                                 "order":"OE",
                                 "roadType":{"code":"6",
                                             "text":"一般道路(その他)"},
                                 "limitedHighway":false,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":true,
                                 "structure":"TUNNEL",
                                 "zlinkCode":"7998755"},
                    "connection":false},
                    ...]}}
キー名 データ型 説明
status     string ステータス情報が入ります。
OK 正常に検索が行われたことを示します。
 result     object マッチング結果が入ります。
マッチするリンクが存在しない場合はnullとなります。
  path   array マッチしたリンク情報の配列が入ります。
配列の順序は接続順となります。
    inputPoint array 当該リンクにマッチした入力緯度経度を配列で返却します。
マッチした点がない場合は空の配列となります。
    matchLink object マッチした道路リンク情報
    connection boolean 前のリンクと接続している場合にtrueとなります。
接続したリンクが取得できなかった場合はfalseとなり、新たなリンクが開始されます。

出力例

[通常出力例]

http://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
 
{"status":"OK",
 "result":{
"path":[{"inputPoint":[{"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":"都道府県道"},
                                 "limitedHighway":false,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":false,
                                 "structure":null,
                                 "zlinkCode":"786805"},
                    "connection":false},
                   {"inputPoint":[],
                    "matchLink":{"code":"2xSAP3fOTwBwAsY/ywKYPw==",
                                 "distance":68,
                                 "line":[35.6661375,139.755455,35.6663714,139.7547606],
                                 "order":"OE",
                                 "roadType":{"code":"4",
                                             "text":"都道府県道"},
                                 "limitedHighway":false,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":true,
                                 "structure":null,
                                 "zlinkCode":"786806"},
                    "connection":true},
                   {"inputPoint":[],
                    "matchLink":{"code":"2xSAP0jOTwAAAgBAcALGPw==",
                                 "distance":83,
                                 "line":[35.6663714,139.7547606,35.6666667,139.7539061],
                                 "order":"OE",
                                 "roadType":{"code":"4",
                                             "text":"都道府県道"},
                                 "limitedHighway":false,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":true,
                                 "structure":null,
                                 "zlinkCode":"786807"},
                    "connection":true},
                   {"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":"都道府県道"},
                                 "limitedHighway":false,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":true,
                                 "structure":null,
                                 "zlinkCode":"786808"},
                    "connection":true},
                   {"inputPoint":[],
                    "matchLink":{"code":"2xQAThHOTwBMAVcAyAEbAA==",
                                 "distance":92,
                                 "line":[35.6668039,139.7534789,35.6670072,139.7528381,35.6671092,139.7525328],
                                 "order":"OE",
                                 "roadType":{"code":"4",
                                             "text":"都道府県道"},
                                 "limitedHighway":false,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":true,
                                 "structure":null,
                                 "zlinkCode":"786809"},
                    "connection":true},
                   {"inputPoint":[],
                    "matchLink":{"code":"2xQATsf7QABMAVcATAFxAA==",
                                 "distance":14,
                                 "line":[35.6672414,139.7525328,35.6671092,139.7525328],
                                 "order":"EO",
                                 "roadType":{"code":"2",
                                             "text":"国道"},
                                 "limitedHighway":false,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":true,
                                 "structure":null,
                                 "zlinkCode":"786810"},
                    "connection":true},
                   {"inputPoint":[{"lat":35.6677181,
                                   "lon":139.7529475}],
                    "matchLink":{"code":"2xQATrH7QABMAXEAbgHgAA==",
                                 "distance":66,
                                 "line":[35.6672414,139.7525328,35.6678058,139.7527922],
                                 "order":"OE",
                                 "roadType":{"code":"2",
                                             "text":"国道"},
                                 "limitedHighway":false,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":true,
                                 "structure":null,
                                 "zlinkCode":"786811"},
                    "connection":true},
                   {"inputPoint":[],
                    "matchLink":{"code":"2xQATtL7QABuAeAAiwFLAQ==",
                                 "distance":63,
                                 "line":[35.6678058,139.7527922,35.66835,139.7530133],
                                 "order":"OE",
                                 "roadType":{"code":"2",
                                             "text":"国道"},
                                 "limitedHighway":false,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":true,
                                 "structure":null,
                                 "zlinkCode":"786812"},
                    "connection":true}]}}