차량 정보 공유 (V2V C-ITS) 개발자 가이드

서비스 개요

V2V(Vehicle-to-Vehicle) 통신은 차량 간 직접 또는 네트워크 기반의 통신을 통해 정보를 주고받음으로써 교통 안전 및 자율 주행 기능을 지원하는 차량 통신 기술입니다.

서비스 특징

실시간 차량 간 정보 공유
사고 예방 및 위험 경고
자율 주행 차량의 협력 주행 지원
저지연 통신 요구 사항
미래형 차량 통신 기술

법적 요구사항

개인정보 보호법 준수
차량 식별자 익명화 필수
국가 C-ITS 규정 준수
보안 인증서 기반의 통신

주요 시나리오

시나리오 1: 사고 감지 및 위험 데이터 전송

엔티티별 API 흐름:

🚗 차량 (TCU):

위험 감지: 에어백, ABS, 비상등 점등 감지를 통한 자동 사고 감지
데이터 전송: 사고 위치 및 상태 정보 전송
상태 업데이트: 비상 서비스 도착 상태 전송
위험 해제: 사고 해제 상태 전송

🏢 콜센터:

사고 수신: 차량 사고 데이터 수신
위험 저장: 사고 정보 저장 및 지오인덱싱(Geo-indexing)
주변 차량 검색: 반경 2km 이내 차량 검색
비상 서비스 조율: 구급차, 경찰, 소방대 자동 출동 요청

시나리오 2: 주변 차량에 위험 경고 전파

엔티티별 API 흐름:

🚗 차량 (TCU):

경고 명령 수신: 서버로부터 위험 경고 명령 수신
경고 표시: 차량 디스플레이에 "전방 사고 발생(500m 앞)" 경고 표시
푸시 알림: 사용자 앱으로 "전방 500m 지점 사고 발생. 주의하십시오." 알림 전송
경고 해제: 위험 해제 명령 수신 시 경고 해제

🏢 콜센터:

대상 차량 선정: 사고 반경 이내의 차량 자동 선정
경고 명령 전송: 위험 경고 명령 전송
위험 해제: 위험 해제 명령 전송

시나리오 3: 비상 서비스 조율 및 상태 업데이트

엔티티별 API 흐름:

🏢 콜센터:

비상 알림 생성: 사고 비상 알림 자동 생성
비상 서비스 출동: 구급차, 경찰, 소방대 자동 출동 지시
비상 알림 전송: 사용자에게 "사고 발생. 비상 서비스가 출동 중입니다." 알림 전송
상태 업데이트: 비상 서비스 현장 도착 시 상태 업데이트

📱 앱 (사용자):

비상 알림 수신: 비상 서비스 출동 알림 수신
상태 업데이트 수신: "비상 서비스가 현장에 도착했습니다." 업데이트 수신

시나리오 4: C-ITS 시스템 모니터링

엔티티별 API 흐름:

🏢 콜센터:

시스템 상태 조회: C-ITS 시스템 상태 조회
사고 이력 조회: 활성 사고 이력 조회
시스템 설정: 시스템 설정 업데이트
실시간 모니터링: 24시간 C-ITS 시스템 상태 모니터링

시나리오 5: 실시간 C-ITS 이벤트 스트림

엔티티별 API 흐름:

📱 앱 (사용자):

SSE 연결: 실시간 C-ITS 이벤트 스트림 연결
실시간 수신: 실시간으로 위험 경고 이벤트 수신
위험 표시: 전방 500m 사고 위험 실시간 표시

🏢 콜센터:

스트림 제공: 실시간 C-ITS 이벤트 스트림 제공
이벤트 전송: 실시간으로 위험 경고 이벤트 전송

시나리오 6: 대형 사고 비상 방송

엔티티별 API 흐름:

🏢 콜센터:

대형 사고 감지: 대규모 사고 자동 감지
비상 방송 시작: 시스템 전역 비상 방송 시작
방송 메시지 전송: "대형 사고 발생 - 해당 지역 주행 자제 요청" 메시지 전송

