차량 정보 서비스 (Vehicle Information Service)

차량 데이터 관리 및 주행 분석을 위한 지능형 정보 솔루션입니다. 실시간 상태 모니터링, 주행 패턴 분석, 예방 정비 기능 등을 통해 OEM은 고객에게 차량 생애 주기 관리 가치를 제공할 수 있습니다.

OEM을 위한 비즈니스 가치

🚗 차량 데이터 플랫폼

통합 데이터 허브: 모든 차량 정보를 중앙에서 통합 관리하는 단일 플랫폼 구축
실시간 인사이트: 주행 중 발생하는 모든 데이터의 실시간 수집 및 분석
데이터 기반 서비스: 차량 정보를 활용한 부가 가치 서비스 창출의 기반 제공

💰 신규 수익 모델

데이터 구독 서비스: 차량 정보 및 주행 데이터 분석 서비스의 구독형 모델 도입
인사이트 보고서: 주행 패턴 분석 기반의 개인화된 서비스 추천 프로그램 운영
파트너십 확장: 보험사, 정비소, 주차 서비스 등과 연계된 B2B 서비스 모델 확대

📱 고객 경험 강화

지능형 분석: 운전 습관 분석을 통한 개인 맞춤형 어드바이스 및 서비스 제공
예방 정비: 소모품 상태 모니터링을 통한 정확한 정비 시점 예측 및 안내
편리한 관리: 차량 생애 주기 데이터를 한곳에서 관리하는 원스톱 경험 제공

서브 모듈

배터리 부족 알림 (Low Battery Alert) - 차량 배터리 모니터링 및 예방 정비
주행 습관 분석 (Driving Habits Analysis) - 운전자 행동 분석 및 점수화 시스템
주행 정보 (Driving Information) - 실시간 주행 데이터 및 이동 정보 관리
월간 운행 리포트 (Monthly Trip Report) - 주행 형태에 대한 종합 분석 보고서
주차 위치 확인 (Parking Location Check) - 주차 위치 추적 및 공유 서비스
원격 TPMS 체크 (Remote TPMS Check) - 타이어 공기압 모니터링 및 알림
소모품 교체 알림 (Consumables Notification) - 소모품 모니터링 및 유지보수 알림
차량 정보 공유 (Vehicle Information Sharing) - 안전한 차량 데이터 공유 및 접근 관리
차량 상태 확인 (Vehicle Status Check) - 실시간 차량 상태 및 주요 부품 모니터링

OpenAPI 사양

대화형 API 탐색기

대화형 API 테스트를 위해 Swagger UI를 사용하십시오.

OEM 구현 고려사항

🔧 기술적 통합

차량 인터페이스 연동: CAN, OBD-II, GPS 데이터의 통합 수집 체계 구축
데이터 분석 엔진: 빅데이터 처리를 통한 주행 패턴 분석 알고리즘 적용
클라우드 스토리지: 방대한 차량 데이터의 안전한 저장 및 빠른 접근성 확보

📊 서비스 운영

확장성: 수천 대의 차량 데이터 동시 처리 및 확장 가능한 아키텍처 지원
신뢰성: 99.9% 이상의 정보 서비스 가동률 보장
글로벌 지원: 다양한 차종 및 지역별 요구 사항에 맞는 데이터 처리 지원

🎯 대상 고객

기본 타겟: 차량 관리 및 데이터 분석에 관심이 있는 개인 고객
확장 타겟: 기업용 차량 관리, 렌터카 및 카셰어링 서비스 업체
B2B 기회: 보험사, 정비소, 주차 서비스 및 데이터 분석 전문 기업

주요 기능

실시간 상태 모니터링: 현재 위치, 연료량, 배터리 등 주요 상태 실시간 확인
주행 데이터 분석: 운행 기록 분석 및 주행 습관 패턴 도출
배터리 관리: 배터리 상태 모니터링 및 수명 예측 정보 제공
운전 습관 분석: 주행 행동 점수화 및 안전 운전 가이드 제공

공통 API 사양

모든 정보 API는 아래의 공통 사양을 따릅니다.

공통 헤더

헤더	값	필수 여부	설명
`Authorization`	`Bearer {access_token}`	필수	인증을 위한 보안 토큰
`Content-Type`	`application/json`	필수	요청 본문 형식
`Accept`	`application/json`	선택	응답 본문 형식

공통 응답 코드

코드	상태	설명
`200`	OK	요청이 성공적으로 처리되었습니다.
`201`	Created	리소스가 성공적으로 생성되었습니다.
`204`	No Content	성공했으나 반환할 본문 내용이 없습니다.
`400`	Bad Request	잘못된 요청 파라미터 또는 로직 에러입니다.
`401`	Unauthorized	인증에 실패했거나 토큰이 만료되었습니다.
`403`	Forbidden	해당 리소스에 접근할 권한이 부족합니다.
`404`	Not Found	요청한 리소스가 존재하지 않습니다.
`500`	Internal Error	예기치 않은 서버 측 에러가 발생했습니다.

