V2N 가이던스 (제공)

1. V2N 가이던스 제공 API (GetV2NGuidance)

요청 URL

https://service.mqnicrnd5.com/api/v1/vgm/offer/gvg

연계 주기

정보 제공 시

프로토콜

HTTPS

HTTP 메서드

GET

데이터 포맷

140KB

v2n가이던스_제공(gvg).pdf

PDF

Open

참고사항

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": "지체"
                }
            }
        }
    ]
}