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

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

往復路削除判定
真偽値を指定します。
往復路となっているリンク部分を削除します。

出力データ

出力フォーマット

{"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}]}