🚗 차량 (TCU):

비상 방송 수신: 시스템 비상 방송 수신
비상 경고 표시: "🚨 비상 방송: 해당 지역 주행을 자제해 주십시오." 경고 표시

주요 기능

🚗 차량 구현 기능

1. 위험 감지 및 전송

위험 감지: 에어백, ABS, 비상등 자동 감지
사고 데이터 전송: 사고 위치 및 상태 전송
상태 업데이트: 비상 서비스 상태 업데이트
위험 해제: 사고 해제 상태 전송

2. 위험 경고 수신 및 표시

경고 명령 수신: 서버로부터 위험 경고 명령 수신
경고 표시: 차량 디스플레이에 위험 경고 표시
위험 해제: 위험 해제 명령 수신 및 처리
위험 거리 표시: 사고 지점까지의 거리 정보 표시

3. 비상 방송 수신

비상 방송 수신: 시스템 비상 방송 수신
비상 경고 표시: 차량에 비상 방송 내용 표시
지역 정보 표시: 관련 지역 정보 표시

🏢 콜센터 구현 기능

1. 사고 데이터 관리

사고 수신: 차량 사고 데이터 수신
위험 저장: 사고 정보 저장 및 지오인덱싱
주변 차량 검색: 반경 기반 차량 검색
사고 상태 관리: 발생부터 해제까지의 상태 관리

2. 위험 경고 전파 시스템

대상 차량 선정: 사고 반경 이내 차량 자동 선정
경고 명령 전송: 위험 경고 명령 전송
위험 해제: 위험 해제 명령 전송
전파 최적화: 위험 정보 전파 범위 및 시점 최적화

3. 비상 서비스 조율

비상 알림 생성: 사고 비상 알림 자동 생성
비상 서비스 출동: 구급차, 경찰, 소방대 자동 출동 지시
비상 알림 전송: 사용자에게 비상 서비스 상태 알림 전송
상태 추적: 비상 서비스 현장 도착까지의 상태 추적

4. C-ITS 시스템 관리

시스템 상태 조회: C-ITS 시스템 상태 조회
사고 이력 조회: 활성 사고 이력 조회
시스템 설정: 시스템 설정 업데이트
24시간 모니터링: 지속적인 C-ITS 시스템 상태 모니터링

5. 실시간 이벤트 스트림

스트림 제공: 실시간 C-ITS 이벤트 스트림 제공
이벤트 전송: 실시간으로 위험 경고 이벤트 전송
연결 관리: SSE 연결 상태 관리
스트림 최적화: 대량 이벤트 처리 최적화

6. 비상 방송 시스템

대형 사고 감지: 대규모 사고 자동 감지
비상 방송 시작: 시스템 전역 비상 방송 시작
방송 메시지 전송: 모든 차량에 비상 방송 메시지 전송
방송 제어: 방송 시작 및 종료 제어

7. API 서비스 관리

API 응답 처리: C-ITS 관련 API 요청 처리
데이터 제공: 클라이언트에게 C-ITS 데이터 제공
성능 모니터링: API 응답 시간 및 가용성 모니터링
에러 핸들링: API 에러 및 예외 상황 대응

8. 지오인덱싱 및 공간 검색

지오인덱싱: 사고 위치 정보의 공간 인덱싱
반경 검색: 반경 기반의 차량 검색
공간 쿼리 최적화: 대규모 차량 검색 최적화
위험 지역 관리: 위험 지역 설정 및 관리

9. 데이터 분석 및 통계

사고 패턴 분석: 사고 발생 패턴 자동 분석
위험 통계: 위험 상황 발생 통계 자동 생성
서비스 품질 분석: C-ITS 서비스 품질 자동 분석
개선 권장 사항: 서비스 개선 권장 사항 자동 생성

시퀀스 다이어그램

V2V C-ITS 통신 시스템 흐름

V2V C-ITS

API 엔드포인트

헤더, 응답 코드 및 에러 형식은 공통 API 사양을 참조하십시오.

