8. 메세지 포맷¶
이 매뉴얼은 Open V2N Service Device (이하 OVC)와 OVSE 플랫폼이 MQTTS 프로토콜 기반으로 연동하기 위한 메세지 포맷에 대해서 정의합니다.
Entity 등록을 위한 HTTP Rest API 사용은 5. 구성요소(Entity) 등록 문서를, App 개발자를 위한 OVSE API 는 7. API 규격 문서를, 단말의 연동 절차를 위해서는 6. Device 연동 절차 문서를 참고하시기 바랍니다.
Note
본 장에 명세된 표 내용 중 M / O 는 Mandatory / Optional 의 약자로, Mandatory는 필수로 포함해야 하는 데이터를 Optional은 필요에 따라 기입 여부를 개발사에서 판단하시면 됩니다.
8.1. 메세지 기본 구조¶
OVSE 플랫폼의 기본 메세지 구조는 JSON Format으로 Header, Payload가 구분이 없이 구성되어있습니다.
Example Code :
{
"ts" : 1571273913571, //timestamp
"dev_type": 2,
"dev_id": 3333,
"speed": 60,
"location": {
"lat": 37.510296,
"lon": 127.062512
}
}
메세지의 종류는 Device Type과 송/수신 대상에 따라 세부내용이 달라집니다.
| Device Type | Value |
|---|---|
| OVC-g | device_type = 1 |
| OVC-m | device_type = 2 |
| Sendor | Receiver | Message |
|---|---|---|
| OVC-g | OVSE | OVCPosition
OVCEventReport
|
| OVC-m | OVSE | OVCEventReport |
| OVSE | OVC-g/m | V2N Event Notification |
8.2. OVC-g Message Format¶
8.2.1. OVC-g >> OVSE Message¶
OVC-g가 OVSE로 보내는 메세지는 주기보고 타입과 비주기 보고 타입이 있습니다.
8.2.1.1. 주기보고 메세지 타입 (OVCPosition)¶
주기보고 메세지는 OVSE 규격을 따르는 OVC-g가 주기적으로 차량의 운행 정보를 전달할 때 명세하는 메세지 타입입니다.
| Key | M/O | Type | Description |
|---|---|---|---|
| ts | M | long | 메세지 전달 시간 (msec, epoch) |
| dev_type | M | Integer | OVC-g 단말 타입 (1) |
| dev_id | M | String | Device 고유 단말 식별자 |
| speed | O | Integer | 현재 속도 값 (kph) |
| location | M | 현재 위치 좌표 (WGS84 Coordination)
Child key로 “lat”, “lon” 를 적시
|
Example Data
{
"ts" : 1571273913571,
"dev_type": 1,
"dev_id": 3333,
"speed": 60,
"location": {
"lat": 37.510296,
"lon": 127.062512
}
}
8.2.1.2. 비주기보고 메세지 타입 (OVCEventReport)¶
비주기보고 메세지는 OVSE 규격을 따르는 OVC-g가 내부의 Event Detection Algorithm에 따라 발생된 비주기 Event를 OVSE에 전송하는 메세지 입니다.
비주기 보고 메세지는 SKT가 Guide하는 Device Certification Process를 만족한 경우에 추가 등록 및 사용이 가능합니다.
(*Certified Program 추가 필요)
| Key | M/O | Type | Description |
|---|---|---|---|
| ts | M | long | 메세지 전달 시간 (msec, epoch) |
| dev_type | M | Integer | OVC-g 단말 타입 (1) |
| dev_id | M | String | OVSE에 등록된 단말 식별자 |
| event_type | M | Integer | Event 종류 식별자 |
| event_id | M | String | Unique event 식별자 |
| distanceToEvent | O | Integer | 이벤트 지점까지의 거리 (m)
+ : 전방
- : 후방
|
| location | M | 이벤트 발생 위치 정보 (WGS84 Coordination)
Child key로 “lat”, “lon” 를 적시
|
비주기 이벤트는 그 종류를 event_type으로 구분하고 있습니다. (고객사의 제안에 따라 추가될 수 있습니다)
| event_type | 설명 |
|---|---|
| 201 | 급정거 발생 이벤트 메세지 |
| 202 | 차량사고 발생 이벤트 메세지 |
| 203 | 졸음운전 발생 이벤트 메세지 |
Example Data
{
"ts" : 1571308818766, // timestamp
"dev_type": 1,
"dev_id": 3333,
"event_type": 201,
"event_id": 1021,
"distanceToEvent": 679,
"location": {
"lat": 37.510296,
"lon": 127.062512
}
}
8.2.2. OVSE >> OVC-g Message¶
OVSE에서 OVC-g로 다양한 V2N 이벤트 알림 메세지가 전달됩니다. 티맵, 소방방재청, 지자체 (도로공사 등), 그리고 다른 OVC 등을 통해서 수집된 이벤트에 대한 알림 메세지이며 그 종류 및 내용은 다음과 같습니다.
| Key | M/O | Type | Description |
|---|---|---|---|
| ts | M | long | 메세지 전달 시간 (msec, epoch) |
| event_type | M | Integer | 알림 메세지 타입 |
| event_id | M | String | Unique event 식별자 |
| tunnel | M | Boolean | Tunnel 안의 이벤트인지 아닌지 (급정거는 모두 FALSE) |
| distanceToEvent | M | Integer | 이벤트 지점까지의 거리 (m)
+ : 전방
- : 후방
|
| location | M | 이벤트 발생 위치 정보 (WGS84 Coordination)
Child key로 “lat”, “lon” 를 적시
|
Example Data
{
"ts" : 1571308818766, // timestamp
"event_type: 1286, // 보행자 이벤트 발생 예
"event_id": 12123,
"tunnel": TRUE,
"distanceToEvent": 1400,
"location": {
"lat": 37.510296,
"lon": 127.062512
}
}
각 이벤트 타입별 세부 detail 정보는 다음과 같습니다.
| event_type | 발생 이벤트 메세지 설명 |
|---|---|
| 0 | 전방 급정거 발생 |
| 258 | 전방 차량 정체 |
| 513 | 전방 사고 발생 |
| 534 | 전방 정지차 주의 |
| 1281 | 전방 낙하물 주의 |
| 1286 | 전방 보행자 주의 |
| 1793 | 전방 차량 역주행 주의 |
| 9732 | 후방 경찰차 접근 |
| 9734 | 후방 구급차 접근 |
| 9736 | 후방 소방차 접근 |
8.3. OVC-m Message Format¶
8.3.1. OVC-m >> OVSE Message¶
OVC-m은 OVC-g와 달리 내부에 T맵을 이용하여 도로상의 위치를 파악할 수 있기 때문에, OVSE로 위치 주기보고 메세지를 보낼 필요가 없습니다. 그래서 OVC-m은 비주기 보고 타입만 있으며, 그 형태는 OVC-g와 유사합니다.
8.3.1.1. 비주기보고 메세지 타입 (OVCEventReport)¶
비주기보고 메세지는 OVSE 규격을 따르는 OVC-m이 내부의 Event Detection Algorithm에 따라 발생된 비주기 Event를 OVSE에 전송하는 메세지 입니다. 비주기보고 메세지는 SKT가 Guide하는 Device Certification Process를 만족한 경우에 추가 등록 및 사용이 가능합니다.
(*Certified Program 추가 필요)
| Key | M/O | Type | Description |
|---|---|---|---|
| ts | M | long | 메세지 전달 시간 (msec, epoch) |
| dev_type | M | Integer | OVC-m 단말 타입 (2) |
| dev_id | M | String | OVSE에 등록된 단말 식별자 |
| event_type | M | Integer | Event 종류 식별자 |
| event_id | M | String | Unique event 식별자 |
| distanceToEvent | O | Integer | 이벤트 지점까지의 거리 (m)
+ : 전방
- : 후방
|
| location | M | 이벤트 발생 위치 정보 (WGS84 Coordination)
Child key로 “lat”, “lon” 를 적시
|
|
| meshid | O | Integer | T맵 meshid 정보 |
| linkid | O | Integer | T맵 linkid 정보 |
| roadType | O | Integer | T맵 기준 현 RoadType 정보 |
비주기 이벤트는 그 종류를 event_type으로 구분하고 있습니다. (고객사의 제안에 따라 추가될 수 있습니다)
| event_type | 설명 |
|---|---|
| 201 | 급정거 발생 이벤트 메세지 |
| 202 | 차량사고 발생 이벤트 메세지 |
| 203 | 졸음운전 발생 이벤트 메세지 |
Example Data
{
"ts" : 1571308818766, // timestamp
"dev_type": 2,
"dev_id": 3343,
"event_type": 201,
"event_id": 1021,
"distanceToEvent": 679,
"location": {
"lat": 37.510296,
"lon": 127.062512
},
"meshid": 57150000,
"linkid": 4333,
"roadType": 1
}
8.3.2. OVSE >> OVC-m Message¶
OVSE에서 OVC-m으로 전달되는 V2N 이벤트 메세지는 OVC-g의 것과 유사하며, 전달되는 Interface에서 차이가 있습니다.
| Key | M/O | Type | Description |
|---|---|---|---|
| ts | M | long | 메세지 전달 시간 (msec, epoch) |
| event_type | M | Integer | 알림 메세지 타입 |
| event_id | M | String | Unique event 식별자 |
| tunnel | M | Boolean | Tunnel 안의 이벤트인지 아닌지 (급정거는 모두 FALSE) |
| distanceToEvent | M | Integer | 이벤트 지점까지의 거리 (m)
+ : 전방
- : 후방
|
| location | M | 이벤트 발생 위치 정보 (WGS84 Coordination)
Child key로 “lat”, “lon” 를 적시
|
Example Data
{
"ts" : 1571308818766, // timestamp
"event_type: 1286, // 보행자 이벤트 발생 예
"event_id": 12123,
"tunnel": TRUE,
"distanceToEvent": 1400,
"location": {
"lat": 37.510296,
"lon": 127.062512
}
}
각 이벤트 타입별 세부 detail 정보는 다음과 같습니다.
| event_type | 발생 이벤트 메세지 설명 |
|---|---|
| 0 | 전방 급정거 발생 |
| 258 | 전방 차량 정체 |
| 513 | 전방 사고 발생 |
| 534 | 전방 정지차 주의 |
| 1281 | 전방 낙하물 주의 |
| 1286 | 전방 보행자 주의 |
| 1793 | 전방 차량 역주행 주의 |
| 9732 | 후방 경찰차 접근 |
| 9734 | 후방 구급차 접근 |
| 9736 | 후방 소방차 접근 |