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

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

マッチング距離範囲
指定緯度経度地点からマッチングさせる距離範囲(単位:m)を指定します。
この範囲内に道路データが存在しない場合はマッチングされません。
設定可能範囲は、1～500です。

adasinfo

ADAS情報
ADAS情報を取得するかを真偽値で指定します。
※本パラメータを利用するには別途契約が必要です。

指定値	説明
T	adasを出力する
F	adasを出力しない

road_elevation_info

道路標高情報
道路標高情報を取得するかどうかを真偽値で指定します。
本パラメータをT指定した場合、ADAS情報オブジェクト内に道路標高情報オブジェクトを出力します。
adasinfoがF指定の場合、本パラメータは無効となります。
※本パラメータを利用するには別途契約が必要です。

指定値	説明
T	adas->roadelevationを出力する ※出力結果のデータ量が増加します。ご留意ください。
F	adas->roadelevationを出力しない

datum

TOKYO

測地系
入出力緯度経度の測地系を指定します。

llunit

dec

緯度経度形式
緯度経度形式を指定します。

multipoint

複数点指定
検索方式を真偽値で指定します。

指定値	説明
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":[]}