에러 응답 형식

json

{
  "errorCode": "ERR_VEHICLE_STATUS_QUERY_FAILED",
  "message": "차량 단말 기기가 응답하지 않습니다.",
  "timestamp": "2026-04-02T17:09:00Z"
}

API 엔드포인트

헤더 및 에러 코드는 공통 API 사양을 참조하십시오.

차량 상태 조회 (Vehicle Status Query)

현재 차량의 상태를 실시간으로 확인하고 모니터링하기 위한 기능입니다.

GET /api/v1/information/vehicles/{vin}/status - 현재 차량 상태 조회
POST /api/v1/information/vehicles/{vin}/status/refresh - 차량 상태 새로고침 요청
GET /api/v1/information/vehicles/{vin}/status/location - 차량 위치 정보 조회
GET /api/v1/information/vehicles/{vin}/status/events - 상태 이벤트 스트림 연결 (SSE)

주행 데이터 분석 (Driving Data Analysis)

차량 주행 기록 분석을 통해 인사이트를 제공합니다.

GET /api/v1/information/vehicles/{vin}/trips - 최근 주행 목록 조회
GET /api/v1/information/vehicles/{vin}/driving-history/list - 주행 이력 목록 전체 조회
GET /api/v1/information/vehicles/{vin}/driving-history/detail-path - 상세 주행 경로 정보 조회
GET /api/v1/information/vehicles/{vin}/driving-history/stats - 주행 통계 데이터 조회
GET /api/v1/information/vehicles/{vin}/driving-history/search - 주행 이력 조건 검색

배터리 관리 (Battery Management)

차량 배터리 상태 모니터링 및 분석 기능입니다.

GET /api/v1/information/vehicles/{vin}/battery/status - 현재 배터리 상태 조회
GET /api/v1/information/vehicles/{vin}/battery/detail - 배터리 상세 데이터 조회
GET /api/v1/information/vehicles/{vin}/battery/history - 배터리 상태 이력 조회
GET /api/v1/information/vehicles/{vin}/battery/analysis - 배터리 분석 데이터 조회
GET /api/v1/information/vehicles/{vin}/battery/prediction - 배터리 잔존 수명 예측 정보 조회

주행 습관 분석 (Driving Habit Analysis)

운전자의 행동 패턴을 분석하고 점수화하여 안전 운전을 유도합니다.

GET /api/v1/information/vehicles/{vin}/driving-habit/score - 현재 주행 점수 조회
GET /api/v1/information/vehicles/{vin}/driving-habit/score/history - 주행 점수 변동 이력 조회
GET /api/v1/information/vehicles/{vin}/driving-habit/analysis - 주행 습관 상세 분석 데이터 조회

월간 운행 리포트 관리 (Monthly Trip Report Management)

주행 데이터의 종합적인 분석을 통해 월간 보고서를 생성하고 공유합니다.

GET /api/v1/information/vehicles/{vin}/driving-behavior-report/latest - 가장 최근 제작된 운전 리포트 조회
GET /api/v1/information/vehicles/{vin}/driving-behavior-report/list - 월별 리포트 목록 전체 조회
POST /api/v1/information/vehicles/{vin}/driving-behavior-report/report_001/share - 리포트 공유 요청

주차 위치 관리 (Parking Location Management)

차량의 주차 위치를 추적하고 관리하는 기능입니다.

GET /api/v1/information/vehicles/{vin}/parking-location/latest - 마지막 주차 위치 정보 조회
GET /api/v1/information/vehicles/{vin}/parking-location/history - 과거 주차 위치 이력 조회
POST /api/v1/information/vehicles/{vin}/parking-location/refresh - 현재 주차 위치 새로고침
POST /api/v1/information/vehicles/{vin}/parking-location/share - 주차 위치 정보 외부 공유

원격 TPMS 관리 (Remote TPMS Management)

타이어 공기압 상태를 원격으로 모니터링하고 관리합니다.

POST /api/v1/information/vehicles/{vin}/tpms/check - 원격 타이어 공기압 체크 요청
GET /api/v1/information/vehicles/{vin}/tpms/latest - 마지막 TPMS 상태 정보 조회
GET /api/v1/information/vehicles/{vin}/tpms/trend - 타이어 공계압 변화 추세 분석
PUT /api/v1/information/vehicles/{vin}/tpms/alerts - 타이어 공기압 알림 임계값 설정

소모품 관리 (Consumable Management)

소모품 상태를 모니터링하고 교체 시기를 예측하여 관리합니다.

GET /api/v1/information/vehicles/{vin}/consumables/status - 현재 소모품 잔여량 및 상태 조회
POST /api/v1/information/vehicles/{vin}/consumables/reset - 소모품 교체 후 상태 초기화
GET /api/v1/information/vehicles/{vin}/consumables/lifecycle - 소모품 생애 주기 통계 데이터 조회
GET /api/v1/information/vehicles/{vin}/consumables/recommendations - 정비 권장 사항 및 서비스 추천 정보 조회

V2V C-ITS 관리 (V2V C-ITS Management)

