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

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