VICS情報取得

API名: 
vics
概要: 

指定した緯度経度矩形範囲のVICS情報を返却します。

※この機能を利用するには別途契約が必要です。

URI: 

http://core.its-mo.com/zmaps/api/apicore/core/v1_0/vics

<API使用例>
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/vics?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&llbounds=35.673511,139.761734,35.682777,139.776898&infotype=traffic

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
llbounds - 緯度経度矩形範囲
検索する緯度経度矩形範囲を指定します。
十進度緯度経度表記で2度相当を超える範囲を検索した場合、エラーとなります。
infotype   traffic 情報種別
取得する情報種別を指定します。複数指定できます。
種別 説明
traffic 渋滞情報
regulation 事象・規制情報
traffictype   intercity,city 渋滞情報取得道路種別
渋滞情報を取得する道路種別を指定します。複数指定できます。
指定した道路種別の渋滞情報のみ取得します。
事象・規制情報パラメータには影響しません。
種別 説明
intercity 都市間高速道路
city 都市高速道路
local 一般道路
other その他
trafficlevel   medium,high 渋滞度
取得する渋滞度を指定します。複数指定できます。
指定した道路種別の渋滞情報のみ取得します。
事象・規制情報パラメータには影響しません。
種別 説明
unknown 不明
low 渋滞無し
medium 混雑
high 渋滞
regulationtype   intercity,city 事象・規制情報取得道路種別
事象・規制情報を取得する道路種別を指定します。複数指定できます。
指定した道路種別の事象・規制情報のみ取得します。
渋滞情報パラメータには影響しません。
種別 説明
intercity 都市間高速道路
city 都市高速道路
local 一般道路
other その他
datum   TOKYO 測地系
返却される住所代表点の測地系を指定します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。
 

出力データ
出力フォーマット
{"status":"OK",
 "info":{"updateTime": "201712111918"},
 "traffic": [{"linkType": {"code": "intercity",
                           "text": "都市間高速道路"},
              "trafficLevel": {"code": "medium",
                               "text": "混雑"},
              "pathList": [{"point": {"lat": 35.6776481,
                                      "lon": 139.7286531},
                            "polyline": [35.6776481,139.7286531,
                                         35.677685,139.7287453,
                                         35.6777081,139.7287933,
                                         35.6774461,139.7301558]},
                           {"point": {"lat": 35.6625519,
                                      "lon": 139.7418292},
                            "polyline": [35.6625519,139.7418292,
                                         35.662555,139.7418261,
                                         35.6625628,139.7418131]},
                           {"point": {"lat": 35.6646322,
                                      "lon": 139.7430803},
                            "polyline": [35.6646322,139.7430803,
                                         35.6645997,139.7430544,
                                         35.6645625,139.7430278]}]}
            ],
 "regulation": [{"linkType": {"code": "intercity",
                              "text": "都市間高速道路"},
                 "content": {"code": "4",
                             "text": "車線規制",
                             "description": "登坂+走行1"},
                 "cause": {"code": "5",
                           "text": "工事",
                           "description": "法面工事"},
                 "time": {"type": "0",
                          "start": "12-11 17:32",
                          "end": null},
                 "pathList": [{"point": {"lat": 35.6753794,
                                         "lon": 139.7784197},
                               "polyline": [35.6753794,139.7784197,
                                            35.6754233,139.7784456,
                                            35.6754406,139.7784569,
                                            35.6754944,139.7784867]}]}
               ]}
キー名 データ型 説明
status     string ステータス情報が入ります。
OK 正常終了
info     object 検索結果の情報が入ります。
  updateTime   string 情報更新時間が入ります。
traffic     array 渋滞情報の配列が入ります。
結果が0件の場合またはクエリパラメータinfotypeにtrafficを
指定しない場合は 空の配列となります。
  linkType   object リンク区分が入ります。
    code string リンク区分コードが入ります。
intercity 都市間高速道路
city 都市高速道路
local 一般道路
other その他
    text string リンク区分名称が入ります。
  trafficLevel   object 渋滞度が入ります。
    code string 渋滞度コードが入ります。
unknown 不明
low 渋滞無し
medium 混雑
high 渋滞
    text string 渋滞度の名称が入ります。
  pathList   array 座標データが配列で入ります。
経路形状情報が無い場合nullとなります。
座標データの並び順に規則性はありません。
    point object 代表点緯度経度が入ります。
    polyline object 経路形状情報が入ります。