C-ITS 사건 이력 조회

bash

curl -X GET "https://api.ecarus.run/api/v1/information/vehicles/KMHSH81C7LU123456/c-its/history?limit=10" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d"

C-ITS 분석 조회

bash

curl -X GET "https://api.ecarus.run/api/v1/information/vehicles/KMHSH81C7LU123456/c-its/analytics?period=30d" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d"

C-ITS 설정 업데이트

bash

curl -X PUT "https://api.ecarus.run/api/v1/information/vehicles/KMHSH81C7LU123456/c-its/config" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d" \
     -H "Content-Type: application/json" \
     -d '{"alertEnabled": true, "notificationTypes": ["HAZARD", "ACCIDENT"]}'

C-ITS 실시간 이벤트 수신 (SSE)

bash

curl -X GET "https://api.ecarus.run/api/v1/information/vehicles/KMHSH81C7LU123456/c-its/events" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d" \
     -H "Accept: text/event-stream"

데이터 모델

C-ITS 이력 조회 응답

json

{
  "vin": "KMHSH81C7LU123456",
  "userId": "user123",
  "period": "30d",
  "limit": 10,
  "offset": 0,
  "history": [
    {
      "eventId": "event-001",
      "eventType": "EMERGENCY_BRAKE_WARNING",
      "timestamp": "2026-01-13T10:15:23Z",
      "position": {
        "lat": 37.4021,
        "lon": 127.1087
      },
      "severity": "HIGH",
      "vehicleId": "pseudonym-12345",
      "affectedVehicles": 3,
      "message": "급제동이 발생했습니다.",
      "processed": true,
      "actionTaken": "ALERT_DISPLAYED"
    },
    {
      "eventId": "event-002",
      "eventType": "ROAD_HAZARD",
      "timestamp": "2026-01-13T09:45:12Z",
      "position": {
        "lat": 37.4015,
        "lon": 127.1092
      },
      "severity": "MEDIUM",
      "vehicleId": "pseudonym-67890",
      "affectedVehicles": 5,
      "message": "도로 포트홀이 감지되었습니다.",
      "processed": true,
      "actionTaken": "HAZARD_MAPPED"
    }
  ],
  "total": 45,
  "hasMore": true,
  "nextOffset": 10
}

C-ITS 분석 응답

json

{
  "vin": "KMHSH81C7LU123456",
  "userId": "user123",
  "period": "30d",
  "analysis": {
    "communication": {
      "totalMessages": 1250,
      "messagesSent": 620,
      "messagesReceived": 630,
      "averageLatency": 45,
      "successRate": 98.5,
      "peakUsageHours": ["08:00-09:00", "17:00-18:00"]
    },
    "events": {
      "totalEvents": 45,
      "emergencyEvents": 3,
      "hazardEvents": 12,
      "warningEvents": 30,
      "averageResponseTime": 2.3,
      "falsePositiveRate": 2.1
    },
    "network": {
      "directV2VUsage": 65.2,
      "networkAssistedUsage": 34.8,
      "averageSignalStrength": 78.5,
      "connectionUptime": 99.2,
      "handoverEvents": 23
    },
    "safety": {
      "accidentsAvoided": 2,
      "nearMissesReduced": 8,
      "brakeWarningsPrevented": 15,
      "safetyScore": 87.3,
      "improvementTrend": "POSITIVE"
    }
  },
  "insights": [
    {
      "type": "COMMUNICATION_PATTERN",
      "message": "피크 시간대에는 직접 V2V 통신이 최적입니다.",
      "confidence": 0.92,
      "recommendation": "현재 통신 설정 유지"
    },
    {
      "type": "SAFETY_IMPROVEMENT",
      "message": "이번 달 비상 대응 시간이 15% 개선되었습니다.",
      "confidence": 0.88,
      "recommendation": "현재 안전 프로토콜 지속"
    }
  ],
  "generatedAt": "2026-01-13T14:30:00Z"
}

C-ITS 설정 업데이트 응답

json

