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

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です。
adasinfo   F ADAS情報の出力
ADAS情報を取得するかを真偽値で指定します。
※本パラメータを利用するには別途契約が必要です。
T adasを出力する
F adasを出力しない
datum   TOKYO 測地系
入出力緯度経度の測地系を指定します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。

出力データ
出力フォーマット
{"item":[{"link":{"code":"7945261",
                  "distance":100,
                  "line":[35.6642761,139.7556914,...,35.6651203,139.7560881],
                  "roadType":{"code":"6",
                              "text":"一般道路(その他)"},
                  "limitedHighway":false,
                  "numberOfLanes":2,
                  "roadWidth":2,
                  "linkSeparation":false,
                  "structure": null,
                  "zlinkCode": null,
                  "onewayCode": 0,
                  "generalRoadName1": "環二通り",
                  "generalRoadName2": "環二通り",
                  "officialRoadName": "環二通り",
                  "popularRoadName": "環二通り",
                  "adas":{"stopInfoFront":[{"type": 0,
                                             "distance": 4800}, ...],
                          "stopInfoBack":[{"type": 0,
                                           "distance": 4800}, ...],
                          "maxspeedFront":[{"limit": 30,
                                            "start": 0,
                                            "end": 100}, ...],
                          "maxspeedBack":[{"limit": 30,
                                            "start": 0,
                                            "end": 100}, ...],
                          "accidentPointFront":{"type": "point",
                                                 "position": {"lat": 39.1961567,
                                                              "lon": 139.9096603}},
                          "accidentPointBack":{"type": "point",
                                               "position": {"lat": 39.1961567,
                                                            "lon": 139.9096603}},
                          "limitinfoFront":{"height": null,
                                            "width": null,
                                            "weight": 14000},
                          "limitinfoBack":{"height": null,
                                           "width": null,
                                           "weight": null},
                          "directionSignFront": "8194",
                          "directionSignBack": "8194"}},
          "closest":{"lat":35.6646292,
                     "lon":139.7558492},
          "distance":7},
 ...]}
キー名 データ型 説明
item         array 検索結果の情報が入ります。マッチング結果を距離の近い順に返却します。
  link       object マッチした道路リンク情報(自動車)が入ります。
    code     string リンクIDが入ります。
    distance     number リンク距離(メートル)が入ります。
    line     array 緯度経度ポリラインが入ります。
    order     string リンク形状座標の格納順序(進行方向)をあらわすコードが入ります。
OE 順方向
EO 逆方向
    roadType     object 道路種別が入ります。
      code   string 種別コードが入ります。
      text   string 種別名称が入ります。
    limitedHihway     boolean 自動車専用道路かどうかの判定が入ります。
true 自動車専用道路
false 自動車専用道路でない
null 不明
    numberOfLanes     number 車線数情報が入ります。
そのリンクに含まれる車線数(上下線分離したリンクの場合は片側だけの車線、分離していないリンクの場合は両側合計の車線)が入ります。
不明の場合nullが入ります。
1 1車線
2 2車線または3車線
4 4車線以上
    roadWidth     number 道路幅員情報が入ります。
不明の場合nullが入ります。
0 幅員3.0m未満
1 幅員3.0m以上5.5m未満
2 幅員5.5m以上13.0m未満
3 幅員13.0m以上
    linkSeparation     boolean 上下線分離フラグが入ります。
true 上下線を分離して上り/下りを別々のリンク列で表現した道路
false 上下線を分離せず上り/下りを一つのリンク列で表現した道路
    structure     string リンクの構造情報が入ります。
データなしの場合は null となります。
TUNNEL 当該リンクがトンネルであることを示します。
    zlinkCode     string ZリンクIDが入ります。
    onewayCode     number リンクがどちらの方向に通行可能かの情報が入ります。
不明の場合はnullとなります。
0 両方向通行可
1 順方向一方通行
2 逆方向一方通行
3 両方向通行禁止
    generalRoadName1     string 道路一般名称1が入ります。
不明の場合はnullが入ります。
    generalRoadName2     string 道路一般名称2が入ります。
不明の場合はnullが入ります。
    officialRoadName     string 道路正式名称が入ります。
不明の場合はnullが入ります。
    popularRoadName     string 道路通称名称が入ります。
不明の場合はnullが入ります。
    adas     object ADAS情報オブジェクトが入ります。
