premiumvics/traffic_info_coordinates
VICS地図重畳データ取得
緯度経度矩形範囲内の渋滞情報および事象・規制情報の座標情報を返却します。
渋滞形状に適用する色が決まっているため、返却値の「渋滞度」から判断して形状の色を使い分けてください。
「渋滞」：赤
「混雑」：橙
「渋滞なし」：「渋滞」「混雑」「不明」と識別できる色であれば、どの色でも可。
「不明」：「渋滞」「混雑」「渋滞なし」と識別できる色であれば、どの色でも可。
※カンマ区切りを許容するパラメータについては、無効値が含まれていた場合、エラーとして返却します。
※レスポンスサイズが10MBを超えるリクエストの場合、エラーとして返却します。
gzip圧縮でのレスポンス指定や矩形範囲の縮小等のリクエストをお願いいたします。
このAPIを利用するには基盤認証側でauthkeyに対して設定をする必要があります。
HTTP request method
POST/GET
ContentType
application/x-www-form-urlencoded
Parameters
*requiredは必須
| 名前 | 説明 |
|---|---|
|
llbounds*required string ※カンマ区切り |
緯度経度矩形範囲 情報を取得する範囲を 「左座標（経度）,上座標（緯度）,右座標(経度),下座標（緯度）」形式で指定します。 （単位は「測地系」「緯度経度形式」パラメータに依存） 経度の差分が2度を超える、または緯度の差分が2度を超える場合、エラーとなります。 |
|
info_type string default traffic ※カンマ区切り |
情報種別 取得する情報種別を指定します。複数指定する場合は「,」区切りで指定します。
|
|
traffic_type string default intercity,city ※カンマ区切り |
渋滞情報取得道路種別 取得する道路種別を指定します。複数指定する場合は「,」区切りで指定します。 パラメータ「情報種別」に「渋滞情報」が指定されている場合有効です（事象・規制情報に影響しません）。
|
|
traffic_level string default medium,high ※カンマ区切り |
渋滞度 取得する渋滞度を指定します。複数指定する場合は「,」区切りで指定します。 パラメータ「情報種別」に「渋滞情報」が指定されている場合有効です（事象・規制情報に影響しません）。
|
|
regulation_type string default intercity,city ※カンマ区切り |
事象・規制情報取得道路種別 取得する道路種別を指定します。複数指定する場合は「,」区切りで指定します。 パラメータ「情報種別」に「事象・規制情報」が指定されている場合有効です（渋滞情報に影響しません）。
|
|
datum string default JGD |
測地系 パラメータ「緯度経度矩形範囲」および返却するデータの測地系を指定します。
|
|
llunit string default dec |
緯度経度形式 パラメータ「緯度経度矩形範囲」および返却するデータの緯度経度形式を指定します。
|
Responses
エラーについては「エラーメッセージ一覧」を参照してください。
Media type:application/json
| キー名 | 説明 | ||||||
|---|---|---|---|---|---|---|---|
| status string |
ステータス（'OK'固定） | ||||||
| result object |
検索結果 | ||||||
| info object |
検索結果の情報 | ||||||
| update_time string |
更新日時 入力元の編集日時が入ります。 「yyMMddHHmmss（yyは西暦の下二桁）」形式で記述されます。 |
||||||
| traffic array[object] |
渋滞情報 | ||||||
| link_type object |
リンク区分 | ||||||
| value string |
リンク区分名称 JARTICが提供しているリンク区分名称が入ります。 「高速/都市高速/一般道/その他」 のいずれかが入ります。 |
||||||
| jam_level object |
渋滞度 | ||||||
| value string |
渋滞度名称 JARTICが提供している渋滞度名称が入ります。 「渋滞/混雑/渋滞なし/不明」 のいずれかが入ります。 |
||||||
| path_list array[array[number]] |
形状情報 | ||||||
| value array[number] |
渋滞形状 渋滞形状が入ります。 [0][2][4][6]・・・：経度 [1][3][5][7]・・・：緯度 |
||||||
| regulation_line array[object] |
事象・規則情報（線） | ||||||
| link_type object |
リンク区分 | ||||||
| value string |
リンク区分名称 JARTICが提供しているリンク区分名称が入ります。 「高速/都市高速/一般道/その他」 のいずれかが入ります。 |
||||||
| regulation object |
規制内容 | ||||||
| value string |
規制内容名称 JARTICが提供している規制内容名称が入ります。 |
||||||
| detail object |
規制詳細 |
||||||
| value string |
規制内容詳細名称 JARTICが提供している規制内容詳細名称が入ります。 |
||||||
| cause object |
原因事象 | ||||||
| value string |
原因事象名称 JARTICが提供している原因事象名称が入ります。 |
||||||
| detail object |
原因事象詳細 |
||||||
| value string |
原因事象詳細名称 JARTICが提供している原因事象詳細名称が入ります。 |
||||||
| regulation_time object |
規制時間帯情報 | ||||||
| zone string |
時間帯指定コード 時間帯指定コードが入ります。
|
||||||
| start string |
開始予定日時 開始予定日時が入ります。 「MM-DD hh:mm」形式で記述されます。 開始予定日時が不明の場合は空文字が入ります。 |
||||||
| end string |
終了予定日時 終了予定日時が入ります。 「MM-DD hh:mm」形式で記述されます。 終了予定日時が不明の場合は空文字が入ります。 |
||||||
| path_list array[object] |
形状情報 | ||||||
| value array[number] |
事象規制形状 事象規制形状が入ります。 [0][2][4][6]・・・：経度 [1][3][5][7]・・・：緯度 |
||||||
| regulation_point array[object] |
事象・規則情報（点） | ||||||
| link_type object |
リンク区分 | ||||||
| value string |
リンク区分名称 JARTICが提供しているリンク区分名称が入ります。 「高速/都市高速/一般道/その他」 のいずれかが入ります。 |
||||||
| regulation object |
規制内容 | ||||||
| value string |
規制内容名称 JARTICが提供している規制内容名称が入ります。 |
||||||
| detail object |
規制詳細 |
||||||
| value string |
規制内容詳細名称 JARTICが提供している規制内容詳細名称が入ります。 |
||||||
| cause object |
原因事象 | ||||||
| value string |
原因事象名称 JARTICが提供している原因事象名称が入ります。 |
||||||
| detail object |
原因事象詳細 |
||||||
| value string |
原因事象詳細名称 JARTICが提供している原因事象詳細名称が入ります。 |
||||||
| regulation_time object |
規制時間帯情報 | ||||||
| zone string |
時間帯指定コード 時間帯指定コードが入ります。
|
||||||
| start string |
開始予定日時 開始予定日時が入ります。 「MM-DD hh:mm」形式で記述されます。 開始予定日時が不明の場合は空文字が入ります。 |
||||||
| end string |
終了予定日時 終了予定日時が入ります。 「MM-DD hh:mm」形式で記述されます。 終了予定日時が不明の場合は空文字が入ります。 |
||||||
| path_list array[object] |
形状情報 | ||||||
| value array[number] |
事象規制形状 事象規制形状が入ります。 [0][2][4][6]・・・：経度 [1][3][5][7]・・・：緯度 |
||||||
Media type:application/json
| キー名 | 説明 |
|---|---|
| status string |
ステータス |
| message object |
エラーメッセージ エラー内容が分かるメッセージを出力します。 |
Example
https://[domain]/route/vics/traffic_info_coordinates?llbounds=139.625,35.6666667,139.75,35.5833333&info_type=regulation,traffic&traffic_type=intercity,city,local,other&traffic_level=high,medium,low,unknown®ulation_type=intercity,city,local,other
{
"status": "OK",
"result": {
"info": {
"update_time": "250807090055"
},
"traffic": [
{
"link_type": {
"value": "都市高速"
},
"jam_level": {
"value": "混雑"
},
"path_list": [
{
"polyline": [
139.67890570746528,
35.64774468315972,
139.67935085720487,
35.6480126953125,
139.6796875,
35.64819390190972,
139.68017578125,
35.64845540364583,
139.6810099283854,
35.64890190972222,
139.68194986979168,
35.649395345052085,
139.68344672309027,
35.650180121527775,
139.68411458333333,
35.650531412760415
]
},
{
"polyline": [
139.69790771484375,
35.65632893880208,
139.6976247829861,
35.65624972873264,
139.69756564670138,
35.65623372395833,
139.69711371527777,
35.65612901475694,
139.69573106553818,
35.65583279079861,
139.69530598958335,
35.65569607204861,
139.69500569661457,
35.65554985894097,
139.6947238498264,
35.655352647569444,
139.6944099934896,
35.65504421657986,
139.69383734809028,
35.65437228732639,
139.69357584635418,
35.65413628472222,
139.6933802625868,
35.653994140625,
139.6931884765625,
35.65388536241319,
139.6928195529514,
35.653713921440975,
139.69278211805556,
35.6536962890625,
139.69155490451388,
35.65332763671875,
139.691162109375,
35.65321370442708,
139.69063096788196,
35.65306070963542
]
},
{
"polyline": [
139.6843315972222,
35.65046820746528,
139.6835470920139,
35.6500377061632,
139.68176215277776,
35.64909098307292,
139.68106472439237,
35.64873426649306
]
},
{
"polyline": [
139.68106472439237,
35.64873426649306,
139.68017578125,
35.64825954861111,
139.6796875,
35.647998046875,
139.67570963541667,
35.645869683159724
]
},
{
"polyline": [
139.68813685756342,
35.650519556227145,
139.68820455936614,
35.65058330658345,
139.6882420921091,
35.65063570131088,
139.68824640542158,
35.650644781975814,
139.68827622669212,
35.65070416297402,
139.68829493253108,
35.6507815142762,
139.68829236234697,
35.65084011392145,
139.68828979481256,
35.6508870994471,
139.6882630321618,
35.650979599353526,
139.68823978180245,
35.65103106358727,
139.68820831991988,
35.65109398730517,
139.688170916497,
35.65115205412456,
139.68808700925578,
35.651259518873,
139.68800567927164,
35.65133553314815,
139.687986678565,
35.65135317665647,
139.68794483758901,
35.65139236945884,
139.68783083627147,
35.65148012394306,
139.68774646678827,
35.65153085075872,
139.68761801273735,
35.65159561300215,
139.68753185854666,
35.65163499022147,
139.68748641890895,
35.65165048697528,
139.68745849791154,
35.651660477056744,
139.6873237724194,
35.65169297892625,
139.6871890846033,
35.65170595463147,
139.68711192663977,
35.65170075880801,
139.68702047780366,
35.651694151234075,
139.68685657327435,
35.651663092893735,
139.68638935707523,
35.65146143809383,
139.68624119034774,
35.65138668002504,
139.68548741409202,
35.6510176607304,
139.68484933790552,
35.65070553764782,
139.68466429496948,
35.65061179701952,
139.68455889508311,
35.6505582863141,
139.6843498508366,
35.65044564072277
]
},
{
"polyline": [
139.68916526042705,
35.65998339778094,
139.68900282118054,
35.6601806640625,
139.68821967230903,
35.66113281250001,
139.6880170355903,
35.661458604600696,
139.6879150390625,
35.66162109375001,
139.68785210503472,
35.66172281901043,
139.68766574435764,
35.66233045789931,
139.68763346354166,
35.662776963975695,
139.68763346354166,
35.66282253689236,
139.68775282118057,
35.66389268663195,
139.68780924479168,
35.6646115451389,
139.6878453233507,
35.6655677625868,
139.6878333875868,
35.66641276041666,
139.68782660590279,
35.666666124131936,
139.68778374565974,
35.66811984592014,
139.68775146484379,
35.66902398003474
]
}
]
},
{
"link_type": {
"value": "都市高速"
},
"jam_level": {
"value": "渋滞"
},
"path_list": [
{
"polyline": [
139.6781089952257,
35.647320692274306,
139.67890570746528,
35.64774468315972
]
},
{
"polyline": [
139.69063096788196,
35.65306070963542,
139.69049289279513,
35.65301784939236,
139.68999131944443,
35.652867567274306,
139.6893891059028,
35.652674424913194,
139.68749945746526,
35.652042914496526,
139.68732503255208,
35.65198377821181,
139.68674560546876,
35.65174235026041,
139.68617567274305,
35.651468912760414,
139.6856138780382,
35.65116834852431,
139.68538194444446,
35.65104085286458,
139.68463894314237,
35.650634765625,
139.684541015625,
35.6505810546875,
139.6843315972222,
35.65046820746528
]
},
{
"polyline": [
139.66948847654447,
35.64174001294843,
139.66978217230903,
35.64214002821181,
139.67056125217016,
35.64305202907986,
139.67091796875,
35.643397894965275,
139.67104682074654,
35.64349853515626,
139.67118082682288,
35.64358452690973,
139.67141682942707,
35.64371853298613,
139.67187418619793,
35.643913031684036,
139.67237847222222,
35.644126247829874,
139.6728021918403,
35.644335394965275,
139.6744677734375,
35.64537896050347,
139.67528862847223,
35.645833604600696,
139.67621934678817,
35.64634711371529,
139.6776087782118,
35.647090115017356,
139.67769585503473,
35.647134331597236,
139.67797634548614,
35.647256401909715,
139.6781089952257,
35.647320692274306
]
},
{
"polyline": [
139.68686631944445,
35.6509632703993,
139.6868435329861,
35.651044921875,
139.68682345920138,
35.65113742404514,
139.6868221028646,
35.65123155381944,
139.68683566623264,
35.65129720052084,
139.68686903211807,
35.65136962890625,
139.68691080729167,
35.651439344618055,
139.68695095486112,
35.65148220486111,
139.68695638020833,
35.65148763020834,
139.68701388888888,
35.651522352430554,
139.68709852430555,
35.65155870225694,
139.68711046006945,
35.65156277126736,
139.6872043185764,
35.65159613715278,
139.68728352864582,
35.6516162109375,
139.68738416883681,
35.65162570529514,
139.6874712456597,
35.65162163628472,
139.68749945746526,
35.65161892361111,
139.6875355360243,
35.65161376953125,
139.68761067708334,
35.65159749348958,
139.6877113172743,
35.651561414930555,
139.6877796766493,
35.65152777777778,
139.68783474392362,
35.651500922309026,
139.6879044596354,
35.65146620008681,
139.68796196831596,
35.65142849392361,
139.68802517361112,
35.651380208333336,
139.68808132595487,
35.65133734809028,
139.68811089409724,
35.65130913628472,
139.68814995659721,
35.6512744140625,
139.688212890625,
35.651209852430554,
139.6882666015625,
35.65115370008681,
139.68831353081598,
35.651083984375,
139.6883363172743,
35.65104085286458,
139.68834174262153,
35.651028917100696,
139.6883683268229,
35.650967339409725,
139.68838189019098,
35.65091634114583,
139.68839382595485,
35.650838487413196,
139.68837917751736,
35.65074055989583,
139.68834174262153,
35.650653483072915,
139.68833089192708,
35.650634765625,
139.68828938802082,
35.65056613498264,
139.68820203993056,
35.65048855251736,
139.68814181857638,
35.650448133680555,
139.68808403862846,
35.65041748046875,
139.68800238715278,
35.6503919813368,
139.68787896050347,
35.650365125868056,
139.6877823893229,
35.65035834418403,
139.68768174913194,
35.650371907552085,
139.68758517795138,
35.650394694010416,
139.68749945746526,
35.650419921875,
139.68747938368057,
35.65042670355903,
139.68736518012153,
35.65048448350694,
139.68721652560765,
35.65056613498264,
139.68711588541666,
35.650634765625,
139.6870876736111,
35.650653483072915,
139.68698567708333,
35.650737847222224,
139.68690538194446,
35.65081841362847,
139.68683837890626,
35.65090413411458,
139.68680202907987,
35.65096869574653,
139.6867765299479,
35.6510302734375,
139.68677381727431,
35.65104085286458,
139.6867591688368,
35.651089138454864,
139.6867550998264,
35.65114420572917,
139.6867578125,
35.651217990451386,
139.68676974826388,
35.651294487847224,
139.6868207465278,
35.65139241536458,
139.6868812391493,
35.651468912760414,
139.68694146050348,
35.65152506510417,
139.68703016493055,
35.65159478081597,
139.68749945746526,
35.651790635850695,
139.6875531684028,
35.651813422309026,
139.68838460286457,
35.65214463975695,
139.6887117513021,
35.65230685763889,
139.68889675564236,
35.65241970486111,
139.68907389322916,
35.65255642361111,
139.68938232421874,
35.65285563151042,
139.68941596137154,
35.65290907118055,
139.68943874782985,
35.65296142578125,
139.68946668836804,
35.653095431857636,
139.6894908311632,
35.65325927734375,
139.6895111762153,
35.65358235677083,
139.6896129014757,
35.65410536024306,
139.68963840060763,
35.654215494791664,
139.68970024956596,
35.65435628255209,
139.6897536892361,
35.654454210069446,
139.68998996310765,
35.6548402235243,
139.69007432725695,
35.65499864366319
]
},
{
"polyline": [
139.69007432725695,
35.654998643663205,
139.69038140190972,
35.65559950086805,
139.69063747829858,
35.65611843532985,
139.69069390190975,
35.65624972873264,
139.6908509657118,
35.6566078016493,
139.69092447916665,
35.65691758897569,
139.69094482421875,
35.657113444010406,
139.69093939887154,
35.65725151909722,
139.69093668619792,
35.65734157986111,
139.69089653862844,
35.65757486979165,
139.69082411024306,
35.65781629774305,
139.690735405816,
35.658012152777786,
139.69058539496527,
35.658258734809024,
139.68916526042705,
35.65998339778094
]
},
{
"polyline": [
139.69258490668403,
35.64867648654514,
139.69189154730904,
35.64909233940972,
139.69160047743057,
35.649272189670135,
139.69135498046876,
35.64945041232639,
139.691162109375,
35.649615342881944,
139.69102376302084,
35.64973334418403,
139.69007703993054,
35.650634765625,
139.69004475911458,
35.65066541883681,
139.68986382378472,
35.6509632703993,
139.68984375,
35.65104085286458,
139.68978190104167,
35.65128499348958,
139.68974175347222,
35.65210856119791,
139.68962103949653,
35.65357828776042,
139.68972032335068,
35.65409206814236,
139.68975504557292,
35.654239637586805,
139.68984375,
35.65449028862847,
139.68996446397568,
35.65477322048611,
139.69007432725695,
35.65499864366319
]
}
]
}
]
}
}