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

API名: 
road/latlon/drive
概要: 

自動車ネットワークデータを元にリクエストパラメータの緯度経度地点から最寄道路を検索し、
その道路リンク情報(自動車)を返却します。
いつもNAVI API3.0 で使用している 株式会社ゼンリンの地図データ について

※一部パラメータを利用するには別途契約が必要です。

URI: 

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

<API使用例>
https://test.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 ○ - 緯度経度
緯度経度を指定します。
multipointパラメータがT指定の場合、
最大200点まで複数指定できます。
本項目は必須項目であるため、未指定の場合はエラーとなります。
range   50 マッチング距離範囲
指定緯度経度地点からマッチングさせる距離範囲(単位:m)を指定します。
この範囲内に道路データが存在しない場合はマッチングされません。
設定可能範囲は、1～500です。
adasinfo   F ADAS情報
ADAS情報を取得するかを真偽値で指定します。
※本パラメータを利用するには別途契約が必要です。
指定値 説明
T adasを出力する
F adasを出力しない
road_elevation_info   F 道路標高情報
道路標高情報を取得するかどうかを真偽値で指定します。
本パラメータをT指定した場合、ADAS情報オブジェクト内に道路標高情報オブジェクトを出力します。
adasinfoがF指定の場合、本パラメータは無効となります。
※本パラメータを利用するには別途契約が必要です。
指定値 説明
T adas->roadelevationを出力する
※出力結果のデータ量が増加します。ご留意ください。
F adas->roadelevationを出力しない
datum   TOKYO 測地系
入出力緯度経度の測地系を指定します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。
multipoint   F 複数点指定
検索方式を真偽値で指定します。
指定値 説明
T latlonパラメータの複数点指定検索に対応する
※出力フォーマットが変わります。
※マッチング距離範囲との併用や、指定地点数に
　比例して応答時間を要します。
　件数により、数秒~数十秒かかる場合があります。
F latlonパラメータの複数点指定検索に対応しない

出力データ
出力フォーマット
{"item":[{"link":{"code":"2xSAP6xSYwD4Als+DAOYPg==",
                  "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",
                          "roadelevation": [{"lat": 35.419725833333,
                                             "lon": 139.38639944444,
                                             "elevation": 21315}, ...]},
          "closest":{"lat":35.6646292,
                     "lon":139.7558492},
          "distance":7},
 ...]}
キー名 データ型 説明
item         array 検索結果の情報が入ります。
マッチング結果を距離の近い順に返却します。
          array 複数点指定時、検索結果の配列が入ります。
指定した緯度経度順に返却されます。
マッチングしなかった場合、その場所の配列要素がnullになります。
  link       object マッチした道路リンク情報(自動車)が入ります。
    code     string リンクIDが入ります。
    distance     number リンク距離(単位:m)が入ります。
    line     array 緯度経度ポリラインが入ります。
    order     string リンク形状座標の格納順序(進行方向)をあらわすコードが入ります。
OE 順方向
EO 逆方向
    roadType     object 道路種別が入ります。
      code   string 種別コードが入ります。
      text   string 種別名称が入ります。
    limitedHighway     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の形式で両方向の情報を出力します。
Front：格納されている配列の順番通り
Back：格納されている配列の逆順番
格納されている配列は、item->link->line（緯度経度ポリライン）を指します。
実際のキー名は出力例からご確認ください。
      stopInfo
(Front/Back)		   array 当該地点の一時停止情報が入ります。
        type number 当該地点の一時停止線の種別が入ります。
0 一時停止線有り（現実世界にあり）
1 仮想一時停止線（現実世界になし）
        distance number 一時停止位置までの距離が入ります。(単位:cm)
Frontの例である図説もあわせてご確認ください。
      maxspeed
(Front/Back)		   array 最高速度情報が入ります。
        limit number 区間開始位置～区間終了位置に適用する最高速度が入ります。(単位:Km/h)
        start number 区間割合相対開始位置が入ります。(単位:%)
