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

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

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

URI: 

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

<APIサービス利用例>
いつもNAVI ラボ ルートマッチング(自動車)

<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.6654456,139.7536617],
                                 "order":"OE",
                                 "roadType":{"code":"6",
                                             "text":"一般道路(その他)"},
                                 "limitedHighway":false,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":true,
                                 "structure":"TUNNEL",
                                 "zlinkCode":"7998755",
                                 "highwayInfo":{"pointType":{"JCT":true,
                                                             "SAPA":false,
                                                             "IC":false,
                                                             "smartIC":false},
                                                "pointName":"海老名"}},
                    "connection":false},
                    ...]}}
キー名 datatype 説明
status           string 検索結果ステータス
OK 正常に検索が行われたことを示します。
result           object マッチング結果が入ります。
マッチするリンクが存在しない場合はnullとなります。
  path         array マッチしたリンク情報の配列が入ります。
配列の順序は接続順となります。
    inputPoint       array 当該リンクにマッチした入力緯度経度を配列で返却します。
マッチした点がない場合は空の配列となります。
    matchLink       object マッチした道路リンク情報のオブジェクト
      code     string リンクID
      distance     number リンク距離(メートル)
      line     array リンク形状座標
      order     string リンク形状座標の格納順序(進行方向)をあらわすコード
OE 順方向
EO 逆方向
      roadType     object 道路種別のオブジェクト
        code   string 種別コード
        text   string 種別名称
      limitedHighway     boolean 自動車専用道路フラグ。不明の場合nullが入ります。
true 自動車専用道路
false 自動車専用道路ではない
      numberOfLanes     number そのリンクに含まれる車線数(上下線分離したリンクの場合、片側だけの車線、分離していないリンクの場合、両側合計の車線)
不明の場合nullが入ります。
1 1車線
2 2車線
3 3車線
4 4車線
5 5車線以上
      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
      highwayInfo     object 高速道路情報オブジェクト
情報がない場合(高速以外の道路、高速でIC/JCT/SAPAでないリンク)はnullとなります。
        pointType   object 当該地点の施設種別情報
          JCT boolean 当該地点がJCTであるかを真偽値で表します。
          SAPA boolean 当該地点がSA/PAであるかを真偽値で表します。
          IC boolean 当該地点がICであるかを真偽値で表します。
          smartIC boolean 当該地点がsmartICであるかを真偽値で表します。
        pointName   string 地点の名称
    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",
                                 "highwayInfo":null},
                    "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",
                                 "highwayInfo":null},
                    "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",
                                 "highwayInfo":null},
                    "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",
                                 "highwayInfo":null},
                    "connection":true},
                   {"inputPoint":[],
                    "matchLink":{"code":"2xQAThHOTwBMAVcAyAEbAA==",
                                 "distance":92,
                                 "line":[35.6668039,139.7534789,...,35.6671092,139.7525328],
                                 "order":"OE",
                                 "roadType":{"code":"4",
                                             "text":"都道府県道"},
                                 "limitedHighway":false,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":true,
                                 "structure":null,
                                 "zlinkCode":"786809",
                                 "highwayInfo":null},
                    "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",
                                 "highwayInfo":null},
                    "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",
                                 "highwayInfo":null},
                    "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",
                                 "highwayInfo":null},
                    "connection":true}]}}

[高速道路上]

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.4195258,"lon":139.3855592}],
                    "matchLink":{"code":"2xQAGKi/IQBXBToC1gVZAg==",
                                 "distance":89,
                                 "line":[35.4197233, 139.3863981,35.4195658,139.3854292],
                                 "order":"OE",
                                 "roadType":{"code":"0",
                                             "text":"高速道路"},
                                 "limitedHighway":true,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":true,
                                 "structure":null,
                                 "zlinkCode":"13094",
                                 "highwayInfo":{"pointType":{"JCT":true,
                                                             "SAPA":false,
                                                             "IC":false,
                                                             "smartIC":false},
                                                "pointName":"海老名"}},
                                 "connection":false},
                   {"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":"高速道路"},
                                 "limitedHighway":true,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":true,
                                 "structure":null,
                                 "zlinkCode":"13095",
                                 "highwayInfo":null},
                                 "connection":true}]}}