最寄り道路リンク地点検索(自動車)

API名:

road_match2/drive

概要:

自動車ネットワークデータを元にリクエストパラメータの緯度経度地点から最寄道路を検索し、その道路上の最も近い点を返却します。

URI:

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

<API使用例>
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/road_match2/drive?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.687004,139.75618,35.686897,139.75594,35.6868,139.7557&range=50

リクエストパラメータ

パラメータ	必須	デフォルト値	説明
latlon	○	-	緯度経度緯度経度を指定します。200点まで複数指定できます。未指定の場合はエラーとなります。
range		50	マッチング距離範囲(メートル) 指定緯度経度地点からマッチングさせる距離範囲(単位:m)を指定します。この範囲内に道路データが存在しない場合はマッチングされません。設定可能範囲は、1～500です。
datum		TOKYO	測地系入出力緯度経度の測地系を指定します。
llunit		dec	緯度経度形式緯度経度形式を指定します。

出力データ

出力フォーマット

[{"point":{"lat":35.6870017,
           "lon":139.7561806},
"roadType":{"code":"1",
              "text":"都市高速道路"},
  "limitedHighway":true},
...]

キー名		データ型	説明
point		object	マッチングした緯度経度情報が入ります。
roadType		object	道路種別情報が入ります。
	code	string	道路種別コードが入ります。
	text	string	道路種別名称が入ります。
limitedHighway		boolean	自動車専用道路フラグが入ります。自動車専用道路の場合はTRUEが入ります。

出力例

[通常出力例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/road_match2/drive?
if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.687004,139.75618,35.686897,139.75594,35.6868,139.7557&range=50

[{"point":{"lat":35.6870017,
           "lon":139.7561806},
"roadType":{"code":"1",
              "text":"都市高速道路"},
"limitedHighway":true},
{"point":{"lat":35.6869033,
           "lon":139.7559372},
"roadType":{"code":"1",
              "text":"都市高速道路"},
"limitedHighway":true},
{"point":{"lat":35.6867958,
           "lon":139.7557017},
"roadType":{"code":"1",
              "text":"都市高速道路"},
"limitedHighway":true}]

[2番目の値がマッチしなかった場合]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/road_match2/drive?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.687004,139.75618,1,1,35.6868,139.7557&range=50

[{"point":{"lat":35.6870017,
           "lon":139.7561806},
"roadType":{"code":"1",
              "text":"都市高速道路"},
  "limitedHighway":true},
null,
{"point":{"lat":35.6867958,
           "lon":139.7557017},
"roadType":{"code":"1",
              "text":"都市高速道路"},
"limitedHighway":true}]