情報が無い場合はnullが入ります。
周辺道路リンク検索には進行方向の情報が無いため、
**Front,**Backの形式で両方向の情報を出力します。
実際のキー名は出力例からご確認ください。
      stopInfo
(Front/Back)
  array 当該地点の一時停止情報が入ります。
        type number 当該地点の停止線の種別が入ります。
0 停止線有り(現実世界にあり)
1 仮想停止線
        distance number 停止線位置までの距離が入ります。(単位:cm)
      maxspeed
(Front/Back)
  array 最高速度情報が入ります。
        limit number 区間開始位置~区間終了位置に適用する最高速度が入ります。(単位:Km/h)
        start number 区間割合相対開始位置が入ります。
        end number 区間割合相対終了位置が入ります。
      accidentPoint
(Front/Back)
  object 事故多発地点情報が入ります。
        type string 事故地点情報の種別が入ります。
point 地点型
linestring 区間型
        position object typeがpointの場合緯度経度が入ります。
linestringの場合はnullが入ります。
      limitinfo
(Front/Back)
  object 各制限情報が入ります。
        height number 高さ制限情報が入ります。(単位:cm)
        width number 幅制限情報が入ります。(単位:cm)
        weight number 重量制限情報が入ります。(単位:kg)
      directionSign
(Front/Back)
  string 大型車の指定方向外進行禁止標識情報が入ります。
指定外進入禁止は、当該リンクから退出する時の標識コードです。
通行禁止は、当該リンク自体が通行止めかどうかを認識するためのコードです。
8193 指定方向外進行禁止その他
8194 指定方向外進行禁止直進
8195 指定方向外進行禁止左折
8196 指定方向外進行禁止直進+左折
8197 指定方向外進行禁止直線+右折
8198 指定方向外進行禁止右折
8199 指定方向外進行禁止右左折
12288 車両通行止め
12289 大型乗用自動車等通行止め
12290 大型貨物自動車等通行止め
12291 車両(組み合わせ)通行止め
  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&adasinfo=T

{"item":[{"link":{"code":"7945261",
                  "distance":100,
                  "line":[35.6642761,139.7556914, ... ,35.6651203,139.7560881],
                  "order":"OE"
                  "roadType":{"code":"6",
                              "text":"一般道路(その他)"},
                  "limitedHighway":false,
                  "numberOfLanes":
                  "roadWidth":,
                  "linkSeparation":false,
                  "structure": null,
                  "zlinkCode": null,
                  "onewayCode": 0,
                  "generalRoadName1": "環二通り",
                  "generalRoadName2": "環二通り",
                  "officialRoadName": "環二通り",
                  "popularRoadName": "環二通り",
                  "adas":{"stopInfoFront":[{"type": 0,
                                             "distance": 4800}, ...],
                          "stopInfoBack":[{"type": 0,
                                           "distance": 4800}, ...],
                          "maxspeedFront":[{"limit": 30,
                                            "start": 0,
                                            "end": 100}, ...],
                          "maxspeedBack":[{"limit": 30,
                                            "start": 0,
                                            "end": 100}, ...],
                          "accidentPointFront":{"type": "point",
                                                 "position": {"lat": 39.1961567,
                                                              "lon": 139.9096603}},
                          "accidentPointBack":{"type": "point",
                                               "position": {"lat": 39.1961567,
                                                            "lon": 139.9096603}},
                          "limitinfoFront":{"height": null,
                                            "width": null,
                                            "weight": 14000},
                          "limitinfoBack":{"height": null,
                                           "width": null,
                                           "weight": null},
                          "directionSignFront": "8194",
                          "directionSignBack": "8194"}},
          "closest":{"lat":35.6646292,
                     "lon":139.7558492},
          "distance":7},
         {"link":{"code":"7945522",
                  "distance":18,
                  "line":[35.6646575,139.7553861,35.6646014,139.7555769],
                  "order":"OE"
                  "roadType":{"code":"9",
                              "text":"細街路(詳細)"},
                  "limitedHighway":false,
                  "numberOfLanes":2,
                  "roadWidth":2,
                  "linkSeparation":false,
                  "structure": null,
                  "zlinkCode": null,
                  "onewayCode": 0,
                  "generalRoadName1": "環二通り",
                  "generalRoadName2": "環二通り",
                  "officialRoadName": "環二通り",
                  "popularRoadName": "環二通り",
                  "adas": null,
          "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":[]}