차량 간 통신(V2V) 및 차세대 지능형 교통 체계(C-ITS) 데이터를 관리합니다.

GET /api/v1/information/vehicles/{vin}/c-its/history - C-ITS 이벤트 이력 조회
GET /api/v1/information/vehicles/{vin}/c-its/analytics - 인프라 통신 데이터 분석 조회
PUT /api/v1/information/vehicles/{vin}/c-its/config - C-ITS 기능 구성 설정 변경
GET /api/v1/information/vehicles/{vin}/c-its/events - 실시간 C-ITS 데이터 스트림 연결 (SSE)

서비스 통합 가치

🔄 데이터 통합 시너지

종합 차량 리포트: 모든 정보 모듈의 데이터를 통합한 차량 생애 주기 분석 보고서 제공
주행 패턴 심층 분석: 위치, 속도, 연료 데이터를 결합한 실질적인 운전 습관 인사이트 도출
예방 정비 최적화: 소모품 상태와 실제 주행 데이터를 연동한 고도화된 정비 시점 예측

🚀 차별화된 경쟁력

통합 데이터 허브: 타사에서 제공하기 어려운 포괄적인 차량 정보 통합 플랫폼 구축
AI 기반 인사이트: 머신러닝 기반의 주행 패턴 분석 및 개인화된 서비스 추천 기능 지원
글로벌 표준 준수: 다양한 차종 및 국가별 데이터 규격에 대응 가능한 표준화된 API 제공

본 API에 대한 전체 사양은 Swagger UI의 OpenAPI 사양을 참조하십시오.

고객 안전

차량 보안

원격 제어

차량 진단

차량 정보

아동 보호

차량 정보 서비스 (Vehicle Information Service)

OEM을 위한 비즈니스 가치

🚗 차량 데이터 플랫폼

💰 신규 수익 모델

📱 고객 경험 강화

서브 모듈

OpenAPI 사양

OEM 구현 고려사항

🔧 기술적 통합

📊 서비스 운영

🎯 대상 고객

주요 기능

공통 API 사양

공통 헤더

공통 응답 코드

에러 응답 형식

API 엔드포인트

차량 상태 조회 (Vehicle Status Query)

주행 데이터 분석 (Driving Data Analysis)

배터리 관리 (Battery Management)

주행 습관 분석 (Driving Habit Analysis)

월간 운행 리포트 관리 (Monthly Trip Report Management)

주차 위치 관리 (Parking Location Management)

원격 TPMS 관리 (Remote TPMS Management)

소모품 관리 (Consumable Management)

V2V C-ITS 관리 (V2V C-ITS Management)

서비스 통합 가치

🔄 데이터 통합 시너지

🚀 차별화된 경쟁력

차량 정보 서비스 (Vehicle Information Service) ​

OEM을 위한 비즈니스 가치 ​

🚗 차량 데이터 플랫폼 ​

💰 신규 수익 모델 ​

📱 고객 경험 강화 ​

서브 모듈 ​

OpenAPI 사양 ​

OEM 구현 고려사항 ​

🔧 기술적 통합 ​

📊 서비스 운영 ​

🎯 대상 고객 ​

주요 기능 ​

공통 API 사양 ​

공통 헤더 ​

공통 응답 코드 ​

에러 응답 형식 ​

API 엔드포인트 ​

차량 상태 조회 (Vehicle Status Query) ​

주행 데이터 분석 (Driving Data Analysis) ​

배터리 관리 (Battery Management) ​

주행 습관 분석 (Driving Habit Analysis) ​

월간 운행 리포트 관리 (Monthly Trip Report Management) ​

주차 위치 관리 (Parking Location Management) ​

원격 TPMS 관리 (Remote TPMS Management) ​

소모품 관리 (Consumable Management) ​

V2V C-ITS 관리 (V2V C-ITS Management) ​

서비스 통합 가치 ​

🔄 데이터 통합 시너지 ​

🚀 차별화된 경쟁력 ​

차량 정보 서비스 (Vehicle Information Service)

OEM을 위한 비즈니스 가치

🚗 차량 데이터 플랫폼

💰 신규 수익 모델

📱 고객 경험 강화

서브 모듈

OpenAPI 사양

OEM 구현 고려사항

🔧 기술적 통합

📊 서비스 운영

🎯 대상 고객

주요 기능

공통 API 사양

공통 헤더

공통 응답 코드

에러 응답 형식

API 엔드포인트

차량 상태 조회 (Vehicle Status Query)

주행 데이터 분석 (Driving Data Analysis)

배터리 관리 (Battery Management)

주행 습관 분석 (Driving Habit Analysis)

월간 운행 리포트 관리 (Monthly Trip Report Management)

주차 위치 관리 (Parking Location Management)

원격 TPMS 관리 (Remote TPMS Management)

소모품 관리 (Consumable Management)

V2V C-ITS 관리 (V2V C-ITS Management)

서비스 통합 가치

🔄 데이터 통합 시너지

🚀 차별화된 경쟁력