Fleet 추적 개요

JavaScript 차량 추적 라이브러리는 다음과 같은 사용 사례에 적합합니다.

  • 주문형 이동
  • 예약된 작업

이 가이드에서는 두 서비스 모두에 이 라이브러리를 사용하는 방법을 설명합니다.

JavaScript 차량 추적 라이브러리를 사용하면 차량 운영자가 차량의 위치를 거의 실시간으로 시각화할 수 있도록 지원할 수 있습니다. 차량의 경로가 알려진 경우 지도 뷰 구성요소는 예측된 경로를 따라 이동하는 차량의 애니메이션을 만듭니다.

차량 추적 지도 뷰 예시

차량 추적이란 무엇인가요?

차량 추적은 차량 운영자를 위해 설계된 Fleet Engine의 기능입니다. Fleet Engine에서 차량 데이터를 모델링하고 따르는 인터페이스를 제공하고 차량 관리자를 위한 이동 정보의 풍부한 웹 기반 지도 디스플레이를 만드는 데 사용하는 클래스를 제공합니다. 예를 들면 다음과 같습니다.

  • 대중교통 운영자가 여러 차량에서 이동 진행 상황을 추적할 수 있도록 허용합니다.
  • 정기 배송 운영자가 웹 기반 지도에서 차량 배송의 거의 실시간 진행 상황을 확인할 수 있도록 허용합니다.

라이브러리를 웹 앱에 통합하고 Fleet Engine 내에서 적절한 역할 프로필을 설정하여 소비자와 여정 공유를 지원합니다. Fleet Engine의 역할에 관한 자세한 내용은 서비스 계정 역할을 참고하세요.

차량 추적을 사용하는 이유는 무엇인가요?

차량 추적을 차량 운영에 통합하면 거의 실시간 위치 업데이트와 함께 포괄적인 차량 모니터링 환경을 이용할 수 있습니다. 지도에서 차량의 실적을 파악하는 데 도움이 되는 정류장 또는 중간 지점 세부정보를 비롯하여 차량 위치를 하나 또는 모두 확인할 수 있습니다.

차량 추적으로 무엇을 할 수 있나요?

차량 추적 라이브러리의 정보를 사용하여 다음 기능으로 차량 운영에 대한 풍부한 뷰를 만들 수 있습니다.

  • 필요에 맞게 차량 추적 지도 UI 맞춤설정을 맞춤설정합니다.

  • 경로를 따라 이동하는 단일, 여러 대 또는 모든 차량의 현재 위치를 확인하고 위치가 주기적으로 업데이트됩니다.

  • 이동 또는 배송의 도착 예정 시간과 남은 거리를 계산합니다.

  • 완료된 이동 또는 작업 상태를 비롯한 차량 진행 상황을 확인합니다.

구성요소

다음 표에서는 차량 추적에 사용되는 구성요소와 그 기능을 설명합니다.

주문형 이동

구성요소 설명
여정 공유 지도 보기 이동 공유 지도 보기에는 차량의 위치와 이동 경로가 표시됩니다. Fleet Engine이 차량의 경로를 알고 있으면 지도 뷰 구성요소는 차량이 예측된 경로를 따라 이동할 때 애니메이션을 적용합니다.
차량 위치 제공업체

차량 위치 제공업체는 단일 차량의 위치 정보를 표시합니다. 차량 위치, 웨이포인트, 차량에 할당된 경로에 관한 정보가 포함되어 있습니다.

다음은 차량 및 해당 웨이포인트 마커의 공개 상태 규칙입니다.

  • 차량: 차량은 Fleet Engine에서 생성되는 즉시 표시되며 vehicle_stateOnline인 경우 표시됩니다. 즉, 현재 할당된 이동이 없는 경우에도 차량이 표시될 수 있습니다.
  • 경유지 마커: 계획된 차량 경유지가 지도에 출발지, 중간 지점, 목적지 마커로 표시됩니다.