regulation     array 事象・規則情報の配列が入ります。
  linkType   object リンク区分が入ります。
    code string リンク区分コードが入ります。
intercity 都市間高速道路
city 都市高速道路
local 一般道路
other その他
    text string リンク区分名称が入ります。
  content   object 規制内容が入ります。
    code string 規制コードが入ります。
0 規制なし
1 通行止め
2 右左折規制
3 速度規制
4 車線規制
5 片側規制
6 チェーン規制
7 オンランプ規制
8 大型通行止め
9 移動規制
10 オフランプ規制
14 その他交通規制
15 不明
    text string 規制名称が入ります。
    description string 規制内容の詳細が入ります。
  cause   object 原因事象内容が入ります。
    code string 原因事象コードが入ります。
0 原因事象無し
1 事故
2 火災
3 故障車
4 路上障害物
5 工事
6 作業
7 行事等
8 気象条件
9 災害等
10 地震警戒宣言
14 その他
15 不明
    text string 原因事象名称が入ります。
    description string 原因事象内容の詳細が入ります。
  time   object 規制時間帯情報が入ります。
    type string 時間帯識別コードが入ります。
0 規制時間帯内で連続的に規制されます
1 時勢時間帯内で断続的に規制されます
    start string 開始予定日時が入ります。
MM-DD hh:mmの形式で記述されます。
不明の場合nullとなります。
    end string 終了予定日時が入ります。
MM-DD hh:mmの形式で記述されます。
不明の場合nullとなります。
  pathList   array 座標データが配列で入ります。
経路形状情報が無い場合nullとなります。
座標データの並び順に規則性はありません。
    point object 代表点緯度経度が入ります。
    polyline object 経路形状情報が入ります。
出力例

[渋滞情報のみの場合]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/vics?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
llbounds=35.673511,139.761734,35.682777,139.776898&infotype=traffic

{"status":"OK",
 "info":{"updateTime":"201802051524"},
 "traffic":[{"linkType":{"code":"city",
                         "text":"都市高速道路"},
             "trafficLevel":{"code":"medium",
                             "text":"混雑"},
             "pathList":[{"point":{"lat":35.682775,
                                   "lon":139.7737886},
                          "polyline":[35.682775,139.7737886,
                                      35.6819722,139.7741247,
                                      35.6819056,139.7741636,
                                      35.6818361,139.7742164,
                                      35.6816972,139.7743553,
                                      35.6815861,139.7744997,
                                      35.6815444,139.7745664,
                                      35.6814944,139.7746581,
                                      35.6814278,139.7748497,
                                      35.6810222,139.7768942]}]}],
 "regulation":[]}

[事象・規制情報のみの場合]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/vics?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
llbounds=35.665941111,139.708885833,35.696376667,139.7547525&infotype=regulation

{"status":"OK",
 "info":{"updateTime":"201802051530"},
 "traffic":[],
 "regulation":[{"linkType":{"code":"local",
                            "text":"一般道路"},
                "content":{"code":"4",
                           "text":"車線規制",
                           "description":"詳細なし"},
                "cause":{"code":"6",
                         "text":"作業",
                         "description":"詳細なし"},
                "time":{"type":"0",
                        "start":"02-05 09:42",
                        "end":"02-05 17:00"},
                "pathList":[{"point":{"lat":35.6767581,
                                      "lon":139.7168506},
                             "polyline":[35.6767581,139.7168506,
                                         35.6771497,139.7168867,
                                         35.6773192,139.7169117]}]},
               {"linkType":{"code":"local",
                            "text":"一般道路"},
                "content":{"code":"4",
                           "text":"車線規制",
                           "description":"詳細なし"},
                "cause":{"code":"6",
                         "text":"作業",
                         "description":"詳細なし"},
                "time":{"type":"0",
                        "start":"02-05 09:21",
                        "end":"02-05 17:00"},
                "pathList":[{"point":{"lat":35.6824544,
                                      "lon":139.7334214},
                             "polyline":null},
                            {"point":{"lat":35.6825817,
                                      "lon":139.7334672},
                             "polyline":[35.6825817,139.7334672,
                                         35.68249,139.7340228,
                                         35.6824539,139.7342756,
                                         35.6823983,139.7345644,
                                         35.6823678,139.734695,
                                         35.6819456,139.7358172,
                                         35.6817011,139.73642,
                                         35.6815289,139.7367617,
                                         35.68109,139.7375339,
                                         35.6810206,139.7376922,
                                         35.6809233,139.7380144,
                                         35.6808622,139.7383172,
                                         35.6807706,139.7392811,
                                         35.6807289,139.7400339,
                                         35.6807289,139.7408978,
                                         35.6808511,139.7422172,
                                         35.6809233,139.7427506,
                                         35.6810206,139.7436672,
                                         35.6810456,139.7440256,
                                         35.6810456,139.7443311,
                                         35.6810344,139.7446894,
                                         35.6807706,139.7471228]}]}]}

