road/mapmatch
マップマッチング
指定した緯度経度の点列をもとにルートを推定し、ルートを構成する道路リンク情報を取得します。
HTTP request method
POST/GET
ContentType
application/x-www-form-urlencoded
Parameters
*requiredは必須
| 名前 | 説明 |
|---|---|
|
positions*required array[number] ※カンマ区切り |
座標を指定。カンマ区切りで複数座標を指定可能。最大100座標 経度、緯度の順に座標をカンマ区切りで指定する。 140.08785,36.10377,140.08792,36.10375 ※点指定の適切な間隔の目安は20mです。 間隔が離れすぎてしまうと誤マッチの原因となります。(図1) GPSのエラー等により点がずれると、正しくマッチングされない可能性があります。(図2) 図1 点列の間隔が不適当であるため誤マッチするパターン  誤マッチするパターン  期待パターン 図2 GPSエラーによって位置情報がずれた結果誤マッチするパターン  誤マッチするパターン  期待パターン |
|
initial_road_type integer |
道路種別限定 最初にマッチさせるリンクを指定の道路種別に限定します。 複数値指定できます。 指定なしの場合は全ての道路種別が対象になります。 クエリパラメータpositionsの初点付近に指定した道路種別がない場合、 「指定なし」と同じ動作となります。 ※該当の道路種別がない場合は最寄りの最適な道路種別の結果となります。
|
|
datum string default JGD |
入出力座標の測地系を指定します。 JGD
世界測地系
TOKYO
日本測地系
TOKYO_NAVI
日本測地系(ゼンリン ナビ地図)
|
|
llunit string default dec |
緯度経度形式 入出力経度緯度形式を指定します。 dec
10進度形式
msec
ミリ秒形式
|
|
names boolean default false |
道路名称詳細出力指定 正式名称や一般名称などの、道路名称詳細情報を出力するかどうかを指定します。 通常レスポンスされる一般名称[road_name]とは別に、整備されている全呼び名種別の全名称をレスポンスします。 true
利用する
false
利用しない
|
Responses
エラーについては「エラーメッセージ一覧」を参照してください。
Media type:application/json
| キー名 | 説明 | |||||
|---|---|---|---|---|---|---|
| status string |
ステータス | |||||
| result object |
マッチング結果が入ります。 マッチするリンクが存在しない場合はnullとなります。 |
|||||
| path array[object] |
マッチしたリンク情報の配列が入ります。 配列の順序は接続順となります。 |
|||||
| match_info array[object] |
リクエスト地点の情報が入ります。 | |||||
| input_point array[number] |
当該リンクにマッチした入力経度緯度を配列で返却します。 マッチした点がない場合は空の配列となります。 ※内部的に変換され、誤差が生じるため、入力経度緯度と完全一致はしません。 |
|||||
| on_road boolean |
オンロードしているかの真偽値が入ります。
|
|||||
| match_point array[number] |
当該リンクのinputPointに対応したリンク上の最寄り点の 経度緯度を配列で返却します。 | |||||
| match_link array[object] |
マッチした道路リンク情報のオブジェクトが入ります。 | |||||
| link_id string |
リンクIDが入ります。 リンクにふられるID。 複数のリンク間でIDが重複する場合があり、パーマネントなIDではありません。 |
|||||
| distance number |
リンク距離(単位:m)が入ります。 | |||||
| line object |
リンクの形状点列のオブジェクトが入ります。 ※GeoJSONのGeometry形式 |
|||||
| type string |
固定値"LineString"が入ります。 | |||||
| coordinates array[number] |
リンク形状座標が入ります。 | |||||
| order string |
リンク形状座標の格納順序(進行方向)をあらわすコードが入ります。 OE
順方向
EO
逆方向
|
|||||
| road_type object |
道路種別のオブジェクトが入ります。 | |||||
| code string |
種別コードが入ります。 10
高速自動車国道
20
都市高速道路
30
一般国道
40
都道府県道(主要地方道)
50
一般道路(主要地方道)
60
都道府県道
70
一般道路
80
案内補助道路
90
敷地内道路
|
|||||
| text string |
種別名称が入ります。 | |||||
| link_type object |
リンク種別のオブジェクトが入ります。 | |||||
| code string |
以下の各値が10進数で入ります。 (※複数の種別が該当する場合はAND値: 【本線＋二条分離】= "8193") 0x0001
本線
0x0002
ジャンクション
0x0004
ランプ
0x0008
SAPA
0x0010
側道
0x0020
側道接続道路
0x0040
通所ロータリー
0x0080
交通施設ロータリー
0x0100
誤進入車復帰道路
0x0200
右左折専用道路
0x0400
料金所
0x0800
駐車場
0x1000
スマートIC
0x2000
二条分離
0x4000
交差点内
0x8000
駐車場出入口
|
|||||
| text string |
種別名称がカンマ区切りの文字列で入ります。 (【本線＋二条分離】= "本線,二条分離") |
|||||
| limited_highway boolean |
自動車専用道路かどうかの判定が入ります。
|
|||||
| number_of_lanes integer |
車線数情報が入ります。 そのリンクに含まれる車線数 (上下線分離したリンクの場合は片側だけの車線、 分離していないリンクの場合は両側合計の車線)が入ります。 不明の場合nullが入ります。 |
|||||
| road_width number |
該当リンクおける、最も区間が長い幅員(単位:m)が入ります。 不明の場合nullが入ります。 |
|||||
| road_width_max number |
最大幅員（単位：m）が入ります。 ただし、交差点内リンクなど、幅員が取得できないリンクについては0が格納されます。 また、二条分離の道路においては、上下線全体の幅員ではなく片側の幅員を優先してレスポンスするため、 road_width＞road_width_maxとなる場合もあります。（幅員データの整備状況に依存します） |
|||||
| road_width_min number |
最小有効幅員（単位：m）が入ります。 ただし、交差点内リンクなど、幅員が取得できないリンクについては0が格納されます。 |
|||||
| road_width_average number |
平均幅員（単位：m）が入ります。 ただし、交差点内リンクなど、幅員が取得できないリンクについては0が格納されます。 |
|||||
| link_separation boolean |
上下線分離フラグが入ります。
|
|||||
| structure string |
リンクの構造情報が入ります。 データなしの場合はnullとなります。
|
|||||
| serv_link_code string |
サービスリンクIDが入ります。 | |||||
| road_name string |
道路名称が入ります。 リンクに紐づく一般名称を1件のみレスポンスします。 不明の場合はnullとなります。 |
|||||
| names_mst array[object] |
道路名称詳細情報 道路名称詳細情報が入ります。 道路名称詳細情報[names]でtrueが指定されたときのみ出力されます。 道路名称詳細情報が存在しない場合は空配列。 |
|||||
| nickname_type integer |
呼び名種別 1
正式名称（公称） 例：東京所沢線
2
一般名称 例：都道４号線
3
通称名称 例：青梅街道
4
略称名称 例：東京外環道
11
ナンバリング 例：C1
|
|||||
| road_type_mst integer |
道路種別 10
高速自動車国道/都市高速道路
20
有料道路
30
一般国道
60
都道府県道（主要地方道）
70
都道府県道
80
一般道路
|
|||||
| name_mst string |
道路名称 道路名称を出力 |
|||||
| highway_info array[object] |
高速道路情報オブジェクトが入ります。 情報がない場合(高速以外の道路、高速でIC/JCT/SAPAでないリンク) はnullとなります。 |
|||||
| point_type array[string] |
当該地点の施設種別情報が入ります。 JCT
当該地点がJCTである
SAPA
当該地点がSAPAである
IC
当該地点がICである
smartIC
当該地点がsmartICである
|
|||||
| point_name string |
地点の名称が入ります。 | |||||
| mesh_code string |
ZGMメッシュコード（Lv13）が入ります。 | |||||
| toll_road boolean |
当該リンクが有料道路かを真偽値で表します。
|
|||||
| connection boolean |
前のリンクと接続しているかを真偽値で表します。
|
|||||
| edge_distance array[object] |
マッチングした経路の開始、終了位置からマッチした 点までの距離が入ります。 経路が複数となった(path途中にconnection:falseがある)場合、 対応する複数結果になります。 |
|||||
| start number |
経路の開始位置から、最初のmatchPointの位置までの距離 (単位:m)が入ります。 |
|||||
| end number |
最後のmatchPointの位置から、経路の終了位置までの距離 (単位:m)が入ります。 |
|||||
Example
https://[domain]/route/road/mapmatch?positions=140.08847358644118,36.10194399076527,140.08824978665163,36.101772361516915,140.08802598686205,36.101536370688265,140.08766942448543,36.1012114990373,140.087126994487,36.10157314852636,140.08675905246008,36.10188575945518&llunit=dec&names=true
{
"result": {
"edge_distance": [
{
"end": 14.872512825500868,
"start": 164.7065220262014
}
],
"path": [
{
"connection": false,
"match_info": {
"input_point": [
140.08847358644118,
36.10194399076527,
140.08824978665163,
36.101772361516915
],
"match_point": [
140.08844697001524,
36.1019638328325,
140.08827638860728,
36.10181313121269
],
"on_road": true
},
"match_link": {
"adas": null,
"distance": 213.6,
"highway_info": null,
"limited_highway": false,
"line": {
"coordinates": [
140.0897300889757,
36.10302137586805,
140.0891628689236,
36.102596299913195,
140.08808051215277,
36.10164008246528
],
"type": "LineString"
},
"link_id": "5150010000062924106",
"link_separation": true,
"link_type": {
"code": "8193",
"text": "本線,二条分離"
},
"mesh_code": "961989111524745216",
"names_mst": [
{
"name_mst": "土浦境線",
"nickname_type": 1,
"road_type_mst": 60
},
{
"name_mst": "県道２４号線",
"nickname_type": 2,
"road_type_mst": 60
},
{
"name_mst": "平塚通り",
"nickname_type": 3,
"road_type_mst": 80
}
],
"number_of_lanes": 2,
"order": "OE",
"road_name": "県道２４号線",
"road_type": {
"code": "40",
"text": "都道府県道（主要地方道）"
},
"road_width": 8.04,
"road_width_average": 8.58,
"road_width_max": 11.61,
"road_width_min": 8.04,
"serv_link_code": "961989218383429736",
"structure": null,
"toll_road": false
}
},
{
"connection": true,
"match_info": {
"input_point": [
140.08802598686205,
36.101536370688265
],
"match_point": [
140.0880095956904,
36.10157645925113
],
"on_road": true
},
"match_link": {
"adas": null,
"distance": 43.5,
"highway_info": null,
"limited_highway": false,
"line": {
"coordinates": [
140.08808051215277,
36.10164008246528,
140.0877560763889,
36.10134901258681
],
"type": "LineString"
},
"link_id": "5150010000040306864",
"link_separation": true,
"link_type": {
"code": "8193",
"text": "本線,二条分離"
},
"mesh_code": "961989111524745216",
"names_mst": [
{
"name_mst": "土浦境線",
"nickname_type": 1,
"road_type_mst": 60
},
{
"name_mst": "県道２４号線",
"nickname_type": 2,
"road_type_mst": 60
},
{
"name_mst": "平塚通り",
"nickname_type": 3,
"road_type_mst": 80
}
],
"number_of_lanes": 2,
"order": "OE",
"road_name": "県道２４号線",
"road_type": {
"code": "40",
"text": "都道府県道（主要地方道）"
},
"road_width": 9.62,
"road_width_average": 10.29,
"road_width_max": 12.08,
"road_width_min": 9.62,
"serv_link_code": "961989218383429737",
"structure": null,
"toll_road": false
}
},
{
"connection": true,
"match_info": {
"input_point": [
140.08766942448543,
36.1012114990373
],
"match_point": [
140.08773516960585,
36.101329865633986
],
"on_road": true
},
"match_link": {
"adas": null,
"distance": 10.9,
"highway_info": null,
"limited_highway": false,
"line": {
"coordinates": [
140.0877560763889,
36.10134901258681,
140.08767550998263,
36.10127522786458
],
"type": "LineString"
},
"link_id": "5150010000040306899",
"link_separation": true,
"link_type": {
"code": "24576",
"text": "二条分離,交差点内"
},
"mesh_code": "961989111524745216",
"names_mst": [
{
"name_mst": "土浦境線",
"nickname_type": 1,
"road_type_mst": 60
},
{
"name_mst": "県道２４号線",
"nickname_type": 2,
"road_type_mst": 60
},
{
"name_mst": "平塚通り",
"nickname_type": 3,
"road_type_mst": 80
}
],
"number_of_lanes": 2,
"order": "OE",
"road_name": "県道２４号線",
"road_type": {
"code": "40",
"text": "都道府県道（主要地方道）"
},
"road_width": 9.62,
"road_width_average": 9.62,
"road_width_max": 9.62,
"road_width_min": 9.62,
"serv_link_code": "961989218383429755",
"structure": null,
"toll_road": false
}
},
{
"connection": true,
"match_info": {
"input_point": [],
"match_point": [],
"on_road": true
},
"match_link": {
"adas": null,
"distance": 8.6,
"highway_info": null,
"limited_highway": false,
"line": {
"coordinates": [
140.08767550998263,
36.10127522786458,
140.08760064019097,
36.101322157118055
],
"type": "LineString"
},
"link_id": "5150010000040306898",
"link_separation": true,
"link_type": {
"code": "24576",
"text": "二条分離,交差点内"
},
"mesh_code": "961989111524745216",
"names_mst": [
{
"name_mst": "国道４０８号線",
"nickname_type": 2,
"road_type_mst": 30
},
{
"name_mst": "学園西大通り",
"nickname_type": 3,
"road_type_mst": 80
}
],
"number_of_lanes": 2,
"order": "OE",
"road_name": "国道４０８号線",
"road_type": {
"code": "30",
"text": "一般国道"
},
"road_width": 12.37,
"road_width_average": 12.37,
"road_width_max": 12.37,
"road_width_min": 12.37,
"serv_link_code": "961989218383429768",
"structure": null,
"toll_road": false
}
},
{
"connection": true,
"match_info": {
"input_point": [
140.087126994487,
36.10157314852636
],
"match_point": [
140.08721299913194,
36.10157687717014
],
"on_road": true
},
"match_link": {
"adas": null,
"distance": 44.9,
"highway_info": null,
"limited_highway": false,
"line": {
"coordinates": [
140.08760064019097,
36.101322157118055,
140.08721299913194,
36.10157687717014
],
"type": "LineString"
},
"link_id": "5150010000040306863",
"link_separation": true,
"link_type": {
"code": "8193",
"text": "本線,二条分離"
},
"mesh_code": "961989111524745216",
"names_mst": [
{
"name_mst": "国道４０８号線",
"nickname_type": 2,
"road_type_mst": 30
},
{
"name_mst": "学園西大通り",
"nickname_type": 3,
"road_type_mst": 80
}
],
"number_of_lanes": 2,
"order": "OE",
"road_name": "国道４０８号線",
"road_type": {
"code": "30",
"text": "一般国道"
},
"road_width": 12.76,
"road_width_average": 12.82,
"road_width_max": 12.88,
"road_width_min": 12.76,
"serv_link_code": "961989218383429764",
"structure": null,
"toll_road": false
}
},
{
"connection": true,
"match_info": {
"input_point": [],
"match_point": [],
"on_road": true
},
"match_link": {
"adas": null,
"distance": 46.5,
"highway_info": null,
"limited_highway": false,
"line": {
"coordinates": [
140.08721299913194,
36.10157687717014,
140.0868158637153,
36.10184516059028
],
"type": "LineString"
},
"link_id": "5150010000040306869",
"link_separation": true,
"link_type": {
"code": "8193",
"text": "本線,二条分離"
},
"mesh_code": "961989111524745216",
"names_mst": [
{
"name_mst": "国道４０８号線",
"nickname_type": 2,
"road_type_mst": 30
},
{
"name_mst": "学園西大通り",
"nickname_type": 3,
"road_type_mst": 80
}
],
"number_of_lanes": 2,
"order": "OE",
"road_name": "国道４０８号線",
"road_type": {
"code": "30",
"text": "一般国道"
},
"road_width": 12.37,
"road_width_average": 24.29,
"road_width_max": 24.59,
"road_width_min": 22.7,
"serv_link_code": "961989218383429765",
"structure": null,
"toll_road": false
}
},
{
"connection": true,
"match_info": {
"input_point": [
140.08675905246008,
36.10188575945518
],
"match_point": [
140.0867965019893,
36.101858332322074
],
"on_road": true
},
"match_link": {
"adas": null,
"distance": 17.1,
"highway_info": null,
"limited_highway": false,
"line": {
"coordinates": [
140.0868158637153,
36.10184516059028,
140.086669921875,
36.10194444444444
],
"type": "LineString"
},
"link_id": "5150010000052336637",
"link_separation": true,
"link_type": {
"code": "8193",
"text": "本線,二条分離"
},
"mesh_code": "961989111524745216",
"names_mst": [
{
"name_mst": "国道４０８号線",
"nickname_type": 2,
"road_type_mst": 30
},
{
"name_mst": "学園西大通り",
"nickname_type": 3,
"road_type_mst": 80
}
],
"number_of_lanes": 2,
"order": "OE",
"road_name": "国道４０８号線",
"road_type": {
"code": "30",
"text": "一般国道"
},
"road_width": 8.12,
"road_width_average": 8.91,
"road_width_max": 10.69,
"road_width_min": 8.12,
"serv_link_code": "961989218383429766",
"structure": null,
"toll_road": false
}
}
]
},
"status": "OK"
}