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

API名: 
road_path_drive
概要: 

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

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

URI: 

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

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

<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   F ADAS情報
ADAS情報を取得するかどうかを真偽値で指定します。
※本パラメータを利用するには別途契約が必要です。
指定値 説明
T adasを出力する
F adasを出力しない
road_elevation_info   F 道路標高情報
道路標高情報を取得するかどうかを真偽値で指定します。
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   object 当該地点の一時停止情報が入ります。
          type number 当該地点の一時停止線の種別が入ります。
0 一時停止線有り（現実世界にあり）
1 仮想一時停止線（現実世界になし）
          distance number 一時停止位置までの距離が入ります。(単位:cm)
図説もあわせてご確認ください。
        maxspeed   object 最高速度情報が入ります。
          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であるかを
真偽値で表します。
          IC 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}]}}