kr-vehicle-identifier v1.0.3

korean-vehicle-identifier

An English user manual is being prepared.

• 한국의 차량 번호를 분석하여 차량의 유형과 사용 목적을 식별하는 라이브러리입니다.
• A JavaScript library for analyzing Korean vehicle numbers to identify vehicle type and usage purpose.

설치

npm install kr-vehicle-identifier

사용 방법

const vehicle = require("kr-vehicle-identifier");

console.log(vehicle.vehicleInfo("123가4567"));
//{vehicleType: '승용차', usage: '개인용 / 비사업용'}

OR

import vehicle from "kr-vehicle-identifier";

console.log(vehicle.vehicleInfo("123가4567"));
//{vehicleType: '승용차', usage: '개인용 / 비사업용'}

보통 차량

vehicle.vehicleInfo("123가4567");   //{vehicleType: '승용차', usage: '개인용 / 비사업용'}
vehicle.vehicleInfo("02허1234");    //{vehicleType: '승용차', usage: '대여용'}
vehicle.vehicleInfo("79보1234");    //{vehicleType: '승합차', usage: '개인용 / 비사업용'}
vehicle.vehicleInfo("80배1234");    //{vehicleType: '화물차', usage: '택배용'}

건설 기계

vehicle.vehicleInfo("012가5006");    //{vehicleType: '콘크리트 피니셔', usage: '자가용'}
vehicle.vehicleInfo("026거1234");    //{vehicleType: '도로보수트럭', usage: '자가용'}
vehicle.vehicleInfo("026러5234");    //{vehicleType: '콘크리트믹서트레일러', usage: '자가용'}

특수 목적 차량

vehicle.vehicleInfo("12국 3456");    //{vehicleType: '승용차', usage: '국방부 및 직할부대'}
vehicle.vehicleInfo("외교 012-345"); //{vehicleType: '알 수 없음', usage: '대사관'}
vehicle.vehicleInfo("외빈 108");     //{vehicleType: '알 수 없음', usage: '외빈'}

주의 사항

vehicle.vehicleInfo("");            //{error: 'Invalid license plate format'}
vehicle.vehicleInfo("ANN-0509");    //{error: 'Invalid license plate format'}

• 입력된 차량 번호가 올바른 형식을 따르지 않는 경우, error 필드를 포함한 객체가 반환됩니다.
• 이 API는 한국 차량 번호 형식에 최적화되어 있습니다. 다른 국가의 차량 번호를 분석하는 데 사용할 경우, 정확한 결과를 보장할 수 없습니다.

API

vehicleInfo(licensePlate)

목적: 입력된 차량 번호로부터 차량의 유형과 사용 목적을 분석합니다.

• 매개변수
  • licensePlate (string): 분석할 차량 번호판입니다.
• 반환값
  • 분석된 차량 정보를 객체 형태로 반환합니다. 반환되는 객체에는 다음과 같은 필드가 포함됩니다:
    • vehicleType (string): 차량의 유형입니다. 예를 들어, "승용차", "건설기계", "알 수 없음" 등입니다.
    • usage (string): 차량의 사용 목적입니다. 예를 들어, "관용", "자가용", "영업용" 등입니다.
    • error (string, 선택적): 분석 과정에서 오류가 발생한 경우, 오류 메시지가 포함됩니다.

한국 차량 번호판

한국의 차량 번호판은 특정한 패턴을 따르며, 본 라이브러리는 이러한 패턴을 기반으로 차량 정보를 분석합니다.

차량 번호판 구조

한국의 차량 번호판은 대체로 "숫자-한글-숫자" 형식으로 구성되어 있으며, 간혹 "한글-숫자" 형식으로도 사용됩니다. 이 숫자와 한글 부분은 차량의 유형, 사용 목적 등의 다양한 정보를 담고 있습니다.

• 번호판 앞자리 수
  번호판에서 가장 먼저 나오는 숫자는 차종의 정보를 담고 있습니다.

• 문자
  번호판의 문자는 자동차의 용도를 표현합니다.

• 마지막 네 자리 수
  마지막 네 자리 수는 임의의 일련번호이나, 건설기계인 경우 아래의 표를 따릅니다.

• 건설기계

• 특수건설기계
  특수건설기계(026)인 경우, 번호판 문자로 더 자세한 용도를 알 수 있습니다.

라이센스

이 프로젝트는 MIT 라이센스를 따르고 있습니다.