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

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":"一般道路(その他)"},
                                 "linkType":{"code":"2",
                                             "text":"本線(上下線分離)リンク"},
                                 "limitedHighway":false,
                                 "numberOfLanes":2,
                                 "roadWidth":2,
                                 "linkSeparation":true,
                                 "structure":"TUNNEL",
                                 "zlinkCode":"7998755",
                                 "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}]}}
キー名 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 種別名称が入ります。
      linkType     object 出力されますが使用できません。
        code   string 出力されますが使用できません。
        text   string 出力されますが使用できません。
      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が入ります。
      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 リンク位置の2次メッシュコードが入ります。
      tollRoad     boolean 当該リンクが有料道路かを真偽値で表します。
    connection       boolean 前のリンクと接続しているかを真偽値で表します。
true 前のリンクと接続している
false 接続したリンクが取得できない
falseの場合、新たなリンクが開始されます。
    matchPoint       array 当該リンクのinputPointに対応したリンク上の最寄り点の緯度経度を配列で返却します。
  edgeDistance         array マッチングした経路の開始、終了位置からマッチした点までの距離が入ります。
経路が複数となった(path途中にconnection:falseがある)場合、対応する複数結果になります。
    start       number 経路の開始位置から、最初のmatchPointの位置までの距離(メートル)が入ります。
    end       number 最後のmatchPointの位置から、経路の終了位置までの距離(メートル)が入ります。

出力例

[一般道路の場合]

http://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",
                                 "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",
                                 "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",
                                 "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",
                                 "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",
                                 "highwayInfo":null,
                                 "meshCode2":"533936",
                                 "tollRoad":false},
                    "connection":true,
                    "matchPoint"[{"lat":35.6660497,
                                  "lon":139.7557186},
                                 {"lat":35.6660358,
            "edgeDistance":[{"start":69,
                             "end":27}]}}

[高速道路上]

http://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",
                                 "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",
                                 "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}]}}