区間割合相対開始位置とはリンクの全長を100%とした時のlimitの開始位置です。
        end number 区間割合相対終了位置が入ります。(単位:%)
区間割合相対終了位置とはリンクの全長を100%とした時のlimitの終了位置です。
      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 車両(組み合わせ)通行止め
      roadelevation   object 道路標高情報のオブジェクトが配列で入ります。
        lat number 道路標高情報の地点緯度が入ります。
        lon number 道路標高情報の地点経度が入ります。
        elevation number 道路標高が入ります。(単位:mm)
  closest       object マッチしたリンク上の最寄り点の緯度経度が入ります。
  distance       number 入力点から最寄り点までの距離(単位:m)が入ります。

出力例

[通常出力例：複数点指定(multipoint) F指定の時]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/road/latlon/drive?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
latlon=35.641161389,139.752511389&adasinfo=T&road_elevation_info=T

{
    "item": [
        {
            "link": {
                "code": "2xQAP4k6YwACATYsnQGaLA==",
                "distance": 121,
                "line": [
                    35.6414081,
                    139.7531508,
                    35.6408994,
                    139.7519683
                ],
                "order": "OE",
                "roadType": {
                    "code": "6",
                    "text": "一般道路(その他)"
                },
                "limitedHighway": false,
                "numberOfLanes": 2,
                "roadWidth": 2,
                "linkSeparation": false,
                "structure": null,
                "zlinkCode": 2237688,
                "onewayCode": 0,
                "generalRoadName1": null,
                "generalRoadName2": null,
                "officialRoadName": null,
                "popularRoadName": null,
                "adas": {
                    "stopInfoFront": null,
                    "stopInfoBack": null,
                    "maxspeedFront": [
                        {
                            "limit": 40,
                            "start": 0,
                            "end": 100
                        }
                    ],
                    "maxspeedBack": [
                        {
                            "limit": 40,
                            "start": 0,
                            "end": 100
                        }
                    ],
                    "accidentPointFront": null,
                    "accidentPointBack": null,
                    "limitinfoFront": null,
                    "limitinfoBack": null,
                    "directionSignFront": null,
                    "directionSignBack": null,
                    "roadelevation": [
                        {
                            "lat": 35.6414092,
                            "lon": 139.7531436,
                            "elevation": 2609
                        },
                        {
                            "lat": 35.6408939,
                            "lon": 139.7519631,
                            "elevation": 2597
                        }
                    ]
                }
            },
            "closest": {
                "lat": 35.6411375,
                "lon": 139.7525217
            },
            "distance": 2
        }
    ]
}

[通常出力例：複数点指定(multipoint) T指定の時]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/road/latlon/drive?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
latlon=35.514327222,139.798250833,35.433824722,139.9189625&adasinfo=T&road_elevation_info=T&multipoint=T