{
  "vin": "KMHSH81C7LU123456",
  "userId": "user123",
  "status": "UPDATED",
  "timestamp": "2026-01-13T14:35:00Z",
  "message": "C-ITS 설정이 성공적으로 업데이트되었습니다.",
  "updatedConfig": {
    "alerts": {
      "alertEnabled": true,
      "notificationTypes": ["HAZARD", "ACCIDENT", "EMERGENCY_BRAKE"],
      "previousNotificationTypes": ["HAZARD", "ACCIDENT"],
      "severityThreshold": "MEDIUM"
    },
    "communication": {
      "preferredMode": "HYBRID",
      "directV2VPriority": true,
      "networkAssistedFallback": true,
      "maxLatency": 100
    },
    "privacy": {
      "pseudonymRotationInterval": "PT2H",
      "locationSharingEnabled": true,
      "dataRetentionPeriod": "P30D"
    },
    "safety": {
      "automaticEmergencyBrakingAlerts": true,
      "collisionWarningSensitivity": "HIGH",
      "roadHazardDetection": true
    }
  },
  "validation": {
    "isValid": true,
    "warnings": [
      "높은 충돌 경고 민감도는 오탐지를 증가시킬 수 있습니다."
    ],
    "errors": []
  },
  "effectiveDate": "2026-01-13T14:35:00Z",
  "nextReviewDate": "2026-02-13T14:35:00Z"
}

데이터 처리 아키텍처

통신 구조 유형

직접 V2V (Direct V2V): 차량 간 직접 통신 (DSRC/C-V2X)
네트워크 지원 (Network-assisted): 서버 기반 통신 (V2N)
하이브리드 (Hybrid): 두 방식의 결합 구조

데이터 유형

CAM/BSM: 위치 및 주행 정보
DENM: 위험 이벤트 정보
실시간 데이터 전송 요구 사항

핵심 기술 요소

디지털 트윈 (Digital Twin): 차량 위치의 실시간 관리
공간 검색 (Spatial Search): 반경 기반 차량 검색
저지연 (Low Latency): 수십~수백 ms의 지연 시간 요구 사항

보안 정책

V2X PKI 기반 인증
차량 식별자 익명화
국가 C-ITS 보안 체계 준수

보안 및 프라이버시

차량 식별자 보호

가상 식별자(Pseudonym Certificate) 사용
식별자의 주기적 변경
위치 정보의 익명화 처리

통신 보안

V2X PKI 기반 인증
메시지 무결성 보장
국가 보안 체계 준수

프라이버시 보호

개인정보 보호법 준수
차량 식별자 익명화 필수
위치 정보 보호
데이터 보유 정책 준수

예외 처리

통신 관련

연결 실패: 직접 V2V 모드로 전환
응답 지연: 네트워크 지원 모드로 처리
통신 품질 저하: 가변적 메시지 전송 적용

보안 관련

인증 실패: 새로운 가상 식별자 요청
인증서 만료: 자동 갱신 처리
보안 위협: 통신 차단 및 보고

차량 상태 관련

GPS 신호 유실: 마지막 위치 정보 사용
센서 오류: 기본값으로 대체
차량 OFF: V2V 통신 비활성화

테스트 설정

Base URL: https://api.ecarus.run/api/v1/information
인증 토큰: sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d
샘플 VIN: KMHSH81C7LU123456

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

배포 고려사항

개발 우선순위

낮은 우선순위의 개발 항목
인프라 및 차량 지원 여부 고려
단계적 구현 필요

기술적 준비도

2027년 상용화 목표
관련 인프라 구축 필요
차량 통신 모듈 탑재 필요

법규 준수

개인정보 보호법 준수
차량 식별자 익명화 필수
국가 C-ITS 규정 준수
보안 인증서 기반의 통신

차량 호환성

C-V2X 또는 DSRC 통신 모듈 지원
V2X PKI 인증서 저장 공간 확보
실시간 처리가 가능한 컴퓨팅 성능
저지연 통신 인터페이스

차량 정보 공유 (V2V C-ITS) 개발자 가이드 ​

