周辺道路リンク検索(自動車)

API名: 
road/latlon/drive
概要: 
自動車ネットワークデータを元にリクエストパラメータの緯度経度地点から最寄道路を検索し、その道路リンク情報(自動車)を返却します。
URI: 

http://core.its-mo.com/zmaps/api/apicore/core/v1_0/road/latlon/drive

<API使用例>
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/road/latlon/drive?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.66466,139.755787&range=30

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
latlon - 緯度経度の指定
対象の緯度経度。
本項目は必須項目であるため、未指定の場合はエラーとなります。
range   50 マッチング距離範囲(メートル)
指定緯度経度地点からマッチングさせる距離範囲(メートル)を指定します。
この範囲内に道路データが存在しない場合はマッチングされません。
設定可能範囲は、1~500です。
datum   TOKYO 測地系
返却される住所代表点の測地系を指定します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。

出力データ
出力フォーマット
{"item":[{"link":{"code":"7945261",
                  "distance":100,
                  "line":[35.6642761,139.7556914,35.6645253,139.7557983,35.6648356,139.7559508,35.6651203,139.7560881],
                  "roadType":{"code":"6",
                              "text":"一般道路(その他)"},
                  "limitedHighway":false},
          "closest":{"lat":35.6646292,
                     "lon":139.7558492},
          "distance":7},
 ...]}
キー名 データ型 説明
item   array 検索結果の情報が入ります。マッチング結果を距離の近い順に返却します。
  link object マッチした道路リンク情報(自動車)が入ります。
  closest object マッチしたリンク上の最寄り点の緯度経度が入ります。
  distance number 入力点から最寄り点までの距離(メートル)が入ります。

出力例

[通常出力例]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/road/latlon/drive?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.66466,139.755787&range=30

{"item":[{"link":{"code":"7945261",
                  "distance":100,
                  "line":[35.6642761,139.7556914,35.6645253,139.7557983,35.6648356,139.7559508,35.6651203,139.7560881],
                  "roadType":{"code":"6",
                              "text":"一般道路(その他)"},
                  "limitedHighway":false},
          "closest":{"lat":35.6646292,
                     "lon":139.7558492},
          "distance":7},
         {"link":{"code":"7945522",
                  "distance":18,
                  "line":[35.6646575,139.7553861,35.6646014,139.7555769],
                  "roadType":{"code":"9",
                              "text":"細街路(詳細)"},
                  "limitedHighway":false},
          "closest":{"lat":35.6646014,
                     "lon":139.7555769},
          "distance":20}]}

[例. マッチしなかった場合]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/road/latlon/drive?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.66466,139.755787&range=5

{"item":[]}