{
    "item": [
        [
            {
                "link": {
                    "code": "2xQgLuQcYQCYGOEKACApBA==",
                    "distance": 1730,
                    "line": [
                        35.5144703,139.7971114,
                        35.514165,139.7980344, ...
                    ],
                    "order": "OE",
                    "roadType": {
                        "code": "2",
                        "text": "国道"
                    },
                    "limitedHighway": true,
                    "numberOfLanes": 2,
                    "roadWidth": 2,
                    "linkSeparation": true,
                    "structure": "TUNNEL",
                    "zlinkCode": 93012,
                    "onewayCode": 1,
                    "generalRoadName1": "東京湾ｱｸｱﾗｲﾝ",
                    "generalRoadName2": "国道409号線",
                    "officialRoadName": null,
                    "popularRoadName": null,
                    "adas": {
                        "stopInfoFront": null,
                        "stopInfoBack": null,
                        "maxspeedFront": [
                            {
                                "limit": 80,
                                "start": 0,
                                "end": 100
                            }
                        ],
                        "maxspeedBack": null,
                        "accidentPointFront": null,
                        "accidentPointBack": null,
                        "limitinfoFront": null,
                        "limitinfoBack": null,
                        "directionSignFront": null,
                        "directionSignBack": null,
                        "roadelevation": [
                            {
                                "lat": 35.5144686,
                                "lon": 139.79711,
                                "elevation": -9633
                            },
                            {
                                "lat": 35.5144503,
                                "lon": 139.7971664,
                                "elevation": -9831
                            }, ...
                        ]}},
                "closest": {
                    "lat": 35.5141167,
                    "lon": 139.7981817
                },
                "distance": 24
            },
            {
                "link": {
                    "code": "2xQgLs8cYQCNGL8KACDwAw==",
                    "distance": 1742,
                    "line": [
                        35.5051269,139.8125,
                        35.5055236,139.8119125, ...
                    ],
                    "order": "OE",
                    "roadType": {
                        "code": "2",
                        "text": "国道"
                    },
                    "limitedHighway": true,
                    "numberOfLanes": 2,
                    "roadWidth": 2,
                    "linkSeparation": true,
                    "structure": "TUNNEL",
                    "zlinkCode": 92987,
                    "onewayCode": 1,
                    "generalRoadName1": "東京湾ｱｸｱﾗｲﾝ",
                    "generalRoadName2": "国道409号線",
                    "officialRoadName": null,
                    "popularRoadName": null,
                    "adas": {
                        "stopInfoFront": null,
                        "stopInfoBack": null,
                        "maxspeedFront": [
                            {
                                "limit": 80,
                                "start": 0,
                                "end": 100
                            }
                        ],
                        "maxspeedBack": null,
                        "accidentPointFront": null,
                        "accidentPointBack": null,
                        "limitinfoFront": null,
                        "limitinfoBack": null,
                        "directionSignFront": null,
                        "directionSignBack": null,
                        "roadelevation": [
                            {
                                "lat": 35.5051269,
                                "lon": 139.8125,
                                "elevation": -50986
                            },
                            {
                                "lat": 35.5051331,
                                "lon": 139.8124917,
                                "elevation": -50984
                            }, ...
                        ]}},
                "closest": {
                    "lat": 35.5139347,
                    "lon": 139.7981017
                },
                "distance": 45
            }
        ],
        [
            {
                "link": {
                    "code": "2xQgIDwCcwAlEwAQGxfQDA==",
                    "distance": 843,
                    "line": [
                        35.4375,139.9123914,
                        35.4369761,139.9131622, ...
                    ],
                    "order": "OE",
                    "roadType": {
                        "code": "2",
                        "text": "国道"
                    },
                    "limitedHighway": true,
                    "numberOfLanes": 2,
                    "roadWidth": 2,
                    "linkSeparation": true,
                    "structure": null,
                    "zlinkCode": 93024,
                    "onewayCode": 1,
                    "generalRoadName1": "東京湾ｱｸｱﾗｲﾝ",
                    "generalRoadName2": "国道409号線",
                    "officialRoadName": null,
                    "popularRoadName": null,
                    "adas": {
                        "stopInfoFront": null,
                        "stopInfoBack": null,
                        "maxspeedFront": [
                            {
                                "limit": 80,
                                "start": 0,
                                "end": 56
                            },
                            {
                                "limit": 40,
                                "start": 56,
                                "end": 100
                            }
                        ],
                        "maxspeedBack": null,
                        "accidentPointFront": null,
                        "accidentPointBack": null,
                        "limitinfoFront": null,
                        "limitinfoBack": null,
                        "directionSignFront": null,
                        "directionSignBack": null,
                        "roadelevation": [
                            {
                                "lat": 35.4375,
                                "lon": 139.9123914,
                                "elevation": 14969
                            },
                            {
                                "lat": 35.4374894,
                                "lon": 139.9124125,
                                "elevation": 14961
                            }, ...
                        ]
                    }
                },
                "closest": {
                    "lat": 35.43385,
                    "lon": 139.9189736
                },
                "distance": 2
            }, ...
        ]
    ]
}

[例. マッチしなかった場合]
https://test.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":[]}