서비스 개요 ​

서비스 특징 ​

법적 요구사항 ​

주요 시나리오 ​

시나리오 1: 사고 감지 및 위험 데이터 전송 ​

시나리오 2: 주변 차량에 위험 경고 전파 ​

시나리오 3: 비상 서비스 조율 및 상태 업데이트 ​

시나리오 4: C-ITS 시스템 모니터링 ​

시나리오 5: 실시간 C-ITS 이벤트 스트림 ​

시나리오 6: 대형 사고 비상 방송 ​

주요 기능 ​

🚗 차량 구현 기능 ​

1. 위험 감지 및 전송 ​

2. 위험 경고 수신 및 표시 ​

3. 비상 방송 수신 ​

🏢 콜센터 구현 기능 ​

1. 사고 데이터 관리 ​

2. 위험 경고 전파 시스템 ​

3. 비상 서비스 조율 ​

4. C-ITS 시스템 관리 ​

5. 실시간 이벤트 스트림 ​

6. 비상 방송 시스템 ​

7. API 서비스 관리 ​

8. 지오인덱싱 및 공간 검색 ​

9. 데이터 분석 및 통계 ​

시퀀스 다이어그램 ​

V2V C-ITS 통신 시스템 흐름 ​

API 엔드포인트 ​

C-ITS 사건 이력 조회 ​

C-ITS 분석 조회 ​

C-ITS 설정 업데이트 ​

C-ITS 실시간 이벤트 수신 (SSE) ​

데이터 모델 ​

C-ITS 이력 조회 응답 ​

C-ITS 분석 응답 ​

C-ITS 설정 업데이트 응답 ​

데이터 처리 아키텍처 ​

통신 구조 유형 ​

데이터 유형 ​

핵심 기술 요소 ​

보안 정책 ​

보안 및 프라이버시 ​

차량 식별자 보호 ​

통신 보안 ​

프라이버시 보호 ​

예외 처리 ​

통신 관련 ​

보안 관련 ​

차량 상태 관련 ​

테스트 설정 ​

배포 고려사항 ​

개발 우선순위 ​

기술적 준비도 ​

법규 준수 ​

차량 호환성 ​

차량 정보 공유 (V2V C-ITS) 개발자 가이드

서비스 개요

서비스 특징

법적 요구사항

주요 시나리오

시나리오 1: 사고 감지 및 위험 데이터 전송

시나리오 2: 주변 차량에 위험 경고 전파

시나리오 3: 비상 서비스 조율 및 상태 업데이트

시나리오 4: C-ITS 시스템 모니터링

시나리오 5: 실시간 C-ITS 이벤트 스트림

시나리오 6: 대형 사고 비상 방송

주요 기능

🚗 차량 구현 기능

1. 위험 감지 및 전송

2. 위험 경고 수신 및 표시

3. 비상 방송 수신

🏢 콜센터 구현 기능

1. 사고 데이터 관리

2. 위험 경고 전파 시스템

3. 비상 서비스 조율

4. C-ITS 시스템 관리

5. 실시간 이벤트 스트림

6. 비상 방송 시스템

7. API 서비스 관리

8. 지오인덱싱 및 공간 검색

9. 데이터 분석 및 통계

시퀀스 다이어그램

V2V C-ITS 통신 시스템 흐름

API 엔드포인트

C-ITS 사건 이력 조회

C-ITS 분석 조회

C-ITS 설정 업데이트

C-ITS 실시간 이벤트 수신 (SSE)

데이터 모델

C-ITS 이력 조회 응답

C-ITS 분석 응답

C-ITS 설정 업데이트 응답

데이터 처리 아키텍처

통신 구조 유형

데이터 유형

핵심 기술 요소

보안 정책

보안 및 프라이버시

차량 식별자 보호

통신 보안

프라이버시 보호

예외 처리

통신 관련

보안 관련

차량 상태 관련

테스트 설정

배포 고려사항

개발 우선순위

기술적 준비도

법규 준수

차량 호환성