Get Vehicle Operation Data
Description
시동 상태, 누적 주행 거리, 주차 상태 등 개인의 차량 운행 관련 기초 데이터를 조회합니다.
Endpoint
GET https://api.pleos.ai/v1/vehicles/{vin}/driving/data
Request
curl
curl -X GET "https://api.pleos.ai/v1/vehicles/{vin}/driving/data?startDate=20250825&endDate=20250901&zoneId=UTC" \
-H "Authorization: Bearer <your_access_token>" \
-H "Brand: hyundai"
Header Params
| 파라미터 | 타입 | 설명 | 필수 여부 |
|---|---|---|---|
| Authorization | string | 액세스 토큰 | Required |
| Brand | string | 차량 브랜드(hyundai/kia/genesis) | Required |
Path Params
| 파라미터 | 타입 | 설명 | 필수 여부 |
|---|---|---|---|
| vin | string | 차량 식별 번호(Vehicle Identification Number) | Required |
Query Params
| 파라미터 | 타입 | 설명 | 필수 여부 | 기본값 |
|---|---|---|---|---|
| startDate | string | yyyyMMdd | Required | 없음 |
| endDate | string | yyyyMMdd (시작일로부터 7일간만 조회 가능) | Required | 없음 |
| zoneId | string | Timezone Id | Optional | UTC |
Response
성공
200
{
"data": {
"trips": [
{
"triggerStartTime": "2025-09-01T10:00:00.000Z",
"tripLength": 10000,
"ignition": {
"status": [
"on",
"on",
"on",
"on",
"on",
"on",
"on",
"on",
"on",
"on"
]
},
"odometer": {
"value": [
50.2,
50.2,
50.2,
50.2,
50.2,
50.2,
50.2,
50.2,
50.2,
50.2
]
},
"acceleration": {
"longitudinal": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
},
"angularVelocity": {
"yaw": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
},
"isla": {
"optionUsm": [
"off",
"off",
"off",
"off",
"off",
"off",
"off",
"off",
"off",
"off"
],
"optionUsm2": [
"off",
"off",
"off",
"off",
"off",
"off",
"off",
"off",
"off",
"off"
]
},
"seatbelt": {
"assistance": [
"unbelted",
"unbelted",
"unbelted",
"unbelted",
"unbelted",
"unbelted",
"unbelted",
"unbelted",
"unbelted",
"unbelted"
],
"driver": [
"belted",
"belted",
"belted",
"belted",
"belted",
"belted",
"belted",
"belted",
"belted",
"belted"
]
},
"steeringWheel": {
"angle": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"rotationSpeed": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
},
"transmission": {
"gear": [
"p",
"p",
"p",
"p",
"p",
"p",
"p",
"p",
"p",
"p"
]
}
}
]
},
"meta": {
"code": 200,
"message": "Success",
"success": "true",
"timestamp": "2025-09-01T11:00:00Z",
"requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
}
}
data 필드 | 타입 | 설명 |
|---|---|---|
| trips | array of object | 트립 데이터 |
| └──── triggerStartTime | string | 엔진 시동 시작 시간 yyyy-MM-dd'T'HH:mm:ss.SSS'Z' |
| └──── tripLength | long | 차량 주행 시간 (단위: ms) |
| └──── ignition | object | 엔진 시동 정보 |
| └─────── status | array of string | 엔진 시동 상태 (on, off) |
| └──── odometer | object | 차량의 주행거리 정보 |
| └─────── value | array of number | 차량의 주행거리 (단위: km, 범위: 0~1677721.4) |
| └──── acceleration | object | 차량의 종방향 가속도 정보 |
| └─────── longitudinal | array of number | 차량의 종방향 가속도 (단위: g, 범위: -4.177~4.177) |
| └──── angularVelocity | object | 각속도 정보 |
| └─────── yaw | array of number | 차량이 수직 축을 기준으로 회전하는 속도 (단위: º/s, 범위: -40.95~40.95) |
| └──── isla | object | 운전자가 설정한 지능형 속도 제한 보조 (ISLA) 옵션 정보 |
| └─────── optionUsm | array of string | 운전자가 설정한 지능형 속도 제한 보조 (ISLA) 옵션의 사용자 설정 메뉴 신호 (none, off, warning, assist, invalid) - off: 끄기 - warning: 속도 제한 경고 - assist : 속도 제한 보조 |
| └─────── optionUsm2 | array of string | 운전자가 설정한 지능형 속도 제한 보조 (ISLA) 옵션의 사용자 설정 메뉴 신호 2 (none, off, information, warning, assist, invalid) - off: 끄기 - information: 속도 제한 알림 - warning: 속도 제한 경고 - assist : 속도 제한 보조 |
| └──── seatbelt | object | 안전벨트 정보 |
| └─────── assistance | array of string | 조수석의 안전벨트의 상태 (belted, unbelted) |
| └─────── driver | array of string | 운전석의 안전벨트의 상태 (belted, unbelted) |
| └──── steeringWheel | object | 스티어링 휠 정보 |
| └─────── angle | array of number | 스티어링 휠의 각도 (단위: º, 범위: -3276.8~3276.7) |
| └─────── rotationSpeed | array of number | 스티어링 휠의 회전 속도 (단위: º/s, 범위: 0~1016) |
| └──── transmission | object | 차량의 기어 정보 |
| └─────── gear | array of string | 사용자가 설정한 차량의 기어 상태 - p: 주차 - r: 후진 - n: 중립 - d: 주행 |
실패
4002
{
"error": {
"code": "4002",
"message": "Invalid request parameters",
"details": [],
"timestamp": "2025-09-01T12:00:00Z",
"requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
}
}
[에러 코드]
실패 시 에러 코드에 대한 상세한 설명은 에러 코드를 참조합니다.