소개: 차량 만들기

Fleet Engine에서 차량이 작동하는 방식에 관한 일반 정보는 Fleet Engine 필수 섹션의 다음 가이드를 참고하세요.

이 섹션의 문서에서는 Fleet Engine에서 차량을 만들고 관리하는 방법을 설명합니다. Fleet Engine 서버 환경에서 차량을 만들어 실제 운영의 실제 차량을 반영합니다. 또한 Fleet Engine 차량은 차량 할당 및 라우팅에 사용하는 백엔드 시스템에서 사용되는 차량과 일치해야 합니다.

gRPC 또는 REST를 사용하여 차량 리소스를 만드는 데 create 메서드를 사용합니다. 이 가이드의 필드 이름은 편의를 위해 gRPC 표기법을 사용합니다.

주문형 이동

예약된 작업

차량 요청

온디맨드 및 예약 작업 기능 모두에 대해 다음과 같이 요약된 필드가 포함된 요청 메시지를 발행하여 차량을 만들고 업데이트합니다.

  1. 상위 요소: Google Cloud 프로젝트 ID와 연결된 문자열로, 차량 인스턴스의 이름 필드를 채우는 데 사용됩니다.

  2. 차량 ID: 차량의 name 필드를 채우는 데 사용되는 고유 문자열입니다.

  3. 필수 입력란이 있는 차량 인스턴스 이러한 필드는 사용하는 Fleet Engine 기능에 따라 달라집니다.

요청 본문의 정보는 요청의 성격에 따라 다릅니다. 자세한 내용은 각 가이드를 참고하세요.

인증 및 승인 토큰

Fleet Engine에 대한 요청도 올바른 액세스 사용자 인증 정보를 제공해야 합니다. 이 가이드의 예시에는 다음과 같은 가정이 있습니다.

  • gRPC 예시에서는 Java용 승인 라이브러리를 사용한다고 가정합니다.
  • REST 예시에서는 <token>이 발급하는 JSON 웹 토큰인 경우 Bearer <token> 값이 있는 Authorization 필드가 포함되어야 하는 HTTP 요청 헤더를 보여줍니다.

자세한 내용은 Fleet Engine 설정 가이드를 참고하세요.

차량 리소스 필드

차량 리소스에는 다음과 같은 종류의 필드가 있습니다.

  • 출력 전용 필드입니다. 서비스에서 다른 메서드의 출력으로 설정되며 직접 설정할 수 없는 필드입니다. 이 유형의 중요한 필드는 name 필드입니다. Google AIP의 사용자 지정 ID 안내에 따라 Fleet Engine은 차량의 name 필드에 제공된 값을 무시합니다. 이러한 필드에 값을 제공하면 Fleet Engine에서 오류를 반환합니다.
  • 필수 입력란 온디맨드 이동 서비스에서 생성된 차량은 생성 시 특정 필드를 설정해야 합니다. 예약된 작업 서비스에서 생성된 차량에는 필수 차량 리소스 필드가 없습니다.
  • 선택사항 필드 두 서비스 모두 생성 시 또는 그 후에 설정할 수 있는 필드가 있습니다. 이러한 내용은 사용하는 서비스의 해당 참조 가이드에서 확인할 수 있습니다.

차량 이름 (출력 전용)

name 필드는 주문형 이동과 예약된 작업 서비스에서 정확히 동일합니다. Fleet Engine은 차량 생성 시 설정한 두 필드를 기반으로 차량을 만들 때 필드를 정의합니다.

  • 상위: Google Cloud 프로젝트 ID와 연결된 문자열로, providers/{provider} 형식입니다. 여기서 {provider}는 Cloud 프로젝트의 ID입니다. 특정 프로젝트에 대해 생성하는 각 차량은 동일한 상위 경로를 갖습니다.

    여기에서 참조하는 Cloud 프로젝트에는 사용하는 서비스의 Fleet Engine 서비스 계정 역할도 포함되어야 합니다. 이러한 서비스 계정 목록은 서비스 계정을 참고하세요. Fleet Engine은 여러 Google Cloud 프로젝트에서의 액세스를 지원하지 않습니다.

  • 차량 ID. 차량 ID는 전체 차량에서 고유해야 하며 유효한 유니코드 문자열이어야 합니다. 차량의 리소스 ID입니다. 주문형 이동과 예약된 정류장 모두 이를 사용하여 이동 또는 작업을 완료하는 차량과 연결합니다.

Google Cloud 기반 서비스에서 모든 API는 리소스를 문자열로 나타내야 합니다. 자세한 내용은 Fleet Engine의 리소스 이름 지정을 참고하세요.

고유 항목 식별자

리소스 호출에 사용되는 고유한 엔티티 식별자의 형식과 값은 Fleet Engine에 불투명합니다. 식별자에 운전자의 전화번호와 같은 개인 식별 정보 (PII)가 포함되지 않도록 합니다.

차량 재사용

차량이 특정 여정의 모든 정류장을 완료하면 Fleet Engine에서 7일 동안 재사용할 수 있습니다. 즉, 새 차량을 만들지 않고도 다음 영업일에 차량을 재사용할 수 있습니다. 차량을 재사용할 때마다 Fleet Engine에서 차량의 사용 가능 여부를 재설정하며 이때 7일 카운트다운이 새로 시작됩니다.

Fleet Engine에서 차량을 사용할 수 있도록 유지하는 데 권장되는 방법은 일정한 간격으로 위치를 업데이트하는 것입니다. Vehicle 항목의 다른 대부분의 필드를 업데이트해도 새 필드 값이 기존 값과 다른 경우 수명이 연장됩니다.

참고: device_settings과 같은 Vehicle 항목의 일부 필드는 Fleet Engine에서 유지되지 않는 순수한 디버그 정보입니다. 업데이트해도 Vehicle 항목의 수명이 연장되지는 않습니다.

시스템 분석을 개선하려면 매일 동일한 운전자-차량 ID 페어링을 재사용하는 것이 좋습니다. 이전 예약 정류장 또는 주문형 이동에 운전자와 연결된 동일한 차량 ID를 사용하여 이를 실행합니다.

다음 단계