Overview
Vehicle Data API는 차량의 데이터를 조회하는 오픈 API입니다. 차량 소유주로부터 차량 데이터 공유 동의를 획득한 현대/기아/제네시스 차량에 대하여 차량 상태 정보와 기초 데이터를 제공합니다. 차량 상태 정보에는 충전 상태, 파워트레인 상태, 차량 위치, 차량 운행 상태, 차량 센서 기반 현재 상태, 공조 상태 등이 포함되고, 차량 기초 데이터에는 파워트레인 기초 데이터, 속도 관련 기초 데이터, 차량 운행 관련 기초 데이터, 차량 센서 기반 기초 데이터가 포함됩니다. 차종 모델별 제공 데이터는 API Compatibility를 참조합니다.
Vehicle Data API 목록
| API | Endpoint URL | Description |
|---|---|---|
| Get Battery Charging Status | https://api.pleos.ai/v1/vehicles/{vin}/batteries | 배터리 플러그인 연결 여부, 충전 상태(충전/방전), 잔량, 남은 충전 시간 등 현재 충전 상태를 조회합니다. |
| Get Powertrain Status | https://api.pleos.ai/v1/vehicles/{vin}/powertrains | 엔진, 전기 모터, 배터리 등 파워트레인의 현재 상태를 조회합니다. |
| Get Location Info | https://api.pleos.ai/v1/vehicles/{vin}/locations | 차량의 위치를 나타내는 위도 및 경도 좌표, 고도, 방향, 속도를 조회합니다. |
| Get Vehicle Operation Status | https://api.pleos.ai/v1/vehicles/{vin}/driving | 시동 상태, 누적 주행 거리, 주차 상태 등 개인의 차량 운행 상태를 조회합니다. |
| Get Vehicle Status | https://api.pleos.ai/v1/vehicles/{vin}/status | 도어 및 트렁크 열림 상태, 타이어 공기압, 경고 등, 공조 시스템 등 차량 센서 기반 현재 상태를 조회합니다. |
| Get Freezer Status | https://api.pleos.ai/v1/vehicles/{vin}/freezer | 냉동고의 현재 작동 상태와 내부 온도를 조회합니다. |
| Get Powertrain Data | https://api.pleos.ai/v1/vehicles/{vin}/powertrains/data | 배터리 팩 전압과 엔진 정보(RPM, 오일 온도, 누적 운행 시간) 등 파워트레인의 기초 데이터를 조회합니다. |
| Get Speed Data | https://api.pleos.ai/v1/vehicles/{vin}/speed | 차량의 속도 관련 기초 데이터를 조회합니다. |
| Get Vehicle Operation Data | https://api.pleos.ai/v1/vehicles/{vin}/driving/data | 시동 상태, 누적 주행 거리, 주차 상태 등 개인의 차량 운행 관련 기초 데이터를 조회합니다. |
| Get Vehicle Data | https://api.pleos.ai/v1/vehicles/{vin}/status/data | 도어 열림 상태, 연료 부족 경고등, 타이어 공기압 등 차량 센서 기반 기초 데이터를 조회합니다. |
사용 가능 지역
주의
Vehicle Data API는 현재(2025.9월) 유럽 지역에서만 사용 가능합니다. 다른 지역 서비스는 준비 중입니다.