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"
  }
}

[에러 코드]

실패 시 에러 코드에 대한 상세한 설명은 에러 코드를 참조합니다.