V2N 가이던스 (제공)
1. V2N 가이던스 제공 API (GetV2NGuidance)
요청 URL
https://service.mqnicrnd5.com/api/v1/vgm/offer/gvg연계 주기
정보 제공 시
프로토콜
HTTPS
HTTP 메서드
GET
데이터 포맷
참고사항
API를 요청할 때 다음 예와 같이 HTTP 요청 헤더에 접근 토큰(Access Token) 을 추가해야 합니다. 접근 토큰 앞에 "Bearer " 문자열을 추가해야 한다는 점에 주의하세요.
> GET /api/v1/vgm/offer/gvg?reqDttm=202510011450&locgovId=233 HTTP/2
> Host: service.mqnicrnd5.com
> User-Agent: curl/7.64.1
> Accept: */*
> Authorization: Bearer <접근 토큰>요청 예시
curl --location 'https://service.mqnicrnd5.com/api/v1/vgm/offer/gvg?reqDttm=202510011450&locgovId=233' \
--header 'Authorization: Bearer <접근 토큰>'응답 예시
{
"index": "1092",
"timestamp": "20251001145013",
"linkBasedGuidanceList": [
{
"linkInfo": {
"linkId": "3250012805",
"lanes": 2,
"roadRank": "105",
"roadType": "000",
"roadName": "덕양로",
"maxSpd": 30,
"cits": "0",
"f_node": "3250006310",
"t_node": "3250006309"
},
"roadTrafficInfo": {
"trafficStatus": "정체",
"speedPerLaneList": [
{
"laneNumber": 1,
"speed": 60
},
{
"laneNumber": 2,
"speed": 70
}
]
},
"laneClosureInfo": {
"location": {
"latitude": 127.0022755,
"longitude": 37.58041311
},
"eventType": "낙석",
"impactDistance": 0,
"closureStatusList": [
{
"laneNumber": 1,
"trafficStatus": "차로차단"
},
{
"laneNumber": 2,
"trafficStatus": "원활"
}
],
"startTime": "20251001145013",
"endTime": "20250804180000",
"bypassInfo": {
"linkId": "1000023001",
"roadName": "동탄대로",
"trafficStatus": "지체"
}
},
"roadClosureInfo": {
"closureStartLocation": {
"latitude": 127.0022755,
"longitude": 37.58041311
},
"closureEndLocation": {
"latitude": 127.0022755,
"longitude": 37.58041311
},
"distanceClosed": 50,
"startTime": "20251001145013",
"endTime": "20250804180000",
"bypassInfo": {
"linkId": "1000023001",
"roadName": "동탄대로",
"trafficStatus": "지체"
}
},
"congestionInfo": {
"startTime": "20251001145013",
"endTime": "20250804180000",
"bypassInfo": {
"linkId": "1000023001",
"roadName": "동탄대로",
"trafficStatus": "지체"
}
},
"decelerationInfo": {
"weather": "눈",
"visibleDistance": 100,
"precipitation": 50,
"roadSurface": "눈",
"decelerationSuggestion": 20,
"startTime": "20251001145013",
"endTime": "20250804180000"
},
"shoulderLaneInfo": {
"startTime": "20251001145013",
"endTime": "20250804180000"
}
},
{
"linkInfo": {
"linkId": "4050582500",
"lanes": 2,
"roadRank": "106",
"roadType": "000",
"roadName": "조천우회로",
"maxSpd": 70,
"cits": "1",
"f_node": "4050175904",
"t_node": "4051545400"
},
"roadTrafficInfo": {
"trafficStatus": "정체",
"speedPerLaneList": [
{
"laneNumber": 1,
"speed": 60
},
{
"laneNumber": 2,
"speed": 70
}
]
},
"laneClosureInfo": {
"location": {
"latitude": 127.0022755,
"longitude": 37.58041311
},
"eventType": "낙석",
"impactDistance": 0,
"closureStatusList": [
{
"laneNumber": 1,
"trafficStatus": "차로차단"
},
{
"laneNumber": 2,
"trafficStatus": "원활"
}
],
"startTime": "20251001145013",
"endTime": "20250804180000",
"bypassInfo": {
"linkId": "1000023001",
"roadName": "동탄대로",
"trafficStatus": "지체"
}
},
"roadClosureInfo": {
"closureStartLocation": {
"latitude": 127.0022755,
"longitude": 37.58041311
},
"closureEndLocation": {
"latitude": 127.0022755,
"longitude": 37.58041311
},
"distanceClosed": 50,
"startTime": "20251001145013",
"endTime": "20250804180000",
"bypassInfo": {
"linkId": "1000023001",
"roadName": "동탄대로",
"trafficStatus": "지체"
}
},
"congestionInfo": {
"startTime": "20251001145013",
"endTime": "20250804180000",
"bypassInfo": {
"linkId": "1000023001",
"roadName": "동탄대로",
"trafficStatus": "지체"
}
},
"decelerationInfo": {
"weather": "비",
"visibleDistance": 100,
"precipitation": 50,
"roadSurface": "젖음",
"decelerationSuggestion": 20,
"startTime": "20251001145013",
"endTime": "20250804180000"
},
"shoulderLaneInfo": {
"startTime": "20251001145013",
"endTime": "20250804180000"
}
}
],
"nodeBasedGuidanceList": [
{
"nodeInfo": {
"nodeId": "1510224500",
"nodeType": "104",
"nodeName": "둔산교(남측)",
"latitude": 36.35226813,
"longitude": 127.3871683
},
"trafficSignalInfoList": [
{
"turnDirectionId": "DunsanBridge-10030-1",
"vehicleTrafficSignal": {
"red": 30,
"yellow": 3,
"green": 120
},
"pedTrafficSignal": {
"red": 27,
"green": 123
}
},
{
"turnDirectionId": "DunsanBridge-10030-2",
"vehicleTrafficSignal": {
"red": 35,
"yellow": 3,
"green": 125
},
"pedTrafficSignal": {
"red": 26,
"green": 124
}
},
{
"turnDirectionId": "DunsanBridge-10030-3",
"vehicleTrafficSignal": {
"red": 40,
"yellow": 3,
"green": 130
},
"pedTrafficSignal": {
"red": 25,
"green": 125
}
},
{
"turnDirectionId": "DunsanBridge-10030-4",
"vehicleTrafficSignal": {
"red": 45,
"yellow": 3,
"green": 135
},
"pedTrafficSignal": {
"red": 24,
"green": 126
}
}
]
},
{
"nodeInfo": {
"nodeId": "2920010302",
"nodeType": "101",
"nodeName": "추정삼거리",
"latitude": 36.17717201,
"longitude": 127.473238
},
"trafficSignalInfoList": [
{
"turnDirectionId": "Chujeong-40430-1",
"vehicleTrafficSignal": {
"red": 30,
"yellow": 3,
"green": 120
},
"pedTrafficSignal": {
"red": 27,
"green": 123
}
},
{
"turnDirectionId": "Chujeong-40430-2",
"vehicleTrafficSignal": {
"red": 34,
"yellow": 3,
"green": 124
},
"pedTrafficSignal": {
"red": 26,
"green": 124
}
}
],
"roundaboutEventInfo": {
"location": {
"latitude": 127.0022755,
"longitude": 37.58041311
},
"eventType": "긴급공사",
"directionalStatusList": [
{
"rotaryDirectionId": "Chujeong-40430-1",
"closureStartTime": "20250804163000",
"closureEndTime": "20250804173000",
"trafficStatus": "정체"
},
{
"rotaryDirectionId": "Chujeong-40430-2",
"closureStartTime": "20250804163000",
"closureEndTime": "20250804173000",
"trafficStatus": "지체"
},
{
"rotaryDirectionId": "Chujeong-40430-3",
"closureStartTime": "20250804163000",
"closureEndTime": "20250804173000",
"trafficStatus": "원활"
}
],
"bypassInfo": {
"linkId": "1000023001",
"roadName": "양평대로",
"trafficStatus": "지체"
}
}
}
]
}Last updated