본문으로 건너뛰기

Fleet REST API Overview

개요​

Fleet REST API는 사용자가 쉽게 Fleet을 다룰 수 있도록 돕습니다. 차량과 단말의 기본 정보부터 실시간 데이터, 차량 제어, 운전자, 차량 정비, 이상 상태 등의 요소들을 사용자가 원하는 플랫폼에 원하는 방식으로 자유롭게 연동할 수 있습니다.

Pre-requisite​

Fleet REST API 사용을 위해서는 Getting started의 REST API 시작하기 섹션을 참고하여 사전 준비를 해주세요.

Vehicle​

차량을 등록하고 관리하는 기능을 제공합니다. 차량에 관제 단말(Telematics)이 장착된 경우 차량의 실시간 데이터를 조회할 수 있습니다. 관제 단말이 여러 대인 경우, 주 관제 단말(Main telematics device)의 데이터가 차량의 데이터로 간주됩니다.

Device​

단말을 등록하고 관리하는 기능을 제공합니다. 단말은 관제 단말(Telematics)과 관제 단말이 아닌 것(Dashcam 등)으로 분류됩니다.

Vehicle Device Matching​

차량에 단말을 장착하거나 탈착할 수 있는 기능을 제공합니다.

Vehicle과 Device의 관계​

한 대의 차량은 n개의 단말을 장착할 수 있습니다.

한 대의 차량에 여러 대의 관제 단말이 설치될 수 있으나, 하나의 단말만 주 관제 단말로 삼을 수 있습니다. 주 관제 단말이 수신하는 데이터가 곧 차량의 데이터로 여겨지며, 주 관제 단말은 사용자의 필요에 따라 다른 관제 단말로 변경될 수 있습니다.

Device model​

Fleet API에서 지원하는 단말의 종류를 조회합니다. 단말을 등록하기 위해서는 Device model의 정보가 필요하며, 지원하는 Device model은 다음과 같습니다.

(단말없이 차량이 직접 데이터를 생산하여 전달하는 경우, 차량 자체를 단말로 등록하여 사용합니다.)

Device model nameDescription등록해야 하는 DeviceSourceId 정보
Hyundai현대 차량차량의 VIN
Kia기아 차량차량의 VIN
Genesis제네시스 차량차량의 VIN