Fleet Engine에서의 차량 작동 방식에 대한 일반적인 정보는 다음 가이드를 참조하세요.
이 섹션의 문서에서는 차량을 만들고 관리하는 방법을 설명합니다. 사용할 수 있습니다 Fleet Engine 서버 환경에서 차량을 만들어 미러링할 수 있습니다. Fleet Engine 차량은 백엔드 시스템에서 사용되는 차량과 일치해야 하며 사용할 수 있습니다.
gRPC 또는 REST를 사용하는 create 메서드를 사용하여 차량 리소스를 만듭니다. 이 가이드의 필드 이름에서는 편의상 gRPC 표기법을 사용합니다.
주문형 경로
CreateVehicleRequest(gRPC)providers.vehicle.create(REST)Vehicle리소스 (REST, gRPC)
예약된 작업
CreateDeliveryVehicleRequest(gRPC)providers.deliveryVehicles.create(REST)DeliveryVehicle(REST, gRPC)
차량 요청
주문형 및 예약 작업 기능의 경우 차량을 요청할 수 있으며, 다음과 같이 요약됩니다.
- 상위 요소: Google Cloud 프로젝트 ID와 연결된 문자열로, 사용되는 차량 인스턴스의 이름 필드를 채웁니다.
차량 ID:
name을 채우는 데 사용되는 고유 문자열입니다. 필드입니다.필수 필드가 있는 차량 인스턴스 이러한 필드는 사용하는 Fleet Engine 기능입니다.
요청 본문의 정보는 요청의 특성에 따라 다릅니다. 자세한 내용은 해당 가이드를 참조하세요.
인증 및 승인 토큰
Fleet Engine에 대한 요청에서는 올바른 액세스 사용자 인증 정보도 제공해야 합니다. 이 가이드의 예에서는 다음과 같이 가정합니다.
- gRPC 예에서는 자바용 승인 라이브러리를 사용한다고 가정합니다.
- REST 예시는
값이
Bearer <token>인Authorization필드, 여기서<token>는 발행하는 JSON 웹 토큰
자세한 내용은 Fleet Engine 설정 가이드를 참조하세요.
차량 리소스 필드
차량 리소스에는 다음과 같은 종류의 필드가 있습니다.
- 출력 전용 필드. 서비스에서
다른 메서드로 전달되고 직접 설정할 수 없습니다. 이 기술의 중요한 분야는
유형은
name필드입니다. Fleet Engine은 사용자 지정의 경우 Google AIP의 안내에 따라 차량의name필드 ID를 참조하세요. 이 필드에 값을 제공하면 Fleet Engine은 오류가 반환됩니다. - 필수 입력란. 주문형 이동 서비스에서 생성된 차량에는 특정 필드를 설정할 수 있습니다 예약된 작업 서비스에 필수 차량 리소스 필드가 없습니다.
- 선택적 필드. 두 서비스 모두 생성 시 설정할 수 있는 필드가 있습니다. 변경할 수 있습니다 이 내용은 사용할 수 있습니다
차량 이름 (출력 전용)
name 필드는 주문형 이동 및 예약된 작업의 경우 정확히 동일합니다.
제공합니다 Fleet Engine은 차량을 만들 때 다음을 기준으로 필드를 정의합니다.
차량 생성 시 설정한 두 개의 필드:
상위 요소:
providers/{provider}형식. 여기서{provider}는 클라우드 ID입니다. 살펴보겠습니다 특정 프로젝트를 위해 만드는 각 차량은 상위 경로.여기에서 참조하는 Cloud 프로젝트에는 Fleet Engine도 포함되어야 합니다. 서비스 계정 역할을 지정할 수도 있습니다 다음에 대한 서비스 계정을 참조하세요. 해당 서비스 계정의 목록이 표시됩니다 Fleet Engine은 다음에서의 액세스를 지원하지 않습니다. 여러 개의 Google Cloud 프로젝트가 있는 경우에 적합합니다
차량 ID: 차량에 있는 모든 차량에 대해 고유해야 합니다. Fleet를 사용하고 유효한 유니코드 문자열이어야 합니다. 리소스 ID입니다. 있습니다. 주문형 이동과 예정된 정류장 모두 이를 사용하여 작업을 완료하는 차량과의 작업을 의미합니다.
Google Cloud 기반 서비스에서 모든 API는 리소스를 문자열로 나타내야 합니다. 자세한 내용은 Fleet Engine의 리소스 이름 지정을 참고하세요.
고유 항목 식별자
리소스 호출에 사용되는 고유 항목 식별자의 형식과 값은 다음과 같습니다. Fleet Engine에 불투명합니다. 식별자에 개인 식별 정보 (PII)에 대한 정보를 수집합니다.
차량 재사용
차량이 특정 여정의 모든 정류장을 완료한 후에는 사용 가능한 상태로 유지됩니다. 7일 동안 Fleet Engine에서 재사용할 수 있습니다. 즉, 새 계정을 만들 필요가 없습니다. 사용자가 차량을 재사용하면 Fleet Engine이 가용성을 재설정합니다. 7일 카운트다운이 새로 시작됩니다.
Fleet Engine에서 차량을 계속 사용할 수 있도록 하기 위해 권장되는 방법은
주기적으로 위치를 업데이트합니다.
Vehicle 새 필드 값이
기존 데이터 세트와는
다릅니다
참고: device_settings와 같은 Vehicle 항목의 일부 필드는 순전히 디버그입니다.
영구 스토리지에 저장됩니다 이를 업데이트해도
Vehicle 항목의 수명을 연장합니다.
시스템 분석을 개선하려면 동일한 운전자 차량 ID를 재사용하는 것이 가장 좋습니다. 페어링합니다. 이렇게 하려면 운전자에게 전달될 수 있습니다.