맞춤설정 옵션 차량 위치 정보 제공업체 옵션을 사용하면 다중선 및 마커 맞춤설정을 제공할 수 있습니다. 다중선의 색상과 스타일을 지정하여 경로 및 교통과 같은 차량의 다양한 실제 시나리오를 표시할 수 있습니다. 목적에 따라 마커를 맞춤설정할 수 있습니다. 다중선 및 마커에 클릭 처리를 추가할 수도 있습니다.
차량 이벤트 리스너 이벤트 리스너를 사용하면 운영자가 차량에서 완료한 이동에 관한 정보를 가져올 수 있습니다.
차량 차량 위치 제공업체 차량 위치 제공업체는 여러 배송 차량의 위치 정보를 표시합니다. 차량을 추적할 때는 지리적 경계를 설정하고 차량 ID를 기준으로 필터링할 수도 있습니다.

예약된 작업

구성요소 설명
여정 공유 지도 보기 여정 공유 지도 뷰에는 배송 차량 및 작업의 위치가 표시됩니다. Fleet Engine이 차량의 경로를 알고 있으면 지도 뷰 구성요소는 차량이 예측된 경로를 따라 이동할 때 애니메이션을 적용합니다.
배송 차량 위치 제공업체

배송 차량 위치 제공업체는 단일 배송 차량의 위치 정보를 표시합니다. 여기에는 차량 위치, 정류장, 배송 차량에서 완료한 작업에 관한 정보가 포함됩니다.

다음은 배송 차량, 정류장, 작업의 공개 상태 규칙입니다.

  • 차량: 배송 차량은 Fleet Engine에서 생성되는 즉시 표시되며, 작업과 관계없이 경로 전체에 표시됩니다.
  • 정류장: 계획된 차량 정류장은 지도에 차량 정류장 마커로 표시됩니다. 완료된 작업의 마커는 차량의 계획된 정류장과 다른 스타일로 표시됩니다.
  • Tasks: 할 일 결과의 위치가 할 일 결과 마커와 함께 표시됩니다. SUCCEEDED 결과가 있는 태스크는 성공한 태스크 마커로 표시되고 다른 모든 태스크는 실패한 태스크 마커로 표시됩니다.
맞춤설정 옵션 배송 차량 위치 제공업체 옵션을 사용하면 다중선 및 마커 맞춤설정을 제공할 수 있습니다. 다중선의 색상과 스타일을 지정하여 차량의 활성 경로와 같은 차량의 다양한 실제 시나리오를 표시할 수 있습니다. 배송 차량과 같이 다양한 목적으로 마커를 맞춤설정할 수 있습니다. 다중선 및 마커에 클릭 처리를 추가할 수도 있습니다.
전송 작업 필터 작업 필터를 사용하면 운영자가 지정된 시간 전후에 완료된 작업의 보기를 필터링할 뿐만 아니라 미결 또는 완료된 작업으로 필터링할 수 있습니다.
배송 차량 이벤트 리스너 이벤트 리스너를 사용하면 운영자가 배송 차량이 완료한 이동 구간과 차량에서 제공한 작업 목록에 대한 정보를 가져올 수 있습니다.
배송 차량 위치 제공업체 배송 차량 위치 제공업체는 여러 배송 차량의 위치 정보를 표시합니다. 특정 배송 차량과 위치를 표시하도록 필터링하거나 전체 차량의 차량 위치를 표시할 수 있습니다.

차량 추적 사용 방법

1 JavaScript에서 차량 추적을 설정합니다. 자세한 내용은 JavaScript 차량 추적 라이브러리 설정을 참고하세요.
2 라이브러리를 로드하고 지도를 초기화합니다. 자세한 내용은 라이브러리 로드 및 지도 뷰 초기화를 참고하세요.
3 차량 위치를 제공하고 지도 뷰를 설정합니다. 차량 추적을 시작하려면 올바른 차량 ID로 위치 제공자를 인스턴스화하고 이를 사용하여 지도 뷰를 초기화합니다. 자세한 내용은 차량 위치 제공을 참고하세요.
5 차량 진행 상황을 업데이트하고 이동 경로 오류를 처리합니다. 자세한 내용은 함대 진행률 업데이트오류 처리를 참고하세요.
5 하루가 끝나면 차량 추적을 중지합니다. 자세한 내용은 배송 차량 추적 중지를 참고하세요.

다음 단계