소개: 차량 만들기

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

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

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

주문형 이동

예약된 작업

차량 요청

주문형 및 예약된 작업 기능 모두에서 필드가 포함된 요청 메시지를 실행하여 차량을 만들고 업데이트합니다. 요청 메시지는 다음과 같이 요약됩니다.

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

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

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

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

인증 및 승인 토큰

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

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

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

차량 리소스 필드

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

  • 출력 전용 필드 서비스에서 다른 메서드의 출력으로 설정하고 직접 설정할 수 없는 필드입니다. 이 유형의 중요한 필드는 name 필드입니다. Fleet Engine은 사용자 지정 ID에 관한 Google AIP의 안내에 따라 차량의 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)가 포함되어 있지 않아야 합니다.

차량 재사용

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

Fleet Engine에서 차량을 계속 사용할 수 있도록 하려면 정기적으로 위치를 업데이트하는 것이 좋습니다. 새 필드 값이 기존 값과 다른 경우 Vehicle 항목의 다른 대부분의 필드를 업데이트해도 전체 기간이 연장됩니다.

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

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

다음 단계