[渋滞情報、事象・規制情報両方の場合]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/vics?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
llbounds=35.665941111,139.708885833,35.725287778,139.791053333&infotype=traffic,regulation

{"status":"OK",
 "info":{"updateTime":"201802051502"},
 "traffic":[{"linkType":{"code":"city",
                         "text":"都市高速道路"},
             "trafficLevel":{"code":"medium",
                             "text":"混雑"},
             "pathList":[{"point":{"lat":35.6871847,
                                   "lon":139.7653733},
                          "polyline":[35.6871847,139.7653733,
                                      35.6873181,139.76509,
                                      35.6876375,139.7645344,
                                      35.6877597,139.7642733,
                                      35.6878042,139.7641372,
                                      35.6878625,139.7639233,
                                      35.6878819,139.7637706,
                                      35.6878875,139.7636261]},
                         {"point":{"lat":35.6856844,
                                   "lon":139.7699206},
                          "polyline":[35.6856844,139.7699206,
                                      35.6856678,139.7701094,
                                      35.6856039,139.7705761,
                                      35.6855567,139.7707733,
                                      35.6855011,139.7709428,
                                      35.6852872,139.77134,
                                      35.6850539,139.7717122,
                                      35.684815,139.7720483,
                                      35.6846372,139.7722483,
                                      35.6835733,139.77324,
                                      35.6832567,139.7734983,
                                      35.6830733,139.7736289,
                                      35.68284,139.7737567,
                                      35.6825206,139.7738956,
                                      35.6819706,139.7741233,
                                      35.6819039,139.7741622,
                                      35.6818344,139.774215,
                                      35.6816956,139.7743539,
                                      35.6815844,139.7744983,
                                      35.6815428,139.774565,
                                      35.6814928,139.7746567,
                                      35.6814261,139.7748483,
                                      35.680965,139.7771844,
                                      35.6808872,139.7776706]},
                         {"point":{"lat":35.6792503,
                                   "lon":139.7807467},
                          "polyline":[35.6792503,139.7807467,
                                      35.6793614,139.7808078,
                                      35.6803975,139.7814578,
                                      35.6804531,139.7814633,
                                      35.6805253,139.78148,
                                      35.6806475,139.7814633,
                                      35.6807392,139.7814411,
                                      35.6808308,139.7813967,
                                      35.6809058,139.7813272,
                                      35.6809531,139.7812744,
                                      35.6810336,139.7810828,
                                      35.6810753,139.7809467,
                                      35.6810753,139.7807939,
                                      35.6810642,139.78058,
                                      35.6810336,139.7802744,
                                      35.6810281,139.7801522]},
                         {"point":{"lat":35.6769056,
                                   "lon":139.7855608},
                          "polyline":[35.6769056,139.7855608,
                                      35.6768722,139.7857608,
                                      35.6768722,139.7859192,
                                      35.6768806,139.7860581,
                                      35.6769472,139.7862719,
                                      35.6771861,139.7868747,
                                      35.6774111,139.7873386,
                                      35.6782444,139.7891636,
                                      35.6785389,139.7898886,
                                      35.678925,139.7907192,
                                      35.6790889,139.7910469]}]},
            {"linkType":{"code":"city",
                         "text":"都市高速道路"},
             "trafficLevel":{"code":"high",
                             "text":"渋滞"},
             "pathList":[{"point":{"lat":35.6808778,
                                   "lon":139.7784653},
                          "polyline":[35.6808778,139.7784653,
                                      35.6810111,139.7790153,
                                      35.6810583,139.7792958,
                                      35.6812389,139.7802569,
                                      35.6812861,139.7805708,
                                      35.6812861,139.7806181,
                                      35.6813361,139.7809681,
                                      35.6813278,139.7812042,
                                      35.6812694,139.7813875,
                                      35.6811833,139.7815931,
                                      35.6807417,139.7823875,
                                      35.68065,139.7825236,
                                      35.6805278,139.7827292,
                                      35.6804611,139.7827986,
                                      35.6803444,139.7829069,
                                      35.6802139,139.7829903,
                                      35.6801,139.7830347,
                                      35.6795361,139.7831958,
                                      35.6788556,139.7834014,
                                      35.6787778,139.7834181,
                                      35.6787083,139.7834403,
                                      35.6784028,139.7836153,
                                      35.6781944,139.7837819,
                                      35.6780556,139.7839347,
                                      35.6779194,139.7841042,
                                      35.6776139,139.7844319,
                                      35.6771667,139.7849569,
                                      35.6770389,139.7851264,
                                      35.6769722,139.7852847,
                                      35.6769278,139.7854236,
                                      35.6769056,139.7855597]},
                         {"point":{"lat":35.6792503,
                                   "lon":139.7807467},
                          "polyline":[35.6792503,139.7807467,
                                      35.6794531,139.7809467,
                                      35.6797225,139.7811522,
                                      35.6802114,139.7814633,
                                      35.6803114,139.7815717,
                                      35.6803892,139.7816411,
                                      35.6804892,139.7817772,
                                      35.6805725,139.7818772,
                                      35.6806475,139.7819994,
                                      35.6806836,139.7821133,
                                      35.6807031,139.7822272,
                                      35.6807031,139.7823494,
                                      35.6806947,139.7824633,
                                      35.6806669,139.7825772,
                                      35.6806169,139.7826856,
                                      35.6805364,139.7828217,
                                      35.6804447,139.7829217,
                                      35.6803225,139.7830217,
                                      35.6802003,139.7830883,
                                      35.6799614,139.7831744,
                                      35.6789781,139.7834411,
                                      35.6787864,139.7835078,
                                      35.6784447,139.7836856,
                                      35.6780531,139.7839356]}]}],
 "regulation":[{"linkType":{"code":"local",
                            "text":"一般道路"},
                "content":{"code":"4",
                           "text":"車線規制",
                           "description":"詳細なし"},
                "cause":{"code":"5",
                         "text":"工事",
                         "description":"詳細なし"},
                "time":{"type":"0",
                        "start":"02-05 09:45",
                        "end":"02-05 17:00"},
                "pathList":[{"point":{"lat":35.7077333,
                                      "lon":139.7877733},
                             "polyline":[35.7077333,139.7877733,35.7076583,139.7882622]}]},
               {"linkType":{"code":"local",
                            "text":"一般道路"},
                "content":{"code":"4",
                           "text":"車線規制",
                           "description":"詳細なし"},
                "cause":{"code":"6",
                         "text":"作業",
                         "description":"詳細なし"},
                "time":{"type":"0",
                        "start":"02-05 09:42",
                        "end":"02-05 17:00"},
                "pathList":[{"point":{"lat":35.6767581,
                                      "lon":139.7168506},
                             "polyline":[35.6767581,139.7168506,
                                         35.6771497,139.7168867,
                                         35.6773192,139.7169117]}]},
               {"linkType":{"code":"local",
                            "text":"一般道路"},
                "content":{"code":"4",
                           "text":"車線規制",
                           "description":"詳細なし"},
                "cause":{"code":"6",
                         "text":"作業",
                         "description":"詳細なし"},
                "time":{"type":"0",
                        "start":"02-05 09:21",
                        "end":"02-05 17:00"},
                "pathList":[{"point":{"lat":35.6824544,
                                      "lon":139.7334214},
                             "polyline":null},
                            {"point":{"lat":35.6825817,
                                      "lon":139.7334672},
                             "polyline":[35.6825817,139.7334672,
                                         35.68249,139.7340228,
                                         35.6824539,139.7342756,
                                         35.6823983,139.7345644,
                                         35.6823678,139.734695,
                                         35.6819456,139.7358172,
                                         35.6817011,139.73642,
                                         35.6815289,139.7367617,
                                         35.68109,139.7375339,
                                         35.6810206,139.7376922,
                                         35.6809233,139.7380144,
                                         35.6808622,139.7383172,
                                         35.6807706,139.7392811,
                                         35.6807289,139.7400339,
                                         35.6807289,139.7408978,
                                         35.6808511,139.7422172,
                                         35.6809233,139.7427506,
                                         35.6810206,139.7436672,
                                         35.6810456,139.7440256,
                                         35.6810456,139.7443311,
                                         35.6810344,139.7446894,
                                         35.6807706,139.7471228]}]}]}

[検索結果が0件の場合]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/vics?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&
llbounds=35.673511,139.761734,35.682777,139.776898

{"status":"OK",
 "info":{"updateTime":null},
 "traffic":[],
 "regulation":[]}