ルートマッチング(歩行者)

API名: 
road_path
概要: 

リクエストパラメータの緯度経度の点列から移動した経路を推定し、マッチした道路リンクデータを返却します。
歩行者用の機能のため、自動車専用道路にはマッチせず、一方通行の情報もありません。

URI: 

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

<API使用例>
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/road_path?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.665074,139.755996,35.66466,139.755787&code=7417457&order=OE

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
latlon ○ - 緯度経度
緯度経度を指定します。50点が上限です。
未指定の場合はエラーとなります。
code   - リンクコード
前回のリクエスト結果につなげる場合、前回値のcodeを指定します。
指定がない場合、最初の点の最寄りリンクを取得します。
order   - リンクコード並び順
前回のリクエスト結果につなげる場合、前回値のorderを指定します。
OE 開始点→終了点
EO 終了点→開始点
datum   TOKYO 測地系
入出力緯度経度の測地系を指定します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。
nearlimit   300 検索範囲
最寄リンクを取得する際の検索範囲をメートルで指定します。
ただし、codeが指定されている場合、本項目は無効です。
指定範囲は、0～500です。
edgeadjust   neither リンクの始点終点
リンクの始点、及び終点を入力点に近いところへ調整します。
ただし、返却されるリンクデータ数が1つの場合は無効になります。
neither 始点、終点ともに調整しません。
start 始点のみ調整します。
code が指定されている場合は無効です。
end 終点のみ調整します。
both 始点、終点ともに調整します。
code が指定されている場合、始点調整は無効です。
roundpath   F 往復路削除判定
真偽値を指定します。
往復路となっているリンク部分を削除します。
出力データ
出力フォーマット
{"last":{"code":"7417648",
         "order":"OE"},
 "path":[{"inputPoint":[{"lat":35.6656758,
                         "lon":139.7539458}],
          "matchLink":{"code":"7417647",
                       "distance":48,
                       "line":[35.6658528,139.7538528,35.6656189,139.7537383,...],
                       "roadType":{"code":"6",
                                   "text":"一般道路(その他)"},
                       "limitedHighway":false},
          "connection":false},
...]}
キー名 データ型 説明
last   object 次回リクエストに使用する情報を設定します。
  code string パス最後のリンクコードを設定します。
次のリクエスト時に今回の結果をつなげる場合は、リクエストパラメータcodeに当該値を設定します。
  order string パス最後の接続情報を設定します。
次のリクエスト時に今回の結果をつなげる場合は、リクエストパラメータorderに当該値を設定します。
path   array マッチしたリンク情報を設定します。
接続順に配列で返却します。
  inputPoint array このリンクにマッチした入力緯度経度を配列で返却します。
マッチした点がない場合、空の配列となります。
※内部的に変換され、誤差が生じるため、入力緯度経度と完全一致はしません。
  matchLink object マッチした道路リンク情報を設定します。
ただし以下はnullが入ります。
・numberOfLanes
・roadWidth
・linkSeparation
・structure
・Zlink
  connection boolean 前のリンクと接続している場合 true となります。
入力座標の距離が離れすぎている等で接続したリンクが取得できない場合、false となり新たなリンクが開始されます。

出力例

[通常出力例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/road_path?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
code=7417457&order=OE&latlon=35.665074,139.755996,35.66466,139.755787 

{"last":{"code":"2006878",
         "order":"EO"},
 "path":[{"inputPoint":[],
          "matchLink":{"code":"7417457",
                       "distance":125,
                       "line":[35.6637108,139.7569667,35.6637775,139.7567675,　...],
                       "roadType":{"code":"6",
                                   "text":"一般道路(その他)"},
                       "limitedHighway":false},
          "connection":true},
         {"inputPoint":[],
          "matchLink":{"code":"2006879",
                       "distance":47,
                       "line":[35.6641278,139.7556772,35.6643211,139.7557689,...],
                       "roadType":{"code":"6",
                                   "text":"一般道路(その他)"},
                       "limitedHighway":false},
          "connection":true},
         {"inputPoint":[{"lat":35.6650739,
                         "lon":139.7559958},
                        {"lat":35.6646597,
                         "lon":139.7557869}],
          "matchLink":{"code":"2006878",
                       "distance":35,
                       "line":[35.6645244,139.7558606,35.6646208,139.7559061,...],
                       "roadType":{"code":"6",
                                   "text":"一般道路(その他)"},
                       "limitedHighway":false},
